مشاركة عبر

استيراد واجهة برمجة تطبيقات وكيل A2A (معاينة)

ينطبق على: الإصدار 2 الأساسي | الإصدار 2 القياسي | Premium v2

تدعم إدارة واجهات برمجة التطبيقات إدارة واجهات برمجة تطبيقات الوكلاء الذكاء الاصطناعي المتوافقة مع مواصفة بروتوكول Agent2Agent (A2A). بروتوكول A2A هو معيار مفتوح بين العميل والخادم يمكن أنظمة وكلاء الذكاء الاصطناعي المختلفة من التواصل والعمل معا باستخدام نموذج تفاعل مشترك. مع دعم واجهة برمجة تطبيقات الوكلاء في A2A في إدارة واجهات برمجة التطبيقات، يمكنك إدارة وإدارة واجهات برمجة التطبيقات للوكلاء جنبا إلى جنب مع أنواع واجهات برمجة التطبيقات الأخرى، بما في ذلك واجهات برمجة تطبيقات نماذج الذكاء الاصطناعي، وأدوات بروتوكول سياق النموذج (MCP)، وواجهات برمجة التطبيقات التقليدية مثل REST وSOAP وGraphQL.

ملاحظة

هذه الميزة قيد المعاينة ولها بعض القيود.

تعرف على المزيد حول إدارة واجهات برمجة التطبيقات الذكاء الاصطناعي في APIM:

الإمكانات الأساسية

عند استيراد واجهة برمجة تطبيقات وكيل A2A، توفر إدارة واجهة برمجة التطبيقات القدرات التالية:

  • يتوسط عمليات JSON-RPC التشغيل إلى خلفية A2A.
    • تمكن الحوكمة والتحكم في حركة المرور باستخدام السياسات.
    • عند تفعيل الملاحظة من خلال Application Insights ، تضيف السمات الخاصة ب A2A التالية للامتثال لاتفاقية الدلالة GenAI في OpenTelemetry:
      • genai.agent.id - تعيينه على معرف الوكيل المحدد في إعدادات واجهة برمجة التطبيقات
      • genai.agent.name- تعيينه على اسم واجهة برمجة التطبيقات في إعدادات واجهة برمجة التطبيقات
  • يعرض بطاقة الوكيل مع التحولات التالية:
    • يستبدل اسم المضيف باسم المضيف الخاص بمثيل إدارة واجهة برمجة التطبيقات.
    • يضبط بروتوكول النقل المفضل إلى JSON-RPC.
    • يزيل جميع الواجهات الأخرى في additionalInterfaces.
    • يعيد كتابة متطلبات الأمان لتشمل متطلب مفتاح اشتراك إدارة واجهة برمجة التطبيقات.

Prerequisites

استيراد واجهة برمجة تطبيقات وكيل A2A باستخدام البوابة

استخدم الخطوات التالية لاستيراد واجهة برمجة تطبيقات وكيل A2A إلى إدارة واجهات برمجة التطبيقات.

  1. في مدخل Microsoft Azure، انتقل إلى مثيل APIM.

  2. في القائمة اليسرى، ضمن واجهات برمجة التطبيقات، حدد واجهات برمجة التطبيقات> + إضافة واجهة برمجة التطبيقات.

  3. اختر بلاطة وكيل A2A .

    لقطة شاشة لاختيار بلاطة واجهة برمجة تطبيقات الوكيل A2A في البوابة.

  4. تحت بطاقة الوكيل، أدخل عنوان URL الذي يشير إلى وثيقة JSON الخاصة ببطاقة الوكيل. حدد التالي.

  5. في صفحة إنشاء واجهة برمجة تطبيقات لوكيل A2A ، قم بتكوين إعدادات الواجهة.

    1. إذا لم يتم تكوين رابط وقت التشغيلومعرف الوكيل تلقائيا بناء على بطاقة الوكيل، فقم بتوفير رابط وقت التشغيل لعمليات JSON-RPC لوكيلك ومعرف الوكيل المستخدم في مسارات OpenTelemetry المنبعثة من الوكيل (gen_ai.agent.id السمة).
    2. تحت إعدادات واجهة برمجة التطبيقات العامة، أدخل اسم العرض الذي تختاره في مثيل إدارة واجهة برمجة التطبيقات، ويمكنك إدخال وصف.
    3. تحت URL، أدخل مسار Base الذي يستخدمه جهاز إدارة API الخاص بك للوصول إلى واجهة برمجة تطبيقات وكيل A2A. تعرض إدارة واجهة برمجة التطبيقات عنوان URL الأساسي يمكن للعملاء استخدامه للوصول إلى واجهة برمجة التطبيقات JSON-RPC، وعنوان URL بطاقة الوكيل للوصول إلى بطاقة الوكيل عبر إدارة API.

  6. اختر إنشاء لإنشاء واجهة برمجة التطبيقات (API).

