إِضَافَةُ الأَدَواتِ إِلَى الوُكَلاءِ المُخَصَّصِينَ.

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

• إرسال رسائل البريد الإلكتروني باِسْتِخْدام موصل Office 365 Outlook
• التحقق من الظروف الجوية الحالية والتنبؤات
• قراءة البيانات وكتابتها من Dataverse
• قراءة الرسائل ونشرها فِي Teams

آليات لإضافة الأدوات

يمكنك توسيع قدرات الْعامِلُ المخصص الخاص بك عن طريق إضافة واحدة أو أكثر من الأدوات. يمكن لعاملك اِسْتِخْدام أدوات للاستجابة للمستخدمين تلقائيا، باِسْتِخْدام التزامن التوليدي. يمكنك أيضًا استدعاء الأدوات بشكل صريح من داخل موضوع معين.

باِسْتِخْدام التزامن التوليدي (نشط بشكل افتراضي)، يمكن لعاملك تلقائيا تحديد الأداة أو الْمَوْضُوعُ الأنسب، أو البحث عبر المعرفة، للاستجابة لمستخدم. ينشئ وضع التنسيق هذا تجربة محادثة أكثر ديناميكية وذكاء.

في الوضع الكلاسيكي (مع إيقاف تشغيل التنسيق التوليدي)، لا يمكن للوكيل إلا اِسْتِخْدام المواضيع للرد على الْمُسْتَخْدِم. ومَع هَذَا، لا يزَال بإمكَانِك تصميم العَامل الخَاص بك لاستدعَاء الأدوات بشكلٍ صريحٍ من دَاخل الموَاضيع.

هناك العديد من الآليات المتاحة لك لإضافة أدوات إلى عاملك:

• الموصل: الاتصال بواجهات برمجة التطبيقات والخدمات الخاصة باِسْتِخْدام مُوصِّلات Power Platform لسحب البيانات أو تنفيذ الإجراءات.
  • موصل تم إنشاؤه مسبقا: اختر من بين مجموعة مختارة من الاتصالات المعينة مسبقا لآلاف واجهات برمجة التطبيقات الشائعة من كل من Microsoft وغير خدمات Microsoft.
  • موصل مخصص: حدد اتصالا بخدمة أو نِظَامٌ مخصص لتمكين خيارات الأدوات المخصصة باِسْتِخْدام مُوصِّلات Power Platform. يحتاج الموصل إلى أذونات العرض والمشاركة للمؤسسة حَتَّى يستخدم الْعامِلُ الموصل.
• تدفق الْعامِلُ: حدد تدفق عامل، بما فِي ذلك إجراء واحد أو أكثر لتنفيذه.
• المطالبة: موجه يستند إلى نموذج واحد يمكن أن يشير إلى المعرفة التي تقدمها وإنشاء التعليمات البرمجية لتحليل البيانات.
• REST API: حدد اتصالا بواجهة برمجة تطبيقات REST، وحدد نقطة نهاية واجهة برمجة تطبيقات واحدة أو أكثر وأساليب لإضافتها كأدوات.
• بروتوكول سياق النموذج: الاتصال بخادم MCP للوصول إلى الأدوات والموارد.
• اِسْتِخْدام الكمبيوتر: يتيح لعاملك التفاعل مع أي نِظَامٌ يحتوي على واجهة مستخدم رسومية، لمواقع الويب وتطبيقات سطح المكتب، وتحديد الأزرار، واختيار القوائم، وإدخال النص فِي الحقول على الشاشة.

هناك آليتان أخريان يمكنك اِسْتِخْدامهما لإضافة سلوك يشبه الأدوات إلى عاملك:

• المهارات: حاوية لمجموعة من الأدوات ذات الصلة.
• أداة العميل: إرسال نشاط حدث إلى العميل بحيث يقوم العميل بتنفيذ إجراء وإرجاع استجابة.

