الاتصال بعامِل Microsoft Foundry (مُعَايَنَةٌ)

ملاحظة

تصف هذه المقالة الميزات المستخدمة في الوكلاء أو تدفقات الوكلاء التي تعمل بواسطة الحزام القياسي.

[هذا المقال عبارة عن وثائق الإصدار التجريبي ويكون خاضع للتغيير.]

يمكنك توصيل عامل Microsoft Foundry بعاملك المخصص، ما يسمح له باستدعاء هذا ٱلْعَامِلُ للاستجابة لمستخدم أو مشغل.

مهم

تحتوي هذه المقالة على وثائق إصدار أولي Microsoft Copilot Studio وهي عرضة للتغيير.

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

إذا كنت تقوم بإنشاء عامل جاهز للإنتاج، فشاهد نظرة عامة على Microsoft Copilot Studio.

المتطلبات الأساسية

قبل أن تربط وكيل Microsoft Foundry ب Copilot Studio، يجب أن يكون لدى وكيل Foundry نقطة نهاية بروتوكول Activity مفعلة. يقوم وكيل Foundry الجديد بعرض نقاط نهاية بروتوكول الاستجاباتوA2A بشكل افتراضي فقط. إذا لم يتم تفعيل نقطة نهاية النشاط، فإن الاتصال ب Copilot Studio يفشل عند وقت التشغيل مع خطأ 400. تعرف على المزيد في تمكين A2A الوارد على وكيل Foundry.

يمكنك حاليا تفعيل نقطة نهاية النشاط برمجيا فقط، باستخدام واجهة برمجة تطبيقات REST أو حزمة تطوير تطوير Python. لا يوجد خيار لتفعيله من بوابة Microsoft Foundry. تعرف أكثر على عملية التمكين في قسم التكوين وشارك وكيلك.

بعد تفعيل نقطة نهاية النشاط، يستمر قسم نقاط النهاية في بوابة Foundry للوكيل في عرض الاستجاباتوA2A فقط. هذا الحذف في واجهة المستخدم متوقع ولا يعني أن التغيير فشل. يعمل الاتصال ب Copilot Studio بعد تطبيق التحديث.

الاتصال بعامل Microsoft Foundry

1. انتقل إلى صفحة الوكلاء لوكيلك الرَّئِيسِيّ وحدد إضافة وكيل.

2. ضمن الاتصال بعامل خارجي، حدد Microsoft Foundry مِنْ أنواع الوكلاء المتوفرة.

3. حدد الاتصال المطلوب مِنْ قائمة الاتصالات المتاحة أو أنشئ اتصالاً جديداً بين Microsoft Foundry وعامِل Copilot Studio الخاص بك. لإنشاء اتصال جديد، تحتاج إلى توفير عنوان URL لنقطة نهاية مشروع Foundry.

   ملاحظة

   عند الاتصال بوكلاء Microsoft Foundry من Copilot Studio، يمكنك الاتصال فقط بالوكلاء الذين تم إنشاؤهم في مدخل Microsoft Foundry الجديد. يؤدي الاتصال بعامل تم إنشاؤه في البوابة السابقة إلى ظهور خطأ يفيد بوجود 404 - Version not found.

4. بمجرد إنشاء الاتصال، حدد التالي.

5. ادخل الاسم المناسب و الوصفلعامِل SDK الخاص بك. يجب أن يصف الوصف الغرض مِنْ عامِل Microsoft Foundry الخاص بك، مما يسمح لعامِلك الرئيسي بفهم متى يجب استخدامه. لمزيد من المعلومات، راجع كتابة البيانات الوصفية بشكل فعال.

6. أدخل معرف ٱلْعَامِلُ لعامل Microsoft Foundry الذي تريد الاتصال به.

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

8. حدد إضافة عامل.

9. بمجرد إنشاء عامِلك، يمكنك اختبار عامِلك عَلَى الفور. إذا كنت بحاجة إلى ضبط معرف ٱلْعَامِلُ لاحقا، يمكنك القيام بذلك مِنْ صفحة التفاصيل، عن طريق تحديد عامِلك مِنْ قائمة الوكلاء .

ملاحظة

• إذا فشل أول استدعاء اختباري إلى وكيل Foundry المتصل بسبب خطأ مشابه للرسالة "أرجع الموصل 'Azure AI Foundry Agent Service' خطأ HTTP بالرمز 400." خطأ داخلي: نقطة نهاية الوكيل <name> لا تدعم النشاط. يرجى تحديث نقطة نهاية الوكيل لدعم هذا البروتوكول."، إذ إن نقطة نهاية بروتوكول Activity غير مُمكّنة في وكيل Foundry. راجع المتطلبات المسبقة في هذا المقال، ثم قم بتمكين نقطة نهاية النشاط باتباع تكوينها ومشاركة وكيلك في وثائق Microsoft Foundry.

• أنت مسؤول عن مراجعة الوكلاء المتصلين واختبارهم بعناية في سياق حالات الاستخدام المحددة، واتخاذ جميع القرارات والتخصيصات المناسبة. عندما تتصل بوكلاء خارج Copilot Studio، فأنت مسؤول عن استخدام هؤلاء الوكلاء. وتشمل الاعتبارات ضمان ما يلي:

  • تدفقات البيانات، والتعامل مع البيانات، ومشاركة البيانات بين الوكلاء مناسبة لحالة الاستخدام الخاصة بك وتلبي المتطلبات والقوانين ذات الصلة.
  • يلتزم الوكلاء بمعايير الجودة والموثوقية والأمان والموثوقية المناسبة.
  • يتم توفير صلاحيات وحدود وموافقات مناسبة، إذا كان ذلك مناسبا لحالتك.
  • المراقبة الصحيحة، والهوية والتتبع، ووظائف الإشراف البشرية موجودة.