ما الذي ينشئه مولّد Agent Card لوكيلك الذكي

Agent Card (Agent Card) هي وصف الواجهة العامة لوكيل A2A. قبل أن يقرّر وكيل آخر استدعاء خدمتك، يحتاج إلى أكثر من رابط: يحتاج إلى وصف موثوق لغرض الوكيل وعقده التقني ومهاراته ومتطلبات الوصول إليه.

يحوّل هذا المولّد تفاصيل التنفيذ هذه إلى JSON مقروء بصيغة A2A v1.0، مع إبقاء اتخاذ القرار قريبًا من النموذج. استخدمه بعد بناء المنطق الأساسي للوكيل وقبل نشره أو إدراجه — وهي النقطة التي عادةً ما يتعطل عندها ملف Agent Card JSON المكتوب يدويًا.

اجعل وكيلك قابلاً للاكتشاف

تمنح Agent Card الواضحة عملاء A2A نقطة انطلاق موثوقة: لمن ينتمي الوكيل، وأين يقيم، وأي ربط بروتوكول وإصدارات يتحدثها.

صف واجهة قابلة للاستخدام

دوّن الواجهة المفضّلة وأنماط المحتوى وسلوك البث ودعم إشعارات الدفع التي يحتاجها وكيل آخر قبل إجراء استدعاء.

حدّد توقعات الوصول

وثّق ما إذا كانت الخدمة عامة، أو تستخدم مفتاح API، أو تتطلب OAuth 2.0، حتى تتمكن عمليات التكامل من اختيار تدفق المصادقة الصحيح — دون وضع أي بيانات اعتماد في Agent Card إطلاقًا.

حوّل المهارات إلى عقود واضحة

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

كيف يعمل مولّد Agent Card

من تفاصيل الخدمة إلى Agent Card وكيل قابلة للنشر

يحوّل مولّد Agent Card تفاصيل الخدمة إلى مستند JSON واضح وقابل للنشر. اتبع سير العمل القصير هذا قبل إرسال Agent Card إلى الإنتاج.

  1. 1

    ابدأ بالخدمة الفعلية

    أضف نقطة نهاية A2A العامة، وربط البروتوكول، وتفاصيل مزوّد الخدمة، وإصدار الوكيل، وأنواع المحتوى التي يقبلها خادمك ويعيدها.

  2. 2

    حدّد حدود القدرات والمهارات

    اختر فقط القدرات التي يدعمها تنفيذك، ثم صف مهارة واحدة تمثيلية بلغة واضحة ومحددة.

  3. 3

    راجع JSON الناتج

    استخدم المعاينة الحية لاكتشاف الحقول المفقودة أو روابط العناصر النائبة أو الأوصاف التي لا تعكس الخدمة المنشورة بدقة.

  4. 4

    تحقّق وانشر

    مرّر Agent Card عبر المدقق، ثم ضع المستند المراجَع في /.well-known/agent-card.json على نطاق خدمتك.

من يستخدم مولّد Agent Card

مصمَّم لكل من ينشئ أو ينشر أو يراجع Agent Cards الوكلاء

يساعد مولّد Agent Card البناة وفرق المنصات والمراجعين على إنشاء بيانات وصفية متسقة لوكلاء A2A دون البدء من ملف JSON فارغ.

ابدأ من مثال بدلاً من ذلك

مطوّرو الذكاء الاصطناعي والمطوّرون المستقلون

استبدل ملف agent-card.json المكتوب يدويًا بنقطة انطلاق كاملة ومتوافقة مع المواصفات عند إطلاق وكيل متوافق مع A2A.

مهندسو التوجيه ومديرو المنتجات

صِغ مستند اكتشاف موثوقًا من وصف الخدمة دون لمس صيغة JSON، ثم سلّمه للهندسة للمراجعة.

فرق المنصات وDevOps

وحّد كيفية وصف الوكلاء الداخليين لنقاط النهاية والمصادقة والمهارات قبل دخولهم إلى كتالوج وكلاء الشركة أو خط أنابيب CI.

ناشرو الأسواق

جهّز بيانات وصفية لمزوّد الخدمة ووسوم المهارات وإقرارات أمنية يمكن للمراجعين وأنظمة الترتيب تحليلها فعليًا.

الأسئلة الشائعة

أسئلة حول مولّد Agent Card

اضبط الأساسيات قبل أن يعثر عميل A2A على نقطة نهايتك.

ما هي بطاقة A2A Agent Card؟

بطاقة A2A Agent Card هي مستند اكتشاف بصيغة JSON لوكيل ذكاء اصطناعي. تُبلغ العملاء المحتملين بالهوية ومعلومات مزوّد الخدمة والواجهات المدعومة والقدرات والمهارات وأنماط المحتوى المقبولة ومتطلبات الأمان — وهي مكافئ وكيل-إلى-وكيل لملف README مع نظرة عامة على API.

لماذا استخدام مولّد Agent Card بدلاً من كتابة JSON يدويًا؟

غالبًا ما تفتقد Agent Cards المكتوبة يدويًا حقولًا مطلوبة، أو تستخدم أسماء حقول سابقة لـ v1.0، أو تحتوي أخطاء نحوية. ينتج المولّد شكل A2A v1.0 الحالي — supportedInterfaces، وprovider.organization، ووسوم المهارات المطلوبة — ويتحقق أثناء الكتابة، بحيث لا تصل الأخطاء البنيوية إلى الإنتاج أبدًا.

أي إصدار من A2A تستهدفه Agent Card الناتجة؟

يُصدر المولّد بنية A2A v1.0: مصفوفة supportedInterfaces مرتبة مع protocolBinding وprotocolVersion لكل واجهة، وحقل version للوكيل على المستوى الأعلى، وcapabilities تتضمن extendedAgentCard. Agent Cards التي تحتوي على حقول url أو preferredTransport على المستوى الأعلى تسبق v1.0.

هل يحتاج JSON الناتج إلى مراجعة قبل الإنتاج؟

نعم. ينشئ المولّد مستندًا عمليًا كنقطة انطلاق، وليس بديلاً عن عقدك المنشور فعليًا. تأكد من أن نقاط النهاية وربط البروتوكول والمهارات والمصادقة تطابق الخدمة التي سيصل إليها المستخدمون فعليًا.

أين أنشر Agent Card؟

انشر JSON المراجَع على نفس نطاق خدمة A2A الخاصة بك على https://your-domain/.well-known/agent-card.json، وهو المسار well-known المسجَّل في مواصفة A2A. تتحقق العديد من عمليات التكامل الأقدم أيضًا من /.well-known/agent.json، لذا فإن تقديم كليهما استراتيجية انتقال آمنة.

جاهز للنشر

عد إلى مولّد Agent Card قبل النشر.

أكمل التفاصيل، وراجع JSON الناتج، واستخدم التحقق الحي قبل نشر Agent Card الخاصة بك.

افتح مولّد Agent Cardتحقّق من JSON