لمزيد من المعلومات حول المهارات وأدوات العميل، راجع الارتباطات الموجودة فِي قسم المحتوى ذي الصلة.

إنشاء وإضافة أداة جديدة على مستوى الْعامِلُ

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

1. افتح عاملك عن طريق اختيار Agents فِي جزء التنقل الأيسر وتحديد الْعامِلُ الخاص بك من القَائِمَة.

2. انتقل إلى صفحة أدوات للعامل.

3. حدد تحديد أدَاة.

4. في جزء إضافة أداة، حدد أداة جديدة.

5. حدد نوع الأداة التي تريد إضافتها من القَائِمَة التي تظهر:

   • مطالبة
   • تدفق الْعامِلُ
   • اِسْتِخْدام الكمبيوتر
   • موصل مخصص
   • بروتوكول سياق النموذج
   • واجهة برمجة تطبيقات REST

   

6. قم بتنفيذ خطوات التكوين الخاصة بنوع الأداة التي حددتها. على سبيل المثال، إذا حددت مطالبة، يجب تنفيذ الخطوات التالية:

   • تعريف قالب المطالبة والإرشادات
   • تحديد معلمات الإدخال
   • تكوين المصادر المعرفية
   • تعيين تنسيق الاستجابة والقيود

7. حدد حفظ أو نشر، حسب الاقتضاء، لإنشاء الأداة الجديدة.

8. حدد إضافة وتكوين. تتم إضافة الأداة إلى عاملك. تظهر صفحة التكوين الخاصة بالأداة الخاصة بك. يمكنك عرض تكوين الأداة وإجراء تغييرات عليه هنا.

يمكنك مشاهدة الأداة الجديدة فِي صفحة أدوات للعامل.

استعرض إعدادات أداتك وقم بإجراء التغييرات عليها.

يمكنك عرض تكوين الأداة وتحريرها فِي أي وقت: انتقل إلى صفحة أدوات لعاملك، وحدد الأداة من قَائِمَة الأدوات.

ستفتح صفحة إعدادات أداتك. يتم عرض التفاصيل فِي ثلاثة أقسام:

• التفاصيل
• الإدخالات
• الإكمال

بالنسبة لخوادم MCP المتصلة كأدوات عامل، تختلف صفحة التكوين عن أنواع الأدوات الأخرى. قسم مشابه ولكن بدلا من ذلك المدخلات و الاكمال,يوجدالادوات و المراجع أقسام تحتوي على معلومات حول الأدوات والموارد المتاحة لخادم MCP. لمزيد من المعلومات، راجع عرض الأدوات والموارد فِي خادم MCP موجود.

التفاصيل

يتيح لك قسم التفاصيل تكوين التفاصيل الأساسية حول أداتك.

هنا، يمكنك العرض والتحديث:

• الاسم: اسم الأداة. يظهر هذا الاسم فِي قَائِمَة الأدوات الخاصة بعاملك. اختر اسما يشير بوضوح إلى وظيفة الأداة.

• وصف:وصف الأداة. يعتمد التنسيق التوليدي على هذا الوصف لتحديد متى يجب أن يستخدم الْعامِلُ الأداة. اكتب أوصافا واضحة ومحددة بما فِي ذلك ما تفعله الأداة ومتى يجب اِسْتِخْدامها.

• تفاصيل إضافية:

  • السماح للعامل بتحديد وقت اِسْتِخْدام الأداة ديناميكيا: عند تحديد هذا الخيار، يمكن للعامل اِسْتِخْدام التنسيق التوليدي لتحديد وقت اِسْتِخْدام الأداة. إذا لم يتم تحديد هذا الخيار، يستخدم الْعامِلُ الأداة فقط عندما يتم استدعاؤها بشكل صريح من موضوع. (بشكل افتراضي، يتم تحديد هذا الخيار عند تمكين التنسيق التوليدي.)
  • اسأل الْمُسْتَخْدِم النهائي قبل التشغيل: فِي تجربة دردشة الْمُسْتَخْدِم النهائي، اطلب من الْعامِلُ التأكيد قبل تشغيل الأداة. يتم تعيين هذَا الخيَار إلى لا بشكل افتراضي.
  • المصادقة: حدد ما إذا كنت تريد اِسْتِخْدام بيانات اعتماد الْمُسْتَخْدِم (الْمُسْتَخْدِم النهائي) أو بيانات اعتماد صانع (المقدمة من Maker) للأداة. بشكل افتراضي، يتم تطبيق مصادقة الْمُسْتَخْدِم.
  • الوصف: اختياريا، يمكنك إضافة وصف للأداة التي يعرضها الْعامِلُ للمستخدم عندما يريد تشغيل الأداة. يتيح هذا الوصف للمستخدم معرفة ما يطلب منه المصادقة.

الإدخالات

هنا، يمكنك عرض وتكوين مدخلات الأداة الخاصة بك. يتم اِسْتِخْدام المدخلات لجمع المعلومات من الْمُسْتَخْدِم لملء المدخلات المطلوبة للأداة. يتم عرض المعلومات كجدول، سطر واحد لكل إدخال.

بشكل افتراضي، يتم تعيين قيمة تعبئة باِسْتِخْدام العمود لكل إدخال إلى تعبئة ديناميكية مع الذَّكَاءُ الِاصْطِنَاعِيُّ. يحاول الْعامِلُ استخراج القيمة من السياق المتوفر - على سبيل المثال، من رسالة الْمُسْتَخْدِم. إذا لم يتم العثور على قيمة مناسبة، فإنه ينشئ سؤالا لطرح قيمة على الْمُسْتَخْدِم. حدد تخصيص للوصول إلى المزيد من التخصيصات الدقيقة لجمع الإدخالات وملئها:

• اسم العرض والوصف: كيف يظهر الإدخال للمستخدم.
• تحديد ك: كيفية تفسير استجابة الْمُسْتَخْدِم، على سبيل المثال كسلسلة نص أو تعيينها إلى كيان معرف مسبقا.
• إعادة محاولة المنطقإذا لم يتعرف الْعامِلُ على كيان فِي بيان الْمُسْتَخْدِم، فيمكنه طرح السؤال مرة أخرى.
• التحقق من صحة الإدخال: تكوين سلوك التحقق الإضافي على إدخال الْمُسْتَخْدِم بعد الافتراضي لنوع الكيان.

يمكنك أيضا اختيار تجاوز إدخال بقيمة صريحة بدلا من السماح للعامل باستخراجه. لتعيين تجاوز، قم بتعيين تعبئة باِسْتِخْدام إلى قيمة مخصصة، وأدخل قيمة، أو حدد متغيرا، أو استخدم صيغة Power Fx. إذا تم تجاوز إدخال، لا يطلب الْعامِلُ من الْمُسْتَخْدِم قيمة.

الإكمال

هنا، يمكنك تحديد ما تريد أن يحدث عند الانتهاء من تشغيل الأداة.

يمكنك أن يكون الْعامِلُ يقوم تلقائيا بإنشاء استجابة سياقية لمستخدم، استنادا إلى استعلامه ونتيجة الأداة.

بدلا من ذلك، يمكنك اختيار تأليف استجابة محددة منسقة لإرجاع الأداة. يمكنك إدراج مراجع لمتغيرات الإخراج من الأداة باِسْتِخْدام منتقي المُتَغَيِّرات. يمكنك أيضا اِسْتِخْدام صيغ Power Fx لتنسيق الاستجابة.

ضمن بعد التشغيل، حدد أحد الخيارات المختلفة القليلة لكيفية استجابة الأداة للمستخدم بعد تشغيل الأداة:

• عدم الاستجابة (افتراضي): يدمج الْعامِلُ إخراج الأداة فِي استجابته
• كتابة الاستجابة باِسْتِخْدام الذَّكَاءُ الِاصْطِنَاعِيُّ التوليدية: اسمح الذَّكَاءُ الِاصْطِنَاعِيُّ صياغة استجابة سياقية باِسْتِخْدام مخرجات الأداة
• إرسال استجابة محددة: تأليف استجابة قالب مع إدراج متغير
• إرسال بطاقة موائمة: إنشاء استجابات غنية وتفاعلية باِسْتِخْدام الأزرار والإجراءات

يمكنك أيضا تكوين متغيرات الإخراج التي يجب توفيرها للعامل والأدوات الأخرى.

تحديد الأدوات ومجموعة الإدخال

عند تعريف أداة فِي Copilot Studio، فإنك توفر أيضا معلومات تصف الغرض منها. تتيح هذه المعلومات للعامل تحديد وقت اِسْتِخْدام الأداة. يساعد وصف الأداة أيضا المنسق على اِسْتِخْدام الذَّكَاءُ الِاصْطِنَاعِيُّ التوليدية لإنشاء أسئلة، حسب الحاجة، لجمع المدخلات. يمكن لعاملك اِسْتِخْدام الأسئلة لجمع المعلومات لملء المدخلات اللازمة لاِسْتِخْدام الأداة. ونتيجة لذلك، لن تحتاج إلى إنشاء عقد الأسئلة يدويًا لجمع جميع المدخلات المطلوبة، مثل المدخلات فِي التدفق. يعالج منسق الْعامِلُ مجموعة الإدخال نيابة عنك فِي وقت التشغيل.

يأخذ الْعامِلُ فِي الاعتبار عدة عوامل لتحديد تحديد الأداة:

• اسم الأداة ووصفها
• سياق المحادثة الحالي
• هدف الْمُسْتَخْدِم المشتق من رسالته
• المدخلات والمخرجات المتاحة
• اِسْتِخْدام الأداة السابقة فِي المحادثة

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

تلميح

عند اِسْتِخْدام الأسئلة التي تم إنشاؤها من أداة، أبلغ الْمُسْتَخْدِمين بأن الذَّكَاءُ الِاصْطِنَاعِيُّ إنشاء بعض المحادثة.

على سبيل المثال، أضف رسالة إضافية فِي موضوع نِظَامٌ بدء المحادثة. يحدد هذا الْمَوْضُوعُ الرسالة التي تظهر للمستخدمين عند بدء محادثة جديدة.

استدعاء أداة موجودة من داخل موضوع

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

لاستدعاء أداة من داخل موضوع:

1. في Copilot Studio، انتقل إلى صفحة المواضيع للعامل الذي تريد تحريره.

2. أنشئ موضوعا جديدا، وامنحه اسما، على سبيل المثال، الحصول على الطقس.

3. إضافة عبارات المشغل المناسبة. للمتابعة مع نفس مثال الطقس من الخطوة السابقة، يمكن أن تتضمن عبارات المشغل ما يلي:

   • هل ستمطر؟
   • توقعات اليوم
   • الحصول عَلى توقعَات الطقس
   • مَا أحوال الطقس؟

4. حدد إضافة عقدة (+) ثم حدد إضافة أداة. حدد الأداة من الأدوات المتوفرة. هناك ثلاث علامات تبويب تعرض أنواعا مختلفة من الأدوات:

   • الأدوات الأساسية
   • الموصل
   • ‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫أدَاة

   تتم الآن إضافة عقدة الإجراء إلى الْمَوْضُوعُ الخاص بك.

5. حدد حفظ..

معلومات موصل MCP

بالنسبة إلى موصل MCP، يمكنك عرض أسماء أوصاف أدوات MCP والموارد التي يتم توفيرها بواسطة موصل MCP. يتم عرض معلومات الأدوات والموارد فِي جدول، سطر واحد لكل أداة.

اعتبارات المصادقة للأدوات

تتطلب بعض الأدوات المصادقة للعمل بشكل صحيح، مثل Dynamic Prompt أو الأدوات الأخرى التي تستدعي واجهة برمجة تطبيقات Dataverse. يضمن تكوين المصادقة السليم الأمان مع الحفاظ على تجربة مستخدم سلسة.

يتم تشغيل الأدوات دائما فِي وقت تشغيل الْعامِلُ فِي سياق الْمُسْتَخْدِم ولا يمكن تشغيلها ما لم يتم تمكين المصادقة. يتم دعم نوعين من أساليب المصادقة:

• إنشاءات الْمُسْتَخْدِم النهائي: يستخدم الْعامِلُ بيانات اعتماد الْمُسْتَخْدِم للمصادقة مع الخدمة. تضمن هذه الطريقة وصول الْمُسْتَخْدِمين إلى البيانات المصرح لهم برؤيتها فقط.
• بيانات الاعتماد التي يوفرها Maker: يستخدم الْعامِلُ بيانات اعتماد مؤلفه للمصادقة مع الخدمة. استخدم وضع المصادقة هذا للموارد المشتركة أو عندما لا يحتاج الْمُسْتَخْدِمون إلى الوصول الفردي.

اختبار الأداة الخاصة بك

مع التزامن التوليدي، يحدد المنسق الأداة الخاصة بك عندما يعتبرها ذات صلة باستعلام الْمُسْتَخْدِم.

بدلا من ذلك، يمكنك استدعاء أداة موجودة من داخل موضوع.

تشغيل أداة أو إيقاف تشغيلها فِي عاملك

يمكنك تشغيل أداة أو إيقاف تشغيلها لعاملك من صفحة تكوين الأداة. يؤدي إيقاف تشغيل أداة إلى منع الْعامِلُ من اِسْتِخْدام الأداة، ولكن الأداة لا تزال متصلة بالْعامِلُ ويمكن تشغيلها مرة أخرى لاحقا. عند إضافة أداة إلى عامل، يتم تشغيلها بشكل افتراضي.

لإيقاف تشغيل أداة فِي عامل:

1. انتقل إلى عاملك وحدد صفحة Tools لعاملك.
2. حدد الأداة للانتقال إلى صفحة تكوين الأداة.
3. في أعلى صفحة التكوين، قم بإيقاف تشغيل الأداة باِسْتِخْدام مفتاح التبديل Enabled .
4. حدد حفظ لحفظ التغييرات.

لا تزال الأداة تظهر فِي قَائِمَة أدوات الْعامِلُ، ولكنها لم تعد قيد التشغيل.

حذف أداة من عاملك

يؤدي إيقاف تشغيل أداة إلى منع اِسْتِخْدام الأداة، ولكنه يمنحك أيضا المرونة لتشغيلها مرة أخرى لاحقا. يمكنك أيضا إزالة أداة بشكل دائم من عاملك. لحذف أداة من برنامج الْعامِلُ الخاص بك:

1. انتقل إلى عاملك وحدد صفحة Tools لعاملك.
2. ابحث عن الأداة فِي قَائِمَة الأدوات وقم بالمرور فوق اسم الأداة. حدد ... (المزيد من الخيارات).
3. حدد حذف. تظهر نافذة تأكيد.
4. حدد حذف لحذف أداة.

تختفي الأداة من قَائِمَة أدوات الْعامِلُ.

إشعار

يمكنك فقط حذف الأدوات من صفحة أدوات الْعامِلُ. لا يمكنك حذف الأدوات من صفحة أدوات Copilot Studio الرَّئِيسِيّة.

المحتوى ذو الصلة

• استخدَام المُوصِّلات
• ‎اِسْتِخْدام المطالبات
• اِسْتِخْدام تدفقات الْعامِلُين مَعَ عاملك
• بروتوكول سياق النموذج (MCP)
• إضافة أدوات من واجهة برمجة تطبيقات REST
• اِسْتِخْدام المهارات
• أدوات العميل
• اِسْتِخْدام الكمبيوتر (إِصْدارٌ أَوَّلِيٌّ)