skill

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

تستخدم هذه المهارة عندما يرغب المستخدم في "نشر وكيل" (publish an agent)، أو "نشر وكيل ADK الخاص بي" (publish my ADK agent)، أو "تسجيل وكيل مع Gemini" (register an agent with Gemini)، أو "النشر إلى Gemini" (publish to Gemini) (المعروف سابقا ب Gemini Enterprise)، أو يحتاج إلى إرشادات حول الأمر agents-cli publish gemini. تستخدم أيضا عندما يرغب المستخدم في "إدارة الوكلاء في سجل الوكلاء" (manage agents in Agent Registry)، أو "سرد/تحديث/حذف الوكلاء المسجلين" (list/update/delete registered agents)، أو "تسجيل خادم MCP" (register an MCP server). تغطي هذه المهارة أوضاع تسجيل ADK مقابل A2A، والاستخدام البرمجي والتفاعلي، ومرجع العلامات، والكشف التلقائي من بيانات النشر الوصفية...

google582,908+ تثبيتموثوق

نبذة

# تسجيل Gemini

> **المتطلبات:** وكيل منشر. بالنسبة ل Agent Runtime في منصة Gemini، يمكن `deployment_metadata.json` (الذي تم إنشاؤه بواسطة `agents-cli deploy`) الكشف التلقائي. بالنسبة ل Cloud Run أو GKE، قم بتوفير URL لبطاقة الوكيل والأعلام مباشرة.

## المتطلبات المسبقة

1. **يجب أن يكون الوكيل منشرا** — يجب أن يكون الوكيل قيد التشغيل وقابلا للوصول 2. **يجب أن يكون تطبيق Gemini موجودا** — أنشئ واحدا في Google Cloud console قبل التسجيل 3. **`deployment_metadata.json`** (Agent Runtime فقط) — يتم إنشاؤه تلقائيا بواسطة `agents-cli deploy`؛ يحتوي على معرف Agent Runtime، هدف النشر، علامة A2A، ودليل الوكيل 4. **وكيل قائم على النص** — الوكلاء المباشرون/الصوتيون (bidi) **غير مدعومين** بواسطة تطبيق Gemini، الذي لا يحتوي على نقل `/run_live`. قم بتسجيل وكيل قائم على النص بدلا من ذلك.

## الأذونات المطلوبة ل A2A على Cloud Run

- **`roles/run.servicesInvoker`** ممنوحة لحساب خدمة Discovery Engine (`service-<PROJECT_NUMBER>@gcp-sa-discoveryengine.iam.gserviceaccount.com`) على خدمة Cloud Run.

---

## أوضاع التسجيل

### تسجيل A2A

كل وكيل مهيكل يخدم بروتوكول Agent-to-Agent. A2A هو نوع التسجيل الافتراضي — والوحيد — على **Cloud Run** و **GKE** (لا يوجد محرك استدلال للاستدعاء بشكل أصلي). كما يعمل على **Agent Runtime** عبر `--registration-type a2a`. بالنسبة لوكيل ADK هناك، تحذر CLI منه، لأن تطبيق Gemini يمكنه استدعاء Agent Runtime بشكل أصلي عبر `:streamQuery` — يفضل تسجيل ADK في هذه الحالة. بالنسبة لوكيل مبني على إطار عمل آخر، لا يوجد تطبيق ADK للاستدعاء بشكل أصلي، لذا فإن A2A هو الوضع الصحيح على كل هدف، والتحذير متوقع. قم بتمرير URL لبطاقة الوكيل ويقوم الأمر بجلب البطاقة وتسجيلها؛ يتم تعيين الاسم المعروض والوصف افتراضيا إلى `name`/`description` الخاص بالبطاقة.

```bash # A2A on Cloud Run / GKE. The card path depends on the project's language: # Python -> /a2a/{app_name}/.well-known/agent-card.json # Go -> /.well-known/agent-card.json agents-cli publish gemini \ --agent-card-url https://my-service-abc123.us-east1.run.app/a2a/app/.well-known/agent-card.json \ --gemini-app-id projects/123456/locations/global/collections/default_collection/engines/my-app ```

قم بتمرير `--display-name` / `--description` لتجاوز الإعدادات الافتراضية للبطاقة. على Agent Runtime، يتم إنشاء URL للبطاقة تلقائيا من `deployment_metadata.json` إذا حذفت `--agent-card-url`.