لقطة شاشة لإنشاء واجهة برمجة تطبيقات متوافقة مع وكلاء A2A في البوابة.

تكوين السياسات لواجهة برمجة تطبيقات وكيل A2A

قم بتكوين سياسات أو أكثر من سياسات إدارة واجهة برمجة التطبيقات للمساعدة في إدارة واجهة برمجة تطبيقات وكيل A2A.

لتكوين السياسات لواجهة برمجة تطبيقات وكيل A2A الخاصة بك:

  1. في مدخل Microsoft Azure، انتقل إلى مثيل APIM.
  2. في القائمة اليسرى، تحت واجهات برمجة التطبيقات (APIs)، اختر واجهة برمجة تطبيقات وكيل A2A الخاصة بك.
  3. في القائمة اليسرى، تحت A2A، اختر السياسات.
  4. في محرر السياسات، أضف أو عدل السياسات التي تريد تطبيقها على واجهة برمجة تطبيقات وكيل A2A. يتم تعريف السياسات بصيغة XML.

ملاحظة

تقوم إدارة واجهة برمجة التطبيقات بتقييم السياسات المكونة في النطاق العالمي (جميع واجهات برمجة التطبيقات) قبل السياسات في نطاق واجهة برمجة تطبيقات الوكيل A2A.

تكوين مصادقة مفتاح الاشتراك

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

  1. تحديد واجهة برمجة التطبيقات التي أنشأتها في الخطوة السابقة.
  2. في صفحة الإعدادات ، تحت الاشتراك، اختر (تفعيل) الاشتراك المطلوب.

إذا قمت بتمكين مصادقة مفتاح الاشتراك، يجب على العملاء تضمين مفتاح اشتراك صالح في Ocp-Apim-Subscription-Key الرأس أو subscription-key معلمة الاستعلام عند استدعاء واجهة برمجة تطبيقات الوكيل A2A أو الوصول إلى بطاقة الوكيل.

اختبر واجهة برمجة تطبيقات وكيل A2A

للتأكد من أن واجهة برمجة تطبيقات وكيل A2A تعمل كما هو متوقع، اتصل بالواجهة الخلفية عبر إدارة API:

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

تلميح

وبالمثل، يمكنك الوصول إلى بطاقة الوكيل من خلال إدارة واجهات برمجة التطبيقات عن طريق تقديم GET طلب إلى رابط بطاقة الوكيل المعروض في صفحة النظرة العامة في واجهة برمجة تطبيقات الوكيل A2A الخاصة بك.

القيود

  • هذه الميزة متوفرة حاليا فقط في مثيلات إدارة واجهات برمجة التطبيقات في مستويات v2.
  • تدعم فقط واجهات برمجة التطبيقات الفعالة للوكلاء A2A المبنية على JSON-RPC.
  • إلغاء تسلسل هيئات الاستجابة الصادرة غير مدعوم.

محتوى ذو صلة

  • Last updated on