كيف تربط وكيل ذكاء اصطناعي بواجهة API الخاصة بك
أنشئ إجراءً مخصصاً ليتمكن وكيل Sell Whisper AI من استدعاء نقطة نهاية HTTP الخاصة بك أثناء المحادثة، مع مدخلات ومصادقة وتشغيل تجريبي. بدءاً من Starter.
نفّذها بالترتيب
أنشئ إجراءً مخصصاً
افتح الوكيل، وانتقل إلى الإجراءات (Actions)، ثم الإجراءات المخصصة (Custom actions)، وأنشئ إجراءً من النوع استدعاء API (API Call). الإجراءات المخصصة متاحة في Starter وما فوقها.

صِف متى يُستخدم
أعطِ الإجراء اسماً ووصفاً، واملأ حقل متى يُستخدم (When to Use) بكلمات بسيطة: فهذا النص يخبر الذكاء الاصطناعي متى يستدعي نقطة النهاية الخاصة بك. وضمن مدخلات المستخدم (User Inputs)، أضف كل قيمة ينبغي أن يجمعها الوكيل، مع نوعها وهل هي مطلوبة.

وجّهه إلى نقطة النهاية الخاصة بك
حدّد الطريقة (method) ورابط نقطة النهاية والترويسات ومعاملات الاستعلام وجسم طلب بصيغة JSON. اختر نوع المصادقة: مفتاح API، أو bearer token، أو المصادقة الأساسية (basic auth)، أو ترويسة مخصصة.
اختبره وفعّله
احفظ، ثم انقر على اختبار ببيانات حقيقية (Test with Live Data) لتشغيل الاستدعاء. اشترط تأكيد المستخدم لكل ما يغيّر البيانات، وفعّل الإجراء وجرّبه في ساحة التجربة (Playground).
أربعة أنواع من الإجراءات المخصصة
| النوع | وظيفته |
|---|---|
| استدعاء API (API Call) | يستدعي نقطة نهاية HTTP الخاصة بك من خوادم Sell Whisper AI ويقدّم الاستجابة للوكيل |
| زر رابط (Button Link) | يعرض زرًا يفتح رابطًا |
| نموذج (Form) | يعرض نموذجًا ويرسل ما يدخله عميلك إلى webhook |
| جهة العميل (Client) | يشغّل معالجًا (handler) تسجّله في صفحتك، داخل متصفح الزائر |
يستخدم هذا الدليل استدعاء API (API Call). وهو يناسب عمليات الاستعلام مثل حالة طلب أو رصيد حساب أو حجز، والتغييرات مثل إلغاء اشتراك.
اكتب الوصف للذكاء الاصطناعي
يقرر الوكيل متى يستدعي الإجراء بناءً على وصفه ونص متى يُستخدم (When to Use)، فاكتبهما كما لو كنت تشرح المهمة لزميل جديد: ما الذي يعيده الإجراء، والحالات التي تستدعي استخدامه. سمِّ كل مُدخل بوضوح واذكر شكل القيمة الصالحة. الأوصاف المبهمة هي السبب المعتاد لعدم استدعاء الإجراء أبدًا، أو لاستدعائه في اللحظة الخطأ.
حافظ على أمانه
- المصادقة. خزّن مفتاح API أو bearer token أو بيانات المصادقة الأساسية في الإجراء؛ فهي لا تُعرض لعميلك أبدًا.
- التأكيد. فعّل تأكيد المستخدم لكل ما يغيّر البيانات، ليوافق عميلك على الاستدعاء أولًا.
- الحدود وإعادة المحاولة. حدّد مهلة زمنية وعدد مرات إعادة المحاولة لنقطة نهاية بطيئة، وحدود المعدّل ضمن متقدم (Advanced).
- من الذي يسأل. للاستدعاءات الخاصة بحساب بعينه، تحقّق من المستخدمين المسجّلين ليحمل الطلب هوية وقّعها خادمك.
اعرض النتيجة
فعّل عرض النتيجة لإظهار الاستجابة كبطاقة أو نموذج أو جدول في الأداة. وتتلقى تطبيقات المراسلة المحتوى نفسه كنص.
ذو صلة
- الإجراءات المخصصة: المرجع الكامل.
- كيف ترسل العملاء المحتملين والتذاكر من الدردشة إلى HubSpot وكيف تتيح لوكيل الذكاء الاصطناعي حجز الاجتماعات: تكاملات مدمجة لا تحتاج إلى إجراء مخصص.
- وكيل الذكاء الاصطناعي: لماذا يختلف وكيل ينفّذ عن روبوت دردشة يجيب.

