الأدوات: ربط المساعد بأنظمتك

ما الغرض من الأداة؟

الأداة عنوان HTTPS يعمل على نظامك (نقطة API). يستدعيها المساعد عند الحاجة أثناء المحادثة، مثل قراءة مواعيد الحجز المتاحة أو حالة الشحن أو رصيد العميل من نظامك.

استخدم الأداة لأي نظام ليس له تكامل جاهز. افتح «الأدوات» من القائمة؛ وتتطلب إضافة الأدوات وتعديلها وحذفها وتجربتها دور المالك أو المدير.

إضافة أداة جديدة

1. اضغط «أداة جديدة».
2. اكتب «اسم الأداة» بأحرف إنجليزية صغيرة وشرطة سفلية، مثل check_availability.
3. في «متى تُستخدم؟» صِف بوضوح ما تفعله الأداة ولأي أسئلة تُستدعى؛ فالمساعد يقرر متى يستدعيها بناءً على هذا الوصف.
4. أدخل الطريقة (GET أو POST) والعنوان. يجب أن يبدأ العنوان بـ https، ولا تُقبل عناوين الشبكات المحلية أو الخاصة.
5. استخدم «إضافة حقل» لتعريف الحقول التي تتوقعها الأداة: الاسم والوصف وهل هو إلزامي. يملأ المساعد هذه الحقول من المحادثة.
6. اختر «المصادقة»: بلا مصادقة أو Bearer token أو ترويسة مخصصة (مع اسم الترويسة). تُحفظ القيمة السرية على الخادم ولا تُعرض مجددًا؛ اتركها فارغة عند التعديل للإبقاء على القيمة المحفوظة.
7. قبل الحفظ جرّبها بقيم نموذجية عبر «استدعاء تجريبي»، فترى الاستجابة أو الخطأ فورًا.

الأدوات التي تغيّر البيانات

إذا كانت الأداة تغيّر شيئًا في نظامك (إنشاء سجل أو إلغاء مثلًا) فحدد «هذه الأداة تُغيّر البيانات». لا يُعاد تجريب هذه الأدوات بقيم مختلفة، ويُسجَّل كل استدعاء لها، وتظهر في القائمة بشارة «تُغيّر البيانات».

استخدام الأداة في التدفق

• في تبويب الأدوات بخطوة مساعد الذكاء الاصطناعي تختار الأدوات التي يصل إليها المساعد: كلها (بما فيها ما يُضاف لاحقًا) أو ما تحدده.
• يمكن لخطوة «اختيار» أن تجلب خياراتها من أداة؛ فتُعرض مواعيد الحجز المتاحة مثلًا كبطاقات.
• تستدعي خطوة «استدعاء أداة» الأداة عند نقطة محددة من التدفق دون ذكاء اصطناعي، وتحفظ الرد في متغير.

راجع مقالَي خطوة مساعد الذكاء الاصطناعي وخطوات المحادثة.

إدارة القائمة

ابحث في الأدوات بالاسم أو الوصف، وصفِّها حسب الطريقة ونوع المصادقة. تُعلَّم الأدوات المتعثرة بشارة «تفشل». وعند حذف أداة يتوقف المساعد عن استدعائها.