google-agents-cli-workflow
بناء وكلاء Google ADK بسير عمل موجَّه
يتضمن بناء وكلاء ADK خطوات متعددة — الإنشاء الأولي، والتقييم، والنشر، والمراقبة. توفر هذه المهارة سير عمل منظماً حتى تتمكن من تطوير الوكلاء بشكل صحيح باستخدام مجموعة أدوات agents-cli من Google دون تفويت خطوات حرجة.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "google-agents-cli-workflow". أريد بناء وكيل دعم عملاء يمكنه البحث عن حالة الطلب وإنشاء التذاكر.
النتيجة المتوقعة:
قبل إنشاء الهيكل الأولي، أحتاج إلى توضيح بعض المتطلبات: ما هي واجهات برمجة التطبيقات الخارجية التي يتصل بها البحث عن الطلبات؟ هل يجب أن يتذكر الوكيل سياق المحادثة عبر الجلسات؟ هل هذا نموذج أولي أم نشر إنتاجي؟ بمجرد الإجابة، سأكتب المواصفة في .agents-cli-spec.md وأنتقل إلى المرحلة 1 (دراسة النماذج المرجعية).
استخدام "google-agents-cli-workflow". شغّل agents-cli eval على وكيلي.
النتيجة المتوقعة:
بدء سير عمل التقييم. أولاً، تفعيل مهارة التقييم للحصول على إرشادات مخطط مجموعة البيانات والمقاييس. ثم تشغيل agents-cli eval generate لإنتاج الآثار، يليه agents-cli eval grade لتسجيل الدرجات مقابل eval_config.yaml. ستظهر النتائج مقاييس لكل حالة وتجمعات الفشل.
التدقيق الأمني
آمنThis skill is pure markdown documentation from Google's official google/agents-cli repository. It contains no executable code — only workflow guidelines, CLI command references, and best practices for ADK agent development. All 229 static findings are false positives: backticks are markdown inline-code formatting (not shell execution), URLs point to official Google documentation, and .env/API-key references are educational discussions about configuration management.
مشكلات منخفضة المخاطر (3)
عوامل الخطر
⚙️ الأوامر الخارجية (17)
🌐 الوصول إلى الشبكة (6)
📁 الوصول إلى نظام الملفات (4)
🔑 متغيرات البيئة (4)
درجة الجودة
ماذا يمكنك بناءه
الإنشاء الأولي لمشروع وكيل ADK جديد
ابدأ مشروع وكيل Google ADK جديد بهيكل المشروع الصحيح، وإعداد CI/CD، وقوالب التقييم الجاهزة من البداية.
نشر وكيل تم تقييمه إلى الإنتاج
انقل وكيلاً من الاختبار المحلي عبر عتبات التقييم إلى النشر على Agent Runtime أو Cloud Run أو GKE مع إعداد CI/CD مناسب.
تصحيح سلوك الوكيل وتحسينه تكرارياً
استخدم خطوات التصحيح المنهجية، وفحص أحداث JSON المفصّلة، وحلقة التقييم-الإصلاح لتحديد مشكلات سلوك الوكيل وإصلاحها.
جرّب هذه الموجهات
أريد بناء وكيل جديد باستخدام ADK من Google. يجب أن يساعد الوكيل المستخدمين في [وصف الغرض]. ساعدني في إنشاء الهيكل الأولي للمشروع باستخدام agents-cli وامشِ معي عبر أسئلة المتطلبات.
بنيت وكيلاً في [المسار]. شغّل agents-cli eval للتحقق من سلوكه. ابدأ بـ 1-2 حالة عينة وكرر حتى استيفاء عتبات الجودة.
نجح الوكيل في التقييم. انشره على Cloud Run باستخدام agents-cli deploy. أعدّ CI/CD مع GitHub Actions واستخدم Cloud SQL لتخزين الجلسات.
يُظهر تشغيل التقييم [وصف الفشل]. اتبع عملية التصحيح المنهجية: أعد الإنتاج، وحدد الموقع، وأصلح شيئاً واحداً، وتحقق، وأضف حالة تقييم وقائية.
أفضل الممارسات
- أكمل دائماً المرحلة 0 (الفهم) واحصل على موافقة صريحة من المستخدم على .agents-cli-spec.md قبل إنشاء الهيكل الأولي أو البرمجة
- استخدم agents-cli eval للتحقق من سلوك الوكيل — لا تكتب اختبارات pytest تتحقق من محتوى مخرجات LLM
- لا تغير إعدادات النموذج أبداً ما لم يطلب المستخدم ذلك صراحةً — حافظ على جميع قيم الإعدادات الحالية أثناء التعديلات
تجنب
- تخطي مرحلة إنشاء الهيكل الأولي لإعداد المشروع يدوياً — ستفوتك قوالب التقييم الجاهزة، وإعداد CI/CD، واتفاقيات المشروع
- كتابة اختبارات pytest تبحث عن كلمات مفتاحية في استجابات LLM — هذه الاختبارات غير مستقرة لأن مخرجات LLM غير حتمية
- تغيير متغيرات متعددة في وقت واحد أثناء التصحيح — لن تعرف أي تغيير أصلح أو كسر المشكلة