عن المشروع

Agent Development Kit (ADK) هو إطار عمل مفتوح المصدر بلغة بايثون يتبع منهجية الكود أولاً لبناء وتقييم ونشر وكلاء الذكاء الاصطناعي. وهو يطبق مبادئ تطوير البرمجيات على إنشاء الوكلاء، بهدف تبسيط بناء ونشر وتنسيق سير عمل الوكلاء من المهام البسيطة إلى الأنظمة المعقدة. وهو محسّن لـ Gemini لكنه موصوف بأنه محايد للنموذج ومحايد للنشر ومتوافق مع أطر عمل أخرى. القدرات الرئيسية الموصوفة في README: - Workflow Runtime: محرك تنفيذ قائم على الرسوم البيانية لتكوين تدفقات تنفيذ حتمية، مع التوجيه، والتوزيع/التجميع، والحلقات، وإعادة المحاولة، وإدارة الحالة، والعقد الديناميكية، والمشاركة البشرية في الحلقة، وسير العمل المتداخل. - Task API: تفويض منظم بين الوكلاء مع وضع المهام متعدد الأدوار، والإخراج المتحكم فيه بدور واحد، وأنماط التفويض المختلطة، ووكلاء المهام كعقد سير العمل. - أنظمة متعددة الوكلاء معيارية: تكوين وكلاء متخصصين في تسلسلات هرمية. - نظام الأدوات: أدوات جاهزة، ودوال مخصصة، ومواصفات OpenAPI، وأدوات MCP، والتكامل مع الأدوات الموجودة. - التطوير بالكود أولاً: تعريف منطق الوكيل والأدوات والتنسيق في بايثون. - Agent Config: بناء الوكلاء بدون كود. - تأكيد الأدوات (HITL): حماية تنفيذ الأدوات بتأكيد صريح وإدخال مخصص. - النشر: الحاويات والنشر على Cloud Run أو Vertex AI Agent Engine. يتم التثبيت عبر pip (google-adk)، ويتطلب Python 3.10+. تتوفر تكاملات اختيارية عبر إضافة extensions. يمكن تثبيت نسخة تطويرية من الفرع main. يذكر README وتيرة إصدار تقارب كل أسبوعين. تعرض أمثلة البدء السريع فئة Agent مع الاسم والنموذج والتعليمات، وفئة Workflow تربط الوكلاء عبر الحواف. يتم دعم التشغيل المحلي عبر واجهة سطر أوامر تفاعلية (adk run) وواجهة ويب (adk web). يتم توفير واجهة تطوير مرفقة لاختبار الوكلاء وتقييمها وتصحيحها وعرضها. يمكن تشغيل التقييم بأمر adk eval مقابل evalset وملف تكوين. تشمل أوامر النشر adk deploy docker وadk deploy cloud_run، مع متغيرات بيئة قابلة للتكوين عبر سطر الأوامر أو ملف .env. يتم ربط الوثائق والأدلة والعينات القابلة للتشغيل، إلى جانب إرشادات المساهمة ومستودع مجتمعي للأدوات والتكاملات ونصوص النشر المساهَم بها من المجتمع. يوفر المشروع أيضًا ملفات llms.txt وllms-full.txt المقصودة كسياق للتطوير بمساعدة LLM. توجد منافذ لـ ADK للغات Java وKotlin وGo وTypeScript. المشروع مرخص بموجب Apache 2.0.