skill
نشر وكلاء Google عبر CLI
تستخدم هذه المهارة عندما يرغب المستخدم في "نشر وكيل"، "نشر وكيل ADK الخاص بي"، "إعداد CI/CD"، "تكوين الأسرار"، "استكشاف أخطاء النشر وإصلاحها"، أو يحتاج إلى إرشادات حول Agent Runtime، أو Cloud Run، أو أهداف نشر GKE، أو ربط وكيل ببوابة الوكلاء (Agent Gateway). تغطي سير عمل النشر، وحسابات الخدمة، والتراجع، والبنية التحتية للإنتاج. تنطبق على أي وكلاء إطار عمل ينشرها agents-cli (ADK، LangChain، ...). جزء من مجموعة مهارات agents-cli. لا تستخدم لرمز API الخاص بالوكيل...
نبذة
# دليل النشر
> **يتطلب:** `agents-cli` (`uv tool install google-agents-cli`) — [ثبت uv](https://docs.astral.sh/uv/getting-started/installation/index.md) أولا إذا لزم الأمر.
> يفضل استخدام أوامر `agents-cli` في جميع أنحاء هذا الدليل — فهي تغلف Terraform و Docker والنشر في مسار عمل مجرب. إذا لم يتم إعداد مشروعك بعد، فراجع `/google-agents-cli-scaffold` لإضافة دعم النشر أولا.
### ملفات مرجعية
للحصول على تفاصيل أعمق، استشر هذه الملفات المرجعية في `references/`:
- **`cloud-run.md`** — إعدادات التحجيم الافتراضية، Dockerfile، أنواع الجلسات، الشبكات - **`agent-runtime.md`** — النشر القائم على الحاويات، تطبيق FastAPI الموحد، تمرير `/api`، مورد Terraform، بيانات تعريف النشر، اختلافات CI/CD - **`gke.md`** — مجموعة GKE Autopilot، بيانات Kubernetes، هوية حمل العمل (Workload Identity)، أنواع الجلسات، الشبكات - **`terraform-patterns.md`** — البنية التحتية المخصصة، IAM، إدارة الحالة، استيراد الموارد - **`batch-inference.md`** — مشغل دالة BigQuery عن بعد؛ ل Pub/Sub / Eventarc على ADK راجع `/google-agents-cli-adk-code` - **`cicd-pipeline.md`** — إعداد مسار CI/CD كامل، علامات `infra cicd`، مقارنة أدوات التشغيل، مصادقة WIF، مراحل المسار - **`testing-deployed-agents.md`** — تعليمات الاختبار لكل هدف نشر، أمثلة curl، اختبارات التحميل - **`cmek.md`** — مفاتيح التشفير المدارة من قبل العميل (CMEK) على Agent Runtime في منصة Gemini: منح المفاتيح، `deploy --key` للتطوير، تعديلات Terraform للمراحل التجريبية/الإنتاج
> **قابلية المراقبة (Observability):** راجع مهارة `/google-agents-cli-observability` ل Cloud Trace، وتسجيل الاستجابة الفورية، وتحليلات BigQuery، وعمليات التكامل مع الجهات الخارجية.
---
## مصفوفة قرار هدف النشر
اختر هدف النشر الصحيح بناء على متطلباتك:
| المعيار | Agent Runtime | Cloud Run | GKE | |----------|-------------|-----------|-----| | **التحجيم** | تحجيم تلقائي مدار (قابل للتكوين للحد الأدنى/الأقصى، التزامن) | قابل للتكوين بالكامل (الحد الأدنى/الأقصى للمثيلات، التزامن، تخصيص وحدة المعالجة المركزية) | تحجيم Kubernetes كامل (HPA، VPA، توفير العقد تلقائيا) | | **الشبكات** | يدعم VPC-SC و PSC-I (اتصال VPC خاص عبر مرفقات الشبكة) | دعم VPC كامل، خروج VPC مباشر، IAP، قواعد الدخول | شبكات Kubernetes كاملة | | **حالة الجلسة** | الجلسات في منصة Gemini (يقوم ADK بتوصيل `VertexAiSessionService` تلقائيا) | في الذاكرة (للتطوير)، Cloud SQL، أو واجهة خلفية مدارة للجلسات | في الذاكرة (للتطوير)، Cloud SQL، أو واجهة خلفية مدارة للجلسات | | **معالجة الدفعات/الأحداث** | نقاط نهاية المشغل يمكن الوصول إليها عبر تمرير `/api` الخاص ب Agent Runtime | نقاط نهاية مشغل أصلية (Pub/Sub، Eventarc)؛ ADK: راجع `/google-agents-cli-adk-code` | مخصص (Kubernetes Jobs، Pub/Sub) | | **نموذج التكلفة** | ساعات vCPU + ساعات الذاكرة (لا يتم الفوترة عند الخمول) | لكل ثانية مثيل + تكاليف الحد الأدنى للمثيلات | تكاليف تجمع العقد (دائم التشغيل أو موفر تلقائيا) | | **تعقيد الإعداد** | أقل (مدار، مصمم خصيصا للوكلاء) | متوسط (Dockerfile، Terraform، الشبكات) | أعلى (يتطلب خبرة في Kubernetes) | | **الأفضل ل** | بنية تحتية مدارة، عمليات تشغيل قليلة | بنية تحتية مخصصة، تحكم كامل في الشبكات | تحكم كامل في Kubernetes |
**اسأل المستخدم** عن هدف النشر الذي يناسب احتياجاته. كل منها خيار إنتاجي صالح مع مقايضات مختلفة.
جميع الأهداف الثلاثة قائمة على الحاويات، لذا فإن أي لغة تعمل.
> **تعيين أسماء المنتجات:** قد يقول المستخدمون "Agent Engine" أو "Vertex AI Agent Engine" أو "Agent Runtime"؛ جميعها تعني Agent Runtime. استخدم `--deployment-target agent_runtime`.
> **الوكلاء المحيطون / المجدولون / المعتمدون على الأحداث (مشاريع ADK):** تسجل `trigger_sources` الخاصة ب ADK نقاط نهاية `/apps/{app}/trigger/*` على نفس تطبيق FastAPI ل **جميع** الأهداف. على **Cloud Run** / **GKE**، هذه مسارات HTTP عامة توجه إليها اشتراك دفع Pub/Sub أو مشغل Eventarc؛ على **Agent Runtime**، يمكن الوصول إلى نفس المسارات من خلال تمرير `/api` الخاص بها (على سبيل المثال `.../reasoningEngines/v1/{resource}/api/apps/{app}/trigger/pubsub`). يظل Cloud Run هو الهدف الأبسط لمصادر المشغل غير المصادق عليها. راجع `/google-agents-cli-adk-code` (`references/adk-python.md`، القسم "12. Event-Driven / Ambient Agents") لنمط `trigger_sources`.
> **وكلاء OAuth / موافقة المستخدم:** استخدم **Agent Runtime**، المسجل لدى Gemini، للوكلاء الذين يحتاجون إلى موافقة المستخدم على OAuth 2.0 (على سبيل المثال، الوصول إلى Google Drive أو Calendar أو واجهات برمجة التطبيقات الأخرى ذات النطاق الخاص بالمستخدم). لا يدعم Cloud Run حاليا تدفقات OAuth المدارة. للحصول على مثال ADK عملي، ابحث عن موافقة مستخدم OAuth في فهرس الموضوعات في `/google-agents-cli-adk-code` → `references/recipes.md`.
> **الوكلاء المباشرون والصوتيون:** مرر **`--timeout 3600`** على Cloud Run حتى تستمر الجلسة لفترة أطول من الافتراضي 300 ثانية، و **`--min-instances 1`** على Cloud Run أو Agent Runtime حتى لا يسمع المتصل الأول بعد الخمول بداية باردة. يقوم GKE بتحديد حجم pods في Terraform. أشكال URL وقدرات الجلسة: `/google-agents-cli-adk-code` (`references/adk-python-live.md`).
---
## النشر إلى بيئة التطوير
### سير عمل النشر
**تتبع المهام:** يتضمن النشر خطوات متعددة متسلسلة (إعداد البنية التحتية، CI/CD ج
التثبيت
شغل هذا الأمر
npx skills add google/agents-cliيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add google/agents-cli`، أو استنسخ المستودع وانسخ مجلد `skills/google-agents-cli-deploy` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة نشر وكلاء Google عبر CLI؟
تستخدم هذه المهارة عندما يرغب المستخدم في "نشر وكيل"، "نشر وكيل ADK الخاص بي"، "إعداد CI/CD"، "تكوين الأسرار"، "استكشاف أخطاء النشر وإصلاحها"، أو يحتاج إلى إرشادات حول Agent Runtime، أو Cloud Run، أو أهداف نشر GKE، أو ربط وكيل ببوابة الوكلاء (Agent Gateway). تغطي سير عمل النشر، وحسابات الخدمة، والتراجع، والبنية التحتية للإنتاج. تنطبق على أي وكلاء إطار عمل ينشرها agents-cli (ADK، LangChain، ...). جزء من مجموعة مهارات…
كيف أثبت نشر وكلاء Google عبر CLI؟
شغل هذا الأمر في الطرفية:
npx skills add google/agents-cliمع أي أدوات ذكاء اصطناعي تعمل نشر وكلاء Google عبر CLI؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور نشر وكلاء Google عبر CLI؟
طورها google.
هل نشر وكلاء Google عبر CLI مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى