ADK-Rust v2: من إطار عمل الوكيل إلى بيئة تشغيل الإنتاج.
قصة كيف أصبحت الأدوات وسير العمل والحالة والوسائط في الوقت الفعلي ووكلاء البرمجة والبروتوكولات المفتوحة وعناصر التحكم التشغيلية نظامًا واحدًا قابلاً للتركيب من Rust.
في مارس، نشرنا قصة ADK-Rust v0.5. جعل هذا الإصدار الإطار قادرًا على المزيد: الاسترجاع، تنفيذ التعليمات البرمجية، موفري نماذج إضافيين، رسوم بيانية دائمة، جلسات مشفرة، و CLI يمكنه إنشاء مشروع بدء مفيد.
السؤال التالي كان أصعب. هل يمكن لتلك القدرات أن تصبح نظام إنتاج واحدًا يمكن للمطور تركيبه ومراقبته وتأمينه ونشره وإبقائه قيد التشغيل؟ الرحلة إلى v2 هي الإجابة. لقد غيرت ADK-Rust من مجموعة أدوات وكيل متنامية إلى بيئة تشغيل Rust للمنتجات التي تتحدث وكلاؤها، وتستخدم الأدوات، وتنسق العمل، وتنشئ القطع الأثرية، وتتعاون عبر البروتوكولات المفتوحة.
اقرأ الفصل السابق: ADK-Rust v0.5الطريق إلى v2
ستة أشهر من تحويل ميزات الوكيل إلى نظام.
حل كل إصدار جزءًا مختلفًا من مشكلة الإنتاج. معًا، غيروا ما يمكن للمطورين بناءه بشكل معقول حول بيئة تشغيل Rust واحدة.
تعلم الإطار أنواعًا أكثر من العمل
RAG، تنفيذ التعليمات البرمجية، تحسينات الموفر، الرسوم البيانية الدائمة، الجلسات المشفرة، و cargo-adk وسعت ما يمكن لوكيل Rust واحد القيام به.
تجاوز الوكلاء حدود النظام الحقيقية
وصل A2A إلى تدفقات المهام عن بعد الكاملة. منح AWP مواقع الويب واجهة وكيل. اكتسبت خوادم MCP دورات حياة مُدارة، بينما أصبحت الذاكرة والحالة المشتركة أكثر أمانًا للمنتجات الأكبر.
أصبح التركيب تجربة للمطورين
قللت مستويات الميزات من سطح التبعية الافتراضي. وصل ACP، وتكيفت المخططات مع كل مزود نموذج، وجعلت القوالب والإضافات الهندسة المعمارية خيارًا بدلاً من مجرد تمرين نسخ.
أصبح الأساس مستقرًا
وصلت تسعة وثلاثون حزمة إلى المستوى المستقر مع التزامات تحديد الإصدار الدلالي، وبوابات توثيق أقوى، وأعمال أمنية، وتقييم، وبيئات تشغيل مُدارة، وAPIs لنشر المؤسسات.
أصبحت بيئة التشغيل العمود الفقري للمنتج
انضم CodingAgent وCodeAct إلى عائلة الوكلاء. تنتقل الآن استدعاءات الأدوات، والتقدم، والنتائج، والإلغاء، والوسائط في الوقت الفعلي، وذاكرة الرسم البياني المعرفي، والبروتوكولات المفتوحة عبر عقود بيئة تشغيل صريحة.
نقطة التحول
الوكيل الإنتاجي هو أكثر بكثير من مجرد استدعاء نموذج.
تركزت أمثلة الوكلاء المبكرة بشكل طبيعي على مطالبة، ونموذج، واستجابة. كشفت المنتجات الحقيقية بسرعة عن بقية العمل: تحديد من يمكنه استدعاء أداة، والحفاظ على الحالة، وإظهار التقدم، والاستئناف بعد الموافقة، ونقل ملف تم إنشاؤه، وتتبع الفشل، والتحدث إلى الخدمات التي تخص فريقًا آخر.
يعالج v2 هذه المسؤوليات كاهتمامات إطار عمل بعقود Rust. يبقى النموذج مهمًا، لكنه يعمل داخل استدعاء مع أدوات، وجلسات، وأحداث، واستدعاءات عكسية، وحدود، وسياسة تشغيل. يمكنك استبدال النموذج دون إعادة تصميم المنتج حوله.
هذا هو التحول المعماري وراء الإصدار الرئيسي: يلتقي سلوك الوكيل والبنية التحتية للمنتج الآن في نفس بيئة التشغيل، مع بقائهما منفصلين بما يكفي للتركيب والاختبار.
هندسة v2 المعمارية
تتبع قطعة واحدة من العمل عبر المنتج بأكمله.
يمكن أن يصل الطلب عبر واجهة بشرية أو بروتوكول وكيل. يمنحه Runner السياق، ويستدعي شكل الوكيل الصحيح، ويبث الأحداث المكتوبة بينما تدعم الأدوات والحالة وعناصر التحكم التشغيلية العمل.
الأشخاص والأنظمة
أسطح المنتج
عقد تنفيذ واحد
Runner وتدفق الأحداث المكتوبة
اختر شكل العمل
الوكلاء القابلون للتركيب
امنح الوكلاء وصولاً مفيدًا
الأدوات والمعرفة والحالة
حافظ على قابلية فهم الإنتاج
ضوابط التشغيل
داخل العملية
تتشارك الوكلاء والأدوات والجلسات واستدعاءات رد الفعل والأحداث والإلغاء في Rust من السمات والأنواع.
عبر الحدود
MCP، A2A، ACP، AWP، HTTP، ووسائل النقل في الوقت الفعلي تربط الأنظمة بمالكين مختلفين.
مرئي للمنتج
يمكن لنفس تدفق الأحداث تشغيل CLI، ويب UI، عميل API، عارض تتبع، أو وكيل عن بعد.
شاهد كيف يعمل
مسار التنفيذ هو واجهة للمنتج.
يحتاج الوكيل المفيد إلى إظهار أكثر من جملته النهائية. v2 يمنح كل خطوة ذات معنى مكانًا في تدفق الأحداث، حتى يتمكن المطورون من بناء واجهات حول العمل فور حدوثه.
طلب
يبدأ شخص أو خدمة أو وكيل العمل.
اتخاذ قرار
يختار وكيل أو سير عمل الإجراء الهادف التالي.
تنفيذ
تقوم أداة أو متخصص أو نموذج أو نظام بعيد بتنفيذ الخطوة.
تدفق
تحمل الأحداث المكتوبة استدعاءات، تقدمًا، نتائج، وتغييرات في الحالة.
متابعة
يستجيب وقت التشغيل، يتوقف مؤقتًا للإدخال، يعيد المحاولة، أو يستأنف لاحقًا.
تخيل وكيل برمجة يقوم بتشغيل مجموعة اختبار. يتلقى UI استدعاء الأداة، ومخرجات stdout و stderr سطرًا بسطر، والنتيجة المكتوبة، وأي تغييرات في الحالة أو القطع الأثرية، والقرار التالي للوكيل عبر تدفق واحد مترابط. إذا كانت المهمة تتطلب موافقة أو توقف العمل، توفر الجلسة ونقطة التحقق مكانًا واضحًا للمتابعة.
ماذا يمنح v2 المطور
إطار عمل واحد لدورة حياة الوكيل.
يمكنك البدء بوكيل محادثة واحد وإضافة الهيكل فقط حسب حاجة المنتج. تبقى نفس العقود الأساسية سارية مع نمو النظام.
يمكن للوكلاء العمل بطرق مختلفة
استخدم وكيل LLM للتفكير المرن، وكلاء سير العمل الحتميين للتسلسلات المعروفة، الرسوم البيانية للعمل المتفرع والدائم، وكلاء الوقت الفعلي للصوت والفيديو، CodingAgent لعمل المستودعات، أو CodeAct عندما يجب أن يعبر النموذج عن إجراء متعدد الخطوات كرمز قابل للتنفيذ.
التقدم جزء من الـ API
استدعاءات الأدوات ونتائجها هي أحداث مُحددة النوع. يمكن للأدوات طويلة الأمد أن تُصدر التقدم في نفس تدفق استجابة الوكيل، مع ربط معرفات الاستدعاء بالطلب، والمخرجات المباشرة، والنتيجة النهائية. يمكن لـ UI عرض العمل دون الحاجة إلى تحليل السجلات.
الحالة يمكن أن تستمر بعد دور نموذج واحد
تحافظ الجلسات على المحادثة، وتحتفظ المخرجات بالملفات المُنشأة، وتستأنف نقاط فحص الرسم البياني سير العمل، وتمنح ذاكرة الرسم البياني المعرفي الدلالي أو ثنائي الزمن الوكلاء سياقًا يظل مفيدًا عبر الجلسات اللاحقة.
البروتوكولات المفتوحة لها مهام واضحة
MCP يربط الأدوات والموارد، A2A يربط الوكلاء المنتشرين بشكل مستقل، ACP يربط عملاء وخوادم وكلاء البرمجة، وAWP يمنح موقع الويب واجهة منظمة للوكلاء جنبًا إلى جنب مع واجهته البشرية.
الاستقلالية لها حدود تشغيلية
تسمح عمليات رد الاتصال الخاصة بالترخيص، والأدوات المحددة النطاق، والحواجز الوقائية، والموافقات، وسياسات بيئة الاختبار المعزولة، والإلغاء، والقياس عن بعد، والتقييم، وأدلة التدقيق للفريق بتحديد ما يمكن للوكيل فعله وفحص ما حدث بعد ذلك.
أنت تقوم بتجميع المنتج الذي تحتاجه
الطبقة الدنيا تحافظ على حجم الوكيل الأول صغيرًا. يضيف المستوى القياسي حزمة الإنتاج الشائعة؛ وتضيف المؤسسة الوقت الفعلي، والمتصفح، وRAG، والمدفوعات، وAWP؛ ويضيف المستوى الكامل أثقل إمكانيات الصوت والتنفيذ. تظل الميزات الفردية متاحة عندما يكون الإعداد المسبق واسعًا جدًا.
تجربة البدء
اختر شكل عمل، ثم اجعله خاصًا بك.
يمكن لـ v2 CLI بناء شكل التنفيذ وإضافة الإمكانيات المحيطة. لا يزال المشروع المُنشأ يبدو مثل Rust الذي ستكتبه وتراجعه بنفسك.
إنشاء وتحقق
cargo install cargo-adk
cargo adk new support-agent \
--template tools \
--addon sessions \
--addon telemetry \
--addon guardrails
cd support-agent
cargo adk build
cargo runتكوين الوكيل
let agent = LlmAgentBuilder::new("support")
.description("Resolves customer issues")
.instruction("Use the reviewed tools and cite evidence.")
.model(Arc::new(model))
.tool(Arc::new(LookUpOrder))
.before_tool(approval_gate)
.build()?;
Launcher::new(Arc::new(agent))
.run()
.await?;تغطي اثنا عشر قالبًا معماريات البدء الشائعة. تسعة إضافات تُركب إمكانيات مثل الجلسات، والقياس عن بعد، وMCP، والمصادقة، وأدوات المتصفح، والحواجز الوقائية. خمسة أنماط مؤسسية توفر أشكال نشر أكبر. cargo adk build يتحقق من المشروع المُنشأ قبل النشر.
تم التحقق منه مقابل مصدر v2
التفاصيل وراء القصة.
الفصل التالي يبدأ بوكيل حقيقي
ابنِ سير العمل الأول. حافظ على مسار الإنتاج مفتوحًا.
ابدأ بطلب واحد، واستدعاء أداة مرئي واحد، وجلسة واحدة تفهمها. يمنح ADK-Rust v2 هذا الوكيل الصغير مسارًا مباشرًا إلى سير العمل، والذاكرة، والبروتوكولات المفتوحة، والواجهات في الوقت الفعلي، والأمان، والنشر عندما يكون المنتج جاهزًا لذلك.