بنية الوكلاءالمهارات العامة

A2A Agent Orchestration

تنسيق متعدد الوكلاء — اكتشاف القدرات، إرسال المهام، بث النتائج، وإدارة دورات حياة الوكلاء البعيدين عبر بروتوكول A2A.

ما تعلمه هذه المهارة

دليل قابل لإعادة الاستخدام لنوع معين من العمل.

يخبر خادم MCP الوكيل بالإجراءات المتاحة. تضيف المهارة الحكم حول تلك الإجراءات: كيفية التعرف على المهمة، التسلسل الذي يجب اتباعه، ما يجب تجنبه، وكيفية تحديد اكتمال النتيجة.

تنسيق وكلاء الذكاء الاصطناعي البعيدين عبر بروتوكول A2A — اكتشف بطاقات الوكلاء، أرسل المهام، بث النتائج، إلغاء المهام، وإدارة الإشعارات الفورية. استخدمه عند تفويض العمل إلى وكلاء بعيدين، التحقق من قدرات الوكلاء، تنسيق سير عمل متعدد الوكلاء، أو مراقبة تقدم المهام.

الهيكلية

كيف يوجه A2A Agent Orchestration وكيل ADK-Rust.

تبقى المهارة قابلة للقراءة وقابلة للنقل لأنها تحتوي على تعليمات بدلاً من بيانات اعتماد الخدمة أو بيانات العمل. يوفرها ADK-Rust للوكيل، يختار الوكيل من حدود الأدوات المراجعة، ويؤدي خادم MCP المتصل العملية المصادق عليها.

طلب المستخدم

يتلقى الوكيل هدفًا معبرًا عنه بلغة عادية.

→

مهارة A2A Agent Orchestration

يطابق النية، يزود دليل القرار، ويضيق حدود الأداة.

→

وكيل ADK-Rust

يخطط سير العمل ويبث كل خطوة ذات معنى عبر بيئة التشغيل.

→

mcp-a2a

ينفذ العمليات المصادق عليها ضد النظام الذي يمتلك القدرة.

→

النتيجة الموثوقة

تشكل قواعد إكمال المهارة الأدلة التي تُعاد إلى المستخدم.

تعليمات محمولة: SKILL.md · حدود القدرة: mcp-a2a · الأدوات المسموح بها: 10

دليل القرار

كيف يحول الوكيل الطلب إلى الإجراء الصحيح.

تأتي هذه المسارات مباشرة من تعليمات المهارة. تساعد النموذج على التعرف على النية واختيار أداة أو سير عمل مركّز بدلاً من الارتجال عبر كامل سطح القدرة.

"تفويض"، "إرسال إلى وكيل"، "توزيع"؟

send_task / send_task_streaming

"ما الوكلاء"، "القدرات"، "من يستطيع"؟

list_agents / fetch_agent_card

"حالة المهمة"، "التقدم"، "التحقق من"؟

get_task / list_tasks

"إلغاء"، "إيقاف المهمة"؟

cancel_task

"الاشتراك"، "الإشعارات"؟

subscribe_events / manage_push_notifications

سير عمل مثبتة

تسلسلات قابلة للتكرار لنتائج مفيدة.

يربط سير العمل عدة استدعاءات أدوات في مهمة يتعرف عليها المستخدم فعليًا. تشرح المهارة التسلسل والنتيجة المقصودة بينما يقوم ADK-Rust ببث تقدم الوكيل عبر بيئة التشغيل المشتركة.

013 استدعاء

اكتشاف وإرسال

العثور على وكيل → التحقق → إرسال المهمة

021 استدعاء

بث النتائج

مخرجات جزئية في الوقت الحقيقي

031-2 استدعاء

مراقبة

تتبع المهمة حتى الاكتمال

041 استدعاء

إلغاء

إيقاف المهام العالقة

حدود الأداة

قد تستخدم المهارة 10 أدوات موثقة.

يتم إعلان هذه القائمة المسموح بها من قبل المهارة. تحافظ على تركيز الوكيل على الإجراءات اللازمة لهذه المهمة بينما يحتفظ mcp-a2a بالمسؤولية عن المصادقة، التحقق، والنظام المتصل.

fetch_agent_card

validate_agent_card

list_agents

send_task

send_task_streaming

get_task

list_tasks

cancel_task

subscribe_events

manage_push_notifications

قواعد العمل

ما الذي يجب على الوكيل القيام به.

تحقق من بطاقة الوكيل قبل إرسال بيانات حساسة
حدد مهلات زمنية صريحة لجميع المهام
تابع كل مهمة حتى الانتهاء (لا ترسل وتنسى)
استخدم البث للمهام طويلة الأمد (تجربة مستخدم أفضل)

حدود التشغيل

ما الذي يجب على الوكيل تجنبه.

لا ترسل بيانات حساسة إلى وكلاء غير موثوقين
لا تترك المهام تعمل بلا مهلة زمنية
لا ترسل مهام دون التحقق من توفر الوكيل

التثبيت والاتصال

أضف المهارة بجانب القدرة التي تتوقعها.

ثبت المستودع حيث يمكن لمحمّل مهارات ADK-Rust اكتشافه، اتصل بـ mcp-a2a، وتأكد من توفر الأدوات المعلنة قبل طلب الوكيل استخدام سير العمل.

ثبت المهارة

git clone https://github.com/zavora-ai/skill-a2a-agent-orchestration.git \
  ~/.skills/skills/a2a-agent-orchestration

شكل تحميل ADK-Rust

let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("a2a-agent-orchestration").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

بيان التوافق الخاص بالمستودع: يتطلب اتصال بخادم mcp-a2a.

الوثائق الرسمية

اقرأ حزمة المهارة الكاملة.

يبقى المستودع هو المرجع الدقيق لتعليماته، أمثلته، سكريبتات المساعدة، الأصول، متطلبات MCP، الترخيص، والتحديثات اللاحقة.

نظرة عامة ↗README.md تعليمات المهارة ↗SKILL.md سير عمل عبر Mcp ↗references/cross-mcp-workflows.md أمثلة ↗references/examples.md تسلسلات الأدوات ↗references/tool-sequences.md اختيار الوكيل ↗scripts/select_agent.py تقرير إرسال الوكيل ↗assets/agent-dispatch-report.md

استمر في الاستكشاف