الوكلاء

نظرة عامة على الأدوات

الأنواع الأربعة من الأدوات التي يمكن للوكيل استدعاؤها، وأين يُعرَّف كل نوع، وكيف يقرر الوكيل استخدامه أثناء المحادثة.

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

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

الأنواع الأربعة

النوع ما الذي يفعله أين تعرّفه
النظام قدرة يملكها كل وكيل من البداية. توجد ثلاث: web_search وdialect_detection وend_conversation. على الوكيل، في الأدوات المدمجة
Webhook يستدعي نقطة نهاية HTTP واحدة تملكها، مع معاملات يملؤها الوكيل. مكتبة أدوات مساحة العمل، النوع webhook
OpenAPI مستند Swagger أو OpenAPI مستورد. يحمل سجل واحد في المكتبة الواجهة كاملة وعملياتها. مكتبة أدوات مساحة العمل، النوع openapi
التكامل إجراء جاهز من مزوّد متصل، مرتبط بذلك التكامل. مكتبة أدوات مساحة العمل، النوع integration

أدوات النظام ليست سجلات في المكتبة. يُنشأ كل وكيل ومعه الأدوات الثلاث، وكلها معطّلة، فتظهر البطاقات الثلاث دائماً في التبويب ولا تحتاج إلى إضافة.

توجد أدوات التكامل حالياً لثلاثة مزوّدين: Slack (add_reaction وremove_reaction)، وGoogle Calendar (check_availability وcreate_event وlist_events وlist_calendars)، وTwilio (send_sms). تبيّن كل صفحة ما توفره البوابة لأدواتها حالياً.

قواعد البيانات طريق آخر إلى البيانات الحية، وهي ليست سجلات في المكتبة أيضاً. اربط قاعدة البيانات مرة واحدة، واعتمد الأسئلة التي يحق لها الإجابة عنها، فيصل الوكيل إليها أثناء المحادثة. تغطي صفحات قواعد البيانات ضمن الأدوات ذلك.

أيّ نوع يناسبك

  • نقطة نهاية واحدة، وعدد قليل من المعاملات، ونتيجة يقرؤها الوكيل: أداة Webhook. أنت تصف الطلب بنفسك، فلا شيء يحتاج إلى استيراد.
  • واجهة API كاملة فيها عمليات كثيرة: أداة OpenAPI. استورد المستند مرة واحدة، بدلاً من بناء أداة Webhook يدوياً لكل عملية.
  • إجراء داخل منتج ربطته من قبل: أداة تكامل. تأتي العملية وبيانات الاعتماد الخاصة بها من التكامل، فلا يوجد ما تضبطه لكل استدعاء.
  • قدرة في المحادثة نفسها، مثل البحث عن معلومة على الإنترنت أو إنهاء المكالمة: أداة نظام. لا توجد نقطة نهاية تشير إليها.

أين تُحفظ الأدوات

تُحفظ أدوات مساحة العمل في مكتبة مشتركة بين كل الوكلاء في مساحة العمل. افتحها من الأدوات في قائمة التنقل الخاصة بالوكلاء، على المسار /agents/tools، وعنوان الصفحة مكتبة الأدوات. أنشئ الأداة أو عدّلها أو احذفها من هناك، أو من قائمة إضافة أداة على الوكيل.

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

الأدوات المدمجة ليس لها سجل في المكتبة. لكل وكيل زر تفعيل ووصف وإعدادات خاصة به لكل الأدوات الثلاث.

كيف يقرر الوكيل استدعاء الأداة

لا تصل كل الأدوات إلى الوكيل بالطريقة نفسها.

تكون أدوات النظام وWebhook والتكامل أمام الوكيل في كل دور، ويختار منها بالاسم والوصف. النص الحاسم هو الوصف، ولهذا يعرض منشئ Webhook في خانة الوصف النص: "ماذا تفعل هذه الأداة؟ يستخدم الوكيل هذا ليقرّر متى يستدعيها."

تعمل عمليات OpenAPI المستوردة بطريقة مختلفة. فهي لا تُعرض كلها دفعة واحدة. في كل دور يبحث الوكيل بين عملياتك المستوردة عن الأقرب إلى ما قاله المتصل للتو، ويحتفظ بأعلى 5 نتائج، ويتجاهل كل ما تقل درجته عن 0.5. وتُبحث أسئلة قواعد البيانات في المرور نفسه. يعرض الاختبار في تبويب الاختبارات حتى 3 نتائج افتراضياً، لا 5.

هذا الفرق يحدد أين تبحث عندما لا تعمل أداة أبداً. أداة Webhook المختارة تكون دائماً أمام الوكيل، فإن لم تُستدعَ فالمشكلة في صياغة وصفها. أما العملية المستوردة فيجب أن تفوز في البحث أولاً، لذلك قد يعني الإخفاق أيضاً أن عبارة المتصل لا تظهر في وصف العملية أبداً. لتكتشف ذلك قبل أن يفعله المتصل، افتح أداة OpenAPI مستوردة من تبويب الأدوات في الوكيل، ثم افتح تبويب الاختبارات فيها، فيُجري الاختبار البحث نفسه على جملة تكتبها. يظهر آخر تشغيل في عمود آخر اختبار في جدول أدوات الوكيل. ولا يُبحث في أداة Webhook أو التكامل أو النظام أبداً، لذلك ليس لها تبويب الاختبارات لهذا الغرض. اختبار الاسترجاع يشرح ما يثبته هذا الاختبار وما لا يثبته.

للحصول على أفضل نتيجة

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

الموصى به

Look up a customer's order by its order number. Call this when the caller asks
where an order is, when it will arrive, or what it contained. Returns the status,
the carrier and the expected delivery date.

الأقل فاعلية

Order lookup tool. Use for orders.

منع المقاطعة

تعمل كل أداة مدمجة مع منع المقاطعة مُعطّلاً: يستطيع المتصل أن يتكلم فوق الوكيل أثناء تشغيل الأداة فيُسمع كلامه، ويستطيع الوكيل أن يجيب بدلاً من إنهاء جملته. لا يوجد عنصر تحكم لذلك في البوابة حالياً. تعدّل نافذة الأدوات المدمجة زر التبديل والوصف.

متى يصل التغيير إلى الوكيل

يسري تغيير أداة نظام أو اختيار أداة على المحادثة التالية التي يبدأها الوكيل. أما المحادثة الجارية فتحتفظ بالأدوات التي بدأت بها.

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

هل يمكن أن تستخدم أداة واحدة عدة وكلاء؟

نعم. تُعرَّف أداة مساحة العمل مرة واحدة، وتُختار على عدد الوكلاء الذي تريده. يحتفظ كل وكيل باختياره الخاص، فإزالة الأداة من وكيل واحد لا تؤثر في الباقين.

لماذا لا تعمل أداتي أبداً؟

في أداة Webhook أو التكامل أو النظام، الوصف هو المتغير الوحيد: أعد كتابته ليذكر المواقف التي تريد استخدام الأداة فيها. أما عملية OpenAPI المستوردة، فتحقق أولاً من أن عبارة المتصل تصل إليها في تبويب الاختبارات الخاص بالأداة، ثم انظر إلى الوصف.

هل أحتاج إلى صلاحية لإضافة الأدوات؟

لا. يستطيع أي عضو في مساحة العمل إنشاء أداة، واختيارها على وكيل، وتفعيل أداة نظام.

ماذا يحدث للوكلاء عند حذف أداة من المكتبة؟

تُلغى تحديد الأداة من كل وكيل كان يستخدمها، ويستمر هؤلاء الوكلاء في العمل بدونها. ولا يمكن التراجع عن الحذف.