skill

نشر وكلاء Google عبر CLI

تستخدم هذه المهارة عندما يرغب المستخدم في "نشر وكيل"، "نشر وكيل ADK الخاص بي"، "إعداد CI/CD"، "تكوين الأسرار"، "استكشاف أخطاء النشر وإصلاحها"، أو يحتاج إلى إرشادات حول Agent Runtime، أو Cloud Run، أو أهداف نشر GKE، أو ربط وكيل ببوابة الوكلاء (Agent Gateway). تغطي سير عمل النشر، وحسابات الخدمة، والتراجع، والبنية التحتية للإنتاج. تنطبق على أي وكلاء إطار عمل ينشرها agents-cli (ADK، LangChain، ...). جزء من مجموعة مهارات agents-cli. لا تستخدم لرمز API الخاص بالوكيل...

google583,101+ تثبيتموثوق

نبذة

# دليل النشر

> **يتطلب:** `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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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 مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التطوير والبرمجة.

كل بدائل نشر وكلاء Google عبر CLI ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات (params)، البث (streaming)، استخدام الأدوات، MCP، الوكلاء (agents)، التخزين الم…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تطوير مدفوع بالاختبار
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبار…1,046,962+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء
استجوب المستخدم بلا هوادة حول خطة أو قرار أو فكرة. استخدم هذا عندما يرغب المستخدم في اختبار مدى متانة تفكيره، أو يستخدم أي عبارات تحفيزية مثل "استجوبن…1,041,607+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
مراجعة الكود
راجع التغييرات منذ نقطة ثابتة (commit، فرع، وسم، أو merge-base) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات…840,484+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.746,030+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
الذكاء الاصطناعي من Azure
بناء تطبيقات Azure AI Search وSpeech وOpenAI وDocument Intelligence واستكشاف أخطائها وإصلاحها. متى: AI Search، البحث المتجه، البحث الهجين، البحث الدلا…727,368+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التطوير والبرمجة