الإجراءات (Actions)
كيف تمنح وكلاءك القدرة على التصرف: استدعاء واجهات HTTP، تكاملات سلة وشوبيفاي وسلاك، قوالب الرد، والموافقات.
ما هي الإجراءات؟
الإجراء هو شيء يستطيع وكيلك فعله، لا مجرد قوله. حين يسأل العميل "وين طلبي؟"، الوكيل الجيد لا ينبغي أن يرد "سأحولك إلى الدعم" — بل يبحث عن الطلب، يتحقق من حالته، ويجيب مباشرة داخل المحادثة. هذا ما تفعله الإجراءات.
الإجراء يمنح الوكيل أداة. الوكيل يقرر — بناءً على المحادثة — ما إذا كانت الأداة مناسبة وما المدخلات التي يجب تمريرها. إذا استدعى الأداة، تعود النتيجة ويستخدمها ليرد على العميل بشكل طبيعي.
لستَ بحاجة إلى كتابة أي كود لربط هذا. تصف الإجراء عبر نموذج قصير، ويتكفل سُديم بالباقي — استنتاج المخطط، التحقق من المعاملات، التنفيذ، وعرض النتيجة.
متى تحتاج إلى إجراء؟
- للبحث عن معلومة — الطلبات، المنتجات، أرقام التتبع، بيانات الحساب، التوفر.
- للكتابة في نظام آخر — إنشاء تذكرة، تحديث حالة، تسجيل عميل محتمل، حجز موعد.
- للتحويل إلى إنسان — نشر رسالة على سلاك، تنبيه شخص من فريق الدعم، إرسال نموذج.
- لعرض واجهة غنية — بطاقة منتج، قائمة، تفصيل سعر، نموذج حجز داخل المحادثة.
إذا وجدت نفسك تكتب في البرومبت "عندما يسأل العميل كذا قل له راسل الدعم"، فهذه إشارة واضحة إلى أنك تحتاج إجراءً بدلًا من ذلك.
أنواع الإجراءات الأربعة
1. الإجراءات المخصصة (Custom HTTP)
النوع العام. تعطيه عنوان API وطريقة HTTP ورؤوسًا اختيارية ومجموعة من المعاملات. يتعلم الوكيل اسم الإجراء ووصفه، ويستدعيه بالمعاملات التي يستخرجها من المحادثة.
استخدم هذا النوع لأي REST API تملكه بالفعل: API الإدارة الداخلي، webhook لـCRM، نظام حجز، متتبّع شحنات.
2. إجراءات تكامل سلة
إجراءات جاهزة لمتاجر سلة. اربط متجرك مرة واحدة عبر OAuth، ويحصل الوكيل فورًا على أدوات للبحث في المنتجات، واسترجاع الطلبات، ومعلومات العملاء، والمزيد — دون إعداد endpoints يدويًا.
3. إجراءات تكامل شوبيفاي
الفكرة نفسها لشوبيفاي. OAuth واحد ويصبح وكيلك متحدثًا بلغة شوبيفاي — منتجات، طلبات، عملاء، شحن، خصومات.
4. إجراءات تكامل سلاك
للتصعيد والتدفقات الموجهة إلى فريقك. يستطيع الوكيل نشر الرسائل، فتح الخيوط، وتنبيه القنوات. الاستخدام الشائع: عندما تحقق محادثةٌ قاعدةَ تصعيد، يُرسَل إشعار للقناة المناسبة مع السياق الكامل لكي يتدخل شخص من فريقك.
قوالب الرد (Response Templates)
نادرًا ما تكون استجابة الـAPI هي ما تريد عرضه للمستخدم. مئتا سطر من JSON لا مكان لها في فقاعة محادثة.
قوالب الرد تتيح لك تحويل المخرجات الخام إلى رد مقروء — أو إلى مكوّن واجهة غنيّ. تكتب قالبًا قصيرًا يُشير إلى حقول من الاستجابة، ويعرض سُديم النتيجة داخل المحادثة.
طريقتان لاستخدام القوالب:
- رد نصي — حوّل الحقول إلى جملة قصيرة يعيدها الوكيل.
- بطاقة واجهة ديناميكية — اعرض مكوّن
CustomTemplateCardيُظهر منتجًا، قائمة، تفصيل سعر، أو نموذجًا داخل تدفّق الرسائل.
القالب مرتبط بالإجراء نفسه، لذا يمكن أن يملك كل إجراء عرضه الخاص دون تضخيم برومبت الوكيل.
ملاحظة حول الاستجابات الكبيرة. تُحفظ الاستجابات الضخمة كاملةً، لكنها تُبث إلى الـwidget عبر مرجع هيدريشن للبقاء ضمن حدود حجم البث. لا تحتاج إلى فعل أي شيء — يتكفّل سُديم بذلك تلقائيًا.
الموافقات
بعض الإجراءات لا ينبغي أن تُنفّذ بدون إذن بشري — الاسترجاعات، الإلغاءات، وأي شيء يكتب في نظام دفع. علّم الإجراء بأنه يتطلب موافقة، فيوقف سُديم الدور، يُشعر فريقك، ويستأنف الوكيل في اللحظة التي يوافق فيها أحد (أو يعتذر بلطف للمستخدم عند الرفض).
خلال الانتظار يرى المستخدم "هذا الإجراء يتطلب موافقة — أرسلنا الطلب إلى الفريق" بدل الصمت. فريقك يستلم إشعارًا داخل التطبيق يحتوي السياق الكامل والمدخلات التي أراد الوكيل تمريرها، فيرى المراجع تمامًا ما يوافق عليه.
Playground التجربة
كل صفحة إجراء تأتي معها لوحة تجربة (Playground). حادث الوكيل، شاهد أيّ أداة اختار لكل رسالة، وافحص المدخلات التي مرّرها والاستجابة الخام التي استلمها. إنها أسرع طريقة لبناء الثقة بأن الإجراء سيُستدعى حين تتوقع، ولن يُستدعى حين لا ينبغي.
استخدمها قبل كل نشر. تلتقط أخطاء المخطط وأسماء المعاملات السيئة والوكلاء المتحمسين أكثر من اللازم في ثوانٍ.
تصميم إجراءات جيدة
بعض القواعد تعلّمناها بالطريق الصعب:
- سمِّ الإجراء ووصفه للوكيل، لا للمستخدم. الوكيل يقرأ الوصف ليقرر هل يستخدمه. "ابحث عن شقق سكنية حسب المدينة والميزانية" أفضل من "API العقارات".
- اجعل أسماء المعاملات واضحة.
city,max_price,property_type— وليسp1,cat,f. - اجعل الاستجابات مُركّزة. أعد النتائج الخمس الأهم، لا كامل الخمسمئة. استجابات أصغر = وكيل أسرع، واجهة أنظف، تكلفة أقل.
- افشل بلطف. إذا أعاد الـAPI خطأ، أعد رسالة قصيرة مقروءة في جسم الاستجابة. سيستخدمها الوكيل ليعتذر ويقترح خطوة تالية، بدل أن يتجمّد.
- جرّب في الـPlayground أولًا، في كل مرة. لا تنشر إجراءً لم تُحادث الوكيل من خلاله.
إلى أين بعد ذلك؟
- المقدمة ← ما هو سُديم والبداية في خمس دقائق
- تكامل سلة — اربط متجر سلة بنقرتين (قريبًا)
- تكامل شوبيفاي — الشيء نفسه لشوبيفاي (قريبًا)
- تصعيد سلاك — كيف تُحوّل المحادثات إلى فريقك (قريبًا)