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، والاستخدام البرمجي والتفاعلي، ومرجع العلامات، والكشف التلقائي من بيانات النشر الوصفية...
نبذة
# تسجيل 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يعمل مع
خطوات التثبيت
ثبت باستخدام `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 مجانية؟
نعم، يمكنك استخدامها مجانا.
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
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى