أدوات مخصصة: انتظار العودة والعودة إلى الوكيل

​

الفكرة بجملة

العميل يطلب شيئاً يحتاج نظاماً خارجياً
  → الوكيل يستدعي نية بأدوات/نوايا العقدة
    (مع تفعيل «انتظار العودة»)
  → المسار على منفذ النية يعمل
    (HTTP، شروط، إجراءات ذكاء اصطناعي…)
  → فرع ينتهي بـ «العودة إلى الوكيل» + نتيجة
  → الوكيل يستأنف ويرد للعميل مستنداً للنتيجة

​

متى مخرج؟ ومتى أداة مخصصة؟

​

المكوّنان في المحرر

​

1) على عقدة وكيل المساعد — النية

​

2) على المسار — إجراء العودة إلى الوكيل

​

تسلسل التشغيل (ماذا يحدث تحت الغطاء باختصار)

1. الوكيل يقرر استدعاء النية ويجمع المعاملات.
2. يمكنه إرسال رد قصير اختياري للعميل («لحظة أتأكد من الشحنة…») ثم يخرج للمنفذ.
3. النظام يُبقي جلسة الوكيل ويحجز تذكرة انتظار للمحادثة (مهلة تقريبية ١٠ دقائق).
4. فرع الأتمتة يعمل بحرية (شروط، HTTP، إجراءات ذكاء اصطناعي…).
5. العودة إلى الوكيل تقرأ النتيجة، تحقّنها للوكيل كنتيجة أداة، فيكمل الدور ويرد للعميل — وتظهر استدعاءات الأداة في البريد الوارد كالمعتاد.
6. إن لم تُنفَّذ العودة، أو انتهت المهلة، أو تكلّم العميل برسالة جديدة قبل العودة: لا يُختلق رد اعتذار من الوكيل لتلك الأداة.

​

سيناريوهات جاهزة للبناء

​

أ) تتبع شحنة عبر API خارجي

وكيل المساعد
  نية: track_order
  انتظار العودة: ✓
  معاملات: order_id (إلزامي) → احفظه في متغير/حقل
       │
       ▼
طلب HTTP (GET /shipments/{order_id})
  احفظ الاستجابة في متغير (مثلاً variables.shipmentStatus)
       │
       ▼
العودة إلى الوكيل
  نتيجة = variables.shipmentStatus

​

ب) أهلية عرض / كوبون من نظام الولاء

نية: check_promo_eligibility (انتظار عودة ✓)
  معاملات: promo_code اختيارياً؛ معرّف العميل من السياق إن وُجد
       │
       ▼
شرط: هل للعميل وسوم/خصائص معيّنة؟
  ├── لا → العودة بنتيجة { eligible: false, reason: "..." }
  └── نعم → HTTP لنظام الولاء → العودة بنتيجة الاستجابة

​

ج) حساب سعر مخصص ثم صياغة عرض

نية: quote_custom_price (انتظار عودة ✓)
  معاملات: product_ref، quantity، city
       │
       ▼
دالة JavaScript أو HTTP حاسبة أسعار
  → احفظ { price, currency, validUntil }
       │
       ▼
(اختياري) إجراء توليد نص داخل إجراءات الذكاء الاصطناعي
  لصياغة مسودة داخلية — أو اترك الصياغة للوكيل بعد العودة
       │
       ▼
العودة إلى الوكيل بالنتيجة المنظمة

​

د) إثراء من CRM ثم متابعة الحوار

نية: fetch_crm_context (انتظار عودة ✓)
       │
       ▼
HTTP / GraphQL داخلي → احفظ الملخص
       │
       ▼
العودة إلى الوكيل

​

ه) ماذا لا تضع هنا؟

​

قواعد ذهبية

1. كل فرع انتظار العودة = ✓ ينتهي بـ العودة إلى الوكيل — وإلا صمت الأداة.
2. مرّر نتيجة صريحة في حقل النتيجة؛ لا تعتمد على مهلة الخمول «لإكمال» الأداة (الخمول يمسح التذكرة دون اختراع نتيجة).
3. اجعل وصف النية صارماً حتى لا يستدعيها الوكيل لأسئلة يستطيع حلّها بمعرفة/قدرات داخلية.
4. رد قصير أثناء الانتظار اختياري ومفيد إن كان HTTP بطيئاً — لا تعد بنتيجة نهائية قبل العودة.
5. اختبر المسار المنشور من محادثة حقيقية: استدعاء النية، نجاح HTTP، وفشل HTTP (هل ما زلت تعود بنتيجة خطأ مفهومة؟).

​

إن لم يحدث… (سلوك متعمّد)

​

أخطاء شائعة

​

خطوات البناء السريعة

​

الخطوة التالية

• راجع حدود الجلسة والصمت: حدود معروفة وحلول بديلة.
• أو اربط مخارج أخرى: تصعيد منظّم · حجز عبر Flow.

​

ذات صلة

• عقدة: وكيل المساعد
• النشر عبر الأتمتة
• أدوات الوكيل الذكي وإجراءات الذكاء الاصطناعي
• تصعيد منظّم
• حجز عبر واتساب Flow
• طلب HTTP