كيف تربط وكيل ذكاء اصطناعي بواجهة API الخاصة بك

أنشئ إجراءً مخصصاً ليتمكن وكيل Sell Whisper AI من استدعاء نقطة نهاية HTTP الخاصة بك أثناء المحادثة، مع مدخلات ومصادقة وتشغيل تجريبي. بدءاً من Starter.

الخطوات

نفّذها بالترتيب

  1. أنشئ إجراءً مخصصاً

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

    قائمة الإجراءات المخصصة لأحد الوكلاء
  2. صِف متى يُستخدم

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

    نموذج إجراء مخصّص لاستدعاء API، مع متى يُستخدم ونقطة النهاية
  3. وجّهه إلى نقطة النهاية الخاصة بك

    حدّد الطريقة (method) ورابط نقطة النهاية والترويسات ومعاملات الاستعلام وجسم طلب بصيغة JSON. اختر نوع المصادقة: مفتاح API، أو bearer token، أو المصادقة الأساسية (basic auth)، أو ترويسة مخصصة.

  4. اختبره وفعّله

    احفظ، ثم انقر على اختبار ببيانات حقيقية (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).
  • من الذي يسأل. للاستدعاءات الخاصة بحساب بعينه، تحقّق من المستخدمين المسجّلين ليحمل الطلب هوية وقّعها خادمك.

اعرض النتيجة

فعّل عرض النتيجة لإظهار الاستجابة كبطاقة أو نموذج أو جدول في الأداة. وتتلقى تطبيقات المراسلة المحتوى نفسه كنص.

ذو صلة

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

أسئلة شائعة

هل يمكن عرض الاستجابة كبطاقة أو جدول؟
نعم. فعّل عرض النتيجة واربط حقول الاستجابة ببطاقة أو نموذج أو جدول. والقنوات التي لا تستطيع عرضها، مثل WhatsApp، تتلقى المحتوى نفسه كنص.
هل يمكن أن يعمل الإجراء في صفحتي بدلاً من خادم؟
نعم. النوع جهة العميل (Client) يمرّر الاستدعاء إلى معالج (handler) تسجّله في صفحتك عبر SDK الأداة. وهو متاح في أداة الموقع فقط.
أين أرى ما الذي استُدعي؟
يحتفظ كل إجراء مخصص بسجلات تنفيذ تتضمن حالة كل استدعاء ومدخلاته ومخرجاته ومدته.

توثيق ذو صلة

ابدأ الآن

طبّق هذه الخطوات

ابدأ مجاناً، دون الحاجة إلى بطاقة ائتمان.