### تسجيل ADK (افتراضي على Agent Runtime)

> **مشاريع ADK فقط.** يجب نشر الوكيل في Agent Runtime كتطبيق ADK، حيث أن التسجيل يستدعيه عبر `:streamQuery`. يتم تسجيل وكيل على إطار عمل آخر عبر A2A، لذا قم بنشره على Cloud Run أو GKE وانشره من هناك.

هذا هو **التسجيل الافتراضي والموصى به لوكلاء ADK على Agent Runtime**: يستدعي تطبيق Gemini الوكيل بشكل أصلي عبر `:streamQuery` على مورد محرك الاستدلال الخاص به، مع المصادقة الشاملة. تحت الغطاء، يقوم `:streamQuery` بالإرسال إلى طريقة `streaming_agent_run_with_events` الخاصة ب `AdkApp` — عند تصحيح استدعاء ADK، ابحث في سجلات `reasoning_engine_stderr` الخاصة بوقت التشغيل عن اسم هذه الطريقة لتتبع الفشل. إنه أيضا المسار الذي يجب استخدامه عندما يحتاج الوكيل إلى تفويض OAuth (`--authorization-id`). يتم تسجيل الوكيل مباشرة عبر اسم مورد محرك الاستدلال الخاص به؛ لا يلزم وجود URL لبطاقة الوكيل.

```bash agents-cli publish gemini \ --registration-type adk \ --agent-runtime-id projects/123456/locations/us-east1/reasoningEngines/789 \ --gemini-app-id projects/123456/locations/global/collections/default_collection/engines/my-app \ --display-name "My Agent" \ --description "Handles customer queries" \ --tool-description "Answers questions about products" ```

---

## الوضع البرمجي (CI/CD)

القيادة غير تفاعلية بشكل افتراضي — قم بتمرير جميع القيم المطلوبة عبر الأعلام أو متغيرات البيئة. هذا يجعلها آمنة لخطوط أنابيب CI/CD.

### عبر الأعلام

```bash agents-cli publish gemini \ --agent-runtime-id "$AGENT_RUNTIME_ID" \ --gemini-app-id "$GEMINI_APP_ID" \ --display-name "Production Agent" \ --registration-type adk ```

### عبر متغيرات البيئة

معظم الأعلام لها بديل لمتغير البيئة (لا يوجد ل `--metadata-file` و `--interactive` و `--list`):

```bash export AGENT_RUNTIME_ID="projects/123456/locations/us-east1/reasoningEngines/789" export GEMINI_APP_ID="projects/123456/locations/global/collections/default_collection/engines/my-app" export GEMINI_DISPLAY_NAME="Production Agent" export GEMINI_DESCRIPTION="Handles customer queries"

agents-cli publish gemini ```

---

## الوضع التفاعلي (`--interactive`)

قم بتمرير `--interactive` (أو `-i`) ليتم إرشادك خلال أي قيم مفقودة باستخدام مطالبات تفاعلية. سيسرد الأمر تطبيقات Gemini المتاحة، ويعرض الكشف التلقائي عن معرف Agent Runtime من البيانات الوصفية، ويطالب بالاسم المعروض والوصف.

```bash agents-cli publish gemini --interactive ```

---

## مرجع الأعلام الكامل

| العلم | متغير البيئة | الوصف | |------|---------|-------------| | `--agent-runtime-id` | `AGENT_RUNTIME_ID` |

التثبيت

شغل هذا الأمر

npx skills add google/agents-cli

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

ثبت باستخدام `npx skills add google/agents-cli`، أو استنسخ المستودع وانسخ مجلد `skills/google-agents-cli-publish` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة نشر وكلاء Google عبر CLI؟

تستخدم هذه المهارة عندما يرغب المستخدم في "نشر وكيل" (publish an agent)، أو "نشر وكيل ADK الخاص بي" (publish my ADK agent)، أو "تسجيل وكيل مع Gemini" (register an agent with Gemini)، أو "النشر إلى Gemini" (publish to Gemini) (المعروف سابقا ب Gemini Enterprise)، أو يحتاج إلى إرشادات حول الأمر agents-cli publish gemini. تستخدم أيضا عندما يرغب المستخدم في "إدارة الوكلاء في سجل الوكلاء" (manage agents in Agent Registry)…

كيف أثبت نشر وكلاء 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+

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

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

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