إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
الأدوات هي كتل الإنشاء التي تسمح لوكيلك بالتفاعل مع الأنظمة الخارجية. تعمل الأدوات على توسيع ما يمكن لوكيلك القيام به، ما يتيح لوكيلك تنفيذ إجراءات مختلفة استجابة لطلبات المستخدم أو المشغلات المستقلة. تمثل كل أداة قدرة محددة يمكن أن يقوم بها عاملك. على سبيل المثال، يمكنك تزويد وكيلك بالأدوات التي تؤدي مهاما مثل:
- إرسال رسائل البريد الإلكتروني باِسْتِخْدام موصل Office 365 Outlook
- التحقق من الظروف الجوية الحالية والتنبؤات
- قراءة البيانات وكتابتها من Dataverse
- قراءة الرسائل ونشرها فِي Teams
آليات لإضافة أدوات إلى الوكلاء
يمكنك توسيع قدرات الْعامِلُ المخصص الخاص بك عن طريق إضافة واحدة أو أكثر من الأدوات. يمكن للوكيل الخاص بك استخدام أدوات للاستجابة للمستخدمين تلقائيا، باستخدام التنسيق التوليدي. يمكنك أيضا استدعاء الأدوات بشكل صريح من داخل موضوع.
باستخدام التنظيم التوليدي (نشط بشكل افتراضي)، يمكن للوكيل الخاص بك تلقائيًا تحديد الأداة أو موضوع الأنسب، أو البحث في المعرفة، للاستجابة لمستخدم. ينشئ وضع التنسيق هذا تجربة محادثة أكثر ديناميكية وذكاء.
في الوضع الكلاسيكي (مع إيقاف تشغيل التنسيق التوليدي)، لا يمكن للوكيل إلا اِسْتِخْدام المواضيع للرد على الْمُسْتَخْدِم. ومع ذلك، ما زال بإمكانك تصميم الوكيل الخاص بك لاستدعاء الأدوات بشكل صريح داخل المواضيع.
هناك العديد من الآليات المتاحة لك لإضافة أدوات إلى عاملك:
-
الموصل: الاتصال بواجهات برمجة التطبيقات والخدمات الخاصة باِسْتِخْدام مُوصِّلات Power Platform لسحب البيانات أو تنفيذ الإجراءات.
- موصل تم إنشاؤه مسبقا: اختر من بين مجموعة مختارة من الاتصالات المعينة مسبقا لآلاف واجهات برمجة التطبيقات الشائعة من كل من Microsoft وغير خدمات Microsoft.
- موصل مخصص: حدد اتصالا بخدمة أو نِظَامٌ مخصص لتمكين خيارات الأدوات المخصصة باِسْتِخْدام مُوصِّلات Power Platform. يحتاج الموصل إلى أذونات العرض والمشاركة للمؤسسة حَتَّى يستخدم الْعامِلُ الموصل.
- تدفق الْعامِلُ: حدد تدفق عامل، بما فِي ذلك إجراء واحد أو أكثر لتنفيذه.
- الإيعاز: إيعاز يعتمد على نموذج ذو تفاعل واحد يمكنه الإشارة إلى المعرفة التي تقدمها وإنشاء التعليمات البرمجية لتحليل البيانات.
- REST API: حدد اتصالا بواجهة برمجة تطبيقات REST، وحدد نقطة نهاية واجهة برمجة تطبيقات واحدة أو أكثر وأساليب لإضافتها كأدوات.
- بروتوكول سياق النموذج: الاتصال بخادم MCP للوصول إلى الأدوات والموارد.
- اِسْتِخْدام الكمبيوتر: يتيح لعاملك التفاعل مع أي نِظَامٌ يحتوي على واجهة مستخدم رسومية، لمواقع الويب وتطبيقات سطح المكتب، وتحديد الأزرار، واختيار القوائم، وإدخال النص فِي الحقول على الشاشة.
هناك آليتان أخريان يمكنك اِسْتِخْدامهما لإضافة سلوك يشبه الأدوات إلى عاملك:
- المهارات: حاوية لمجموعة من الأدوات ذات الصلة.
- أداة العميل: إرسال نشاط حدث إلى العميل بحيث يقوم العميل بتنفيذ إجراء وإرجاع استجابة.
لمزيد من المعلومات حول المهارات وأدوات العميل، راجع الارتباطات الموجودة فِي قسم المحتوى ذي الصلة.
إنشاء وإضافة أداة جديدة على مستوى الْعامِلُ
إن إنشاء أدوات جديدة مباشرة داخل Copilot Studio يبسط عملية التطوير ويضمن التكامل الصحيح مع عاملك. تتوفر الأدوات المضافة إلى عامل للتنسيق التلقائي خلال محادثات عاملك.
افتح عاملك عن طريق اختيار Agents فِي جزء التنقل الأيسر وتحديد الْعامِلُ الخاص بك من القَائِمَة.
انتقل إلى صفحة أدوات للعامل.
حدد إضافة أداة.
في جزء إضافة أداة، حدد أداة جديدة.
حدد نوع الأداة التي تريد إضافتها من القَائِمَة التي تظهر:
- موجه
- تدفق الْعامِلُ
- استخدام الكمبيوتر
- الموصل المخصص
- بروتوكول سياق النموذج
- واجهة برمجة تطبيقات REST
قم بتنفيذ خطوات التكوين الخاصة بنوع الأداة التي حددتها. على سبيل المثال، إذا حددت موجه، يجب عليك تنفيذ الخطوات التالية:
- تعريف قالب الموجه والإرشادات
- تحديد معايير الإدخال
- تكوين مصادر المعرفة
- تعيين تنسيق الاستجابة والقيود
حدد حفظ أو نشر، حسب الاقتضاء، لإنشاء الأداة الجديدة.
حدد إضافة وتكوين. تتم إضافة الأداة إلى وكيلك. تظهر صفحة التكوين الخاصة بالأداة الخاصة بك. يمكنك عرض تكوين الأداة وإجراء تغييرات عليه هنا.
يمكنك مشاهدة الأداة الجديدة فِي صفحة أدوات للعامل.
استعرض إعدادات أداتك وقم بإجراء التغييرات عليها.
يمكنك عرض تكوين الأداة وتحريرها فِي أي وقت: انتقل إلى صفحة أدوات لعاملك، وحدد الأداة من قَائِمَة الأدوات.
ستفتح صفحة إعدادات أداتك. يتم عرض التفاصيل فِي ثلاثة أقسام:
- التفاصيل
- Inputs
- Completion
بالنسبة لخوادم MCP المتصلة كأدوات عامل، تختلف صفحة التكوين عن أنواع الأدوات الأخرى. قسم التفاصيل مشابه، ولكن بدلاً من المدخلات والإكمال، هناك أدوات وموارد تحتوي على معلومات حول الأدوات والموارد المتاحة لخادم MCP. لمزيد من المعلومات، راجع عرض الأدوات والموارد فِي خادم MCP موجود.
التفاصيل
يتيح لك قسم التفاصيل تكوين التفاصيل الأساسية حول أداتك.
هنا، يمكنك العرض والتحديث:
الاسم: اسم الأداة. يظهر هذا الاسم فِي قَائِمَة الأدوات الخاصة بعاملك. اختر اسما يشير بوضوح إلى وظيفة الأداة.
وصف:وصف الأداة. يعتمد التنسيق التوليدي على هذا الوصف لتحديد متى يجب أن يستخدم الْعامِلُ الأداة. اكتب أوصافا واضحة ومحددة بما فِي ذلك ما تفعله الأداة ومتى يجب اِسْتِخْدامها.
تفاصيل إضافية:
- السماح للعامل بتحديد وقت اِسْتِخْدام الأداة ديناميكيا: عند تحديد هذا الخيار، يمكن للعامل اِسْتِخْدام التنسيق التوليدي لتحديد وقت اِسْتِخْدام الأداة. إذا لم يتم تحديد هذا الخيار، يستخدم الْعامِلُ الأداة فقط عندما يتم استدعاؤها بشكل صريح من موضوع. (بشكل افتراضي، يتم تحديد هذا الخيار عند تمكين التنسيق التوليدي.)
- اسأل الْمُسْتَخْدِم النهائي قبل التشغيل: فِي تجربة دردشة الْمُسْتَخْدِم النهائي، اطلب من الْعامِلُ التأكيد قبل تشغيل الأداة. يتم تعيين هذَا الخيَار إلى لا بشكل افتراضي.
- المصادقة: حدد ما إذا كنت تريد اِسْتِخْدام بيانات اعتماد الْمُسْتَخْدِم (الْمُسْتَخْدِم النهائي) أو بيانات اعتماد صانع (المقدمة من Maker) للأداة. بشكل افتراضي، يتم تطبيق مصادقة الْمُسْتَخْدِم.
- الوصف: اختياريا، يمكنك إضافة وصف للأداة التي يعرضها الْعامِلُ للمستخدم عندما يريد تشغيل الأداة. يتيح هذا الوصف للمستخدم معرفة ما يطلب منه المصادقة.
Inputs
هنا، يمكنك عرض وتكوين مدخلات الأداة الخاصة بك. يتم اِسْتِخْدام المدخلات لجمع المعلومات من الْمُسْتَخْدِم لملء المدخلات المطلوبة للأداة. يتم عرض المعلومات كجدول، سطر واحد لكل إدخال.
بشكل افتراضي، يتم تعيين قيمة تعبئة باِسْتِخْدام العمود لكل إدخال إلى تعبئة ديناميكية مع الذَّكَاءُ الِاصْطِنَاعِيُّ. يحاول الْعامِلُ استخراج القيمة من السياق المتوفر - على سبيل المثال، من رسالة الْمُسْتَخْدِم. إذا لم يتم العثور على قيمة مناسبة، فإنه ينشئ سؤالا لطرح قيمة على الْمُسْتَخْدِم. حدد تخصيص للوصول إلى المزيد من التخصيصات الدقيقة لجمع الإدخالات وملئها:
- اسم العرض والوصف: كيف يظهر الإدخال للمستخدم.
- تحديد ك: كيفية تفسير استجابة الْمُسْتَخْدِم، على سبيل المثال كسلسلة نص أو تعيينها إلى كيان معرف مسبقا.
- إعادة محاولة المنطقإذا لم يتعرف الْعامِلُ على كيان فِي بيان الْمُسْتَخْدِم، فيمكنه طرح السؤال مرة أخرى.
- التحقق من صحة الإدخال: تكوين سلوك التحقق الإضافي على إدخال الْمُسْتَخْدِم بعد الافتراضي لنوع الكيان.
يمكنك أيضا اختيار تجاوز إدخال بقيمة صريحة بدلا من السماح للعامل باستخراجه. لتعيين تخطٍ، قم بتعيين تعبئة باستخدام إلى قيمة مخصصة، وادخل قيمة، أو حدد متغيرًا، أو استخدم صيغة Power Fx. إذا تم تجاوز إدخال، لا يطلب الْعامِلُ من الْمُسْتَخْدِم قيمة.
Completion
هنا، يمكنك تحديد ما تريد أن يحدث عند الانتهاء من تشغيل الأداة.
يمكنك أن يكون الْعامِلُ يقوم تلقائيا بإنشاء استجابة سياقية لمستخدم، استنادا إلى استعلامه ونتيجة الأداة.
بدلا من ذلك، يمكنك اختيار تأليف استجابة محددة منسقة لإرجاع الأداة. يمكنك إدراج مراجع لمتغيرات الإخراج من الأداة باِسْتِخْدام منتقي المُتَغَيِّرات. يمكنك أيضا اِسْتِخْدام صيغ Power Fx لتنسيق الاستجابة.
ضمن بعد التشغيل، حدد أحد الخيارات المختلفة القليلة لكيفية استجابة الأداة للمستخدم بعد تشغيل الأداة:
- عدم الاستجابة (افتراضي): يدمج الْعامِلُ إخراج الأداة فِي استجابته
- كتابة الاستجابة باستخدام الذكاء الاصطناعي التوليدي: دع الذكاء الاصطناعي يصوغ استجابة سياقية باستخدام مخرجات الأداة
- إرسال استجابة محددة: إنشاء استجابة قالبية مع تضمين متغيرات
- إرسال بطاقة موائمة: إنشاء استجابات غنية وتفاعلية باِسْتِخْدام الأزرار والإجراءات
يمكنك أيضا تكوين متغيرات الإخراج التي يجب توفيرها للعامل والأدوات الأخرى.
تحديد الأدوات ومجموعة الإدخال
عند تعريف أداة فِي Copilot Studio، فإنك توفر أيضا معلومات تصف الغرض منها. تتيح هذه المعلومات للعامل تحديد وقت اِسْتِخْدام الأداة. يساعد وصف الأداة أيضا المنسق على اِسْتِخْدام الذَّكَاءُ الِاصْطِنَاعِيُّ التوليدية لإنشاء أسئلة، حسب الحاجة، لجمع المدخلات. يمكن لعاملك اِسْتِخْدام الأسئلة لجمع المعلومات لملء المدخلات اللازمة لاِسْتِخْدام الأداة. ونتيجة لذلك، لن تحتاج إلى إنشاء عقد الأسئلة يدويًا لجمع جميع المدخلات المطلوبة، مثل المدخلات فِي التدفق. يقوم منسق الوكيل بإدارة جمع المدخلات نيابة عنك أثناء وقت التشغيل.
يأخذ الْعامِلُ فِي الاعتبار عدة عوامل لتحديد تحديد الأداة:
- اسم الأداة ووصفها
- سياق المحادثة الحالي
- هدف الْمُسْتَخْدِم المشتق من رسالته
- المدخلات والمخرجات المتاحة
- اِسْتِخْدام الأداة السابقة فِي المحادثة
عند استخدام الوضع التوليدي، بشكل افتراضي، تعيد الأدوات معلوماتها مرة أخرى إلى العامل. مع استجابة الأداة، يمكن للعامل إنشاء استجابة سياقية لاستعلام الْمُسْتَخْدِم. بدلا من ذلك، يمكنك إرشاد الأداة للاستجابة دائما على الفور، إما إنشاء رسالة أو تأليف رسالة صريحة.
نصيحة
عند اِسْتِخْدام الأسئلة التي تم إنشاؤها من أداة، أبلغ الْمُسْتَخْدِمين بأن الذَّكَاءُ الِاصْطِنَاعِيُّ إنشاء بعض المحادثة.
على سبيل المثال، أضف رسالة إضافية فِي موضوع نِظَامٌ بدء المحادثة. يحدد هذا الْمَوْضُوعُ الرسالة التي تظهر للمستخدمين عند بدء محادثة جديدة.
استدعاء أداة موجودة من داخل موضوع
يمكنك استدعاء أداة بشكل صريح من داخل موضوع معين. اعتمادا على حالة الاستخدام الخاصة بك، قد تستخدم الأداة الخاصة بك كجزء من موضوع أوسع، والذي يستخدم عقدا متعددة. أو، كما هو الحال في المثال التالي، قد تكون إضافة عقدة إجراء (أداة) واحدة إلى موضوع كل ما تحتاجه.
لاستدعاء أداة من داخل موضوع:
في Copilot Studio، انتقل إلى صفحة المواضيع للعامل الذي تريد تحريره.
أنشئ موضوعا جديدا، وامنحه اسما، على سبيل المثال، الحصول على الطقس.
إضافة عبارات المشغل المناسبة. للمتابعة مع نفس مثال الطقس من الخطوة السابقة، يمكن أن تتضمن عبارات التنشيط ما يلي:
- هل ستمطر؟
- توقعات اليوم
- الحصول عَلى توقعَات الطقس
- مَا أحوال الطقس؟
حدد إضافة عقدة (+) ثم حدد إضافة أداة.
حدد الأداة من الأدوات المتوفرة. هناك ثلاث علامات تبويب تعرض أنواعا مختلفة من الأدوات:
- الأدوات الأساسية
- الموصل
- Tool
تم الآن إضافة عقدة الإجراء إلى موضوعك.
حَدِّد حِفظ.
معلومات موصل MCP
بالنسبة إلى موصل MCP، يمكنك عرض أسماء أوصاف أدوات MCP والموارد التي يتم توفيرها بواسطة موصل MCP. يتم عرض معلومات الأدوات والموارد فِي جدول، سطر واحد لكل أداة.
اعتبارات المصادقة للأدوات
تتطلب بعض الأدوات المصادقة للعمل بشكل صحيح، مثل Dynamic Prompt أو الأدوات الأخرى التي تستدعي واجهة برمجة تطبيقات Dataverse. يضمن تكوين المصادقة السليم الأمان مع الحفاظ على تجربة مستخدم سلسة.
يتم تشغيل الأدوات دائما فِي وقت تشغيل الْعامِلُ فِي سياق الْمُسْتَخْدِم ولا يمكن تشغيلها ما لم يتم تمكين المصادقة. يتم دعم نوعين من أساليب المصادقة:
- بيانات اعتماد المستخدم النهائي: يستخدم الوكيل بيانات اعتماد المستخدم للمصادقة مع الخدمة. تضمن هذه الطريقة وصول الْمُسْتَخْدِمين إلى البيانات المصرح لهم برؤيتها فقط.
- بيانات الاعتماد التي يوفرها Maker: يستخدم الْعامِلُ بيانات اعتماد مؤلفه للمصادقة مع الخدمة. استخدم وضع المصادقة هذا للموارد المشتركة أو عندما لا يحتاج الْمُسْتَخْدِمون إلى الوصول الفردي.
اختبار الأداة الخاصة بك
مع التنسيق التوليدي، يقوم المنسق باختيار أداتك عندما يراها ذات صلة باستفسار المستخدم.
بدلا من ذلك، يمكنك استدعاء أداة موجودة من داخل موضوع.
تشغيل أداة أو إيقاف تشغيلها في الوكيل الخاص بك
يمكنك تشغيل أداة أو إيقاف تشغيلها لعاملك من صفحة تكوين الأداة. يؤدي إيقاف تشغيل أداة إلى منع الْعامِلُ من اِسْتِخْدام الأداة، ولكن الأداة لا تزال متصلة بالْعامِلُ ويمكن تشغيلها مرة أخرى لاحقا. عند إضافة أداة إلى عامل، يتم تشغيل الأداة بشكل افتراضي.
لإيقاف تشغيل أداة فِي عامل:
- انتقل إلى وكيلك وحدد صفحة الأدوات لوكيلك.
- حدد الأداة للانتقال إلى صفحة تكوين الأداة.
- في أعلى صفحة التكوين، قم بإيقاف تشغيل الأداة باِسْتِخْدام مفتاح التبديل Enabled .
- حدد حفظ لحفظ التغييرات.
لا تزال الأداة تظهر فِي قَائِمَة أدوات الْعامِلُ، ولكنها لم تعد قيد التشغيل.
حذف أداة من وكيلك
يؤدي إيقاف تشغيل أداة إلى منع اِسْتِخْدام الأداة، ولكنه يمنحك أيضا المرونة لتشغيلها مرة أخرى لاحقا. يمكنك أيضا إزالة أداة بصورة دائمة من عميلك. لحذف أداة من برنامج الْعامِلُ الخاص بك:
- انتقل إلى وكيلك وحدد صفحة الأدوات لوكيلك.
- ابحث عن الأداة فِي قَائِمَة الأدوات وقم بالمرور فوق اسم الأداة. حدد النقاط الثلاث (...).
- حدد حذف. تظهر نافذة تأكيد.
- حدد حذف لحذف أداة.
تختفي الأداة من قَائِمَة أدوات الْعامِلُ.
ملحوظة
يمكنك فقط حذف الأدوات من صفحة أدوات الْعامِلُ. لا يمكنك حذف الأدوات من صفحة أدوات Copilot Studio الرَّئِيسِيّة.
القيود المفروضة على الأدوات في الوكلاء
- عند استخدام التزامن التوليدي، يمكن للمنسق التعامل مع 128 أداة كحد أقصى لكل عامل. للحصول على أفضل أداء ونتائج، ومع ذلك، نوصي بتحديد عدد الأدوات في وكيلك إلى ما لا يزيد عن 25-30.
- عند استخدام التزامن متعدد العوامل مع الوكلاء التابعين، يكون للوكلاء التابعين تنسيقهم الخاص ويمكنهم إدارة المجموعة الخاصة بهم التي تصل إلى 128 أدوات.