كيف أُعدّ خطوة الشرط؟

ما فائدتها؟

تنظر خطوة «شرط» إلى المتغيرات وترسل الوكيل إلى أحد فروعها.

لا يرى الزائر هذه الخطوة ولا يقول الأفاتار شيئًا؛ ويتابع الوكيل دون انتظار الزائر.

لإضافتها انقر على «إضافة خطوة» في تبويب «المحرر»، ثم انقر على «شرط» في فئة «المنطق» فتُضاف الخطوة في وسط اللوحة. وإعداداتها في تبويب «المحتوى» في لوحة الخطوة التي تُفتح على الجانب عند النقر عليها.

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

تكتب في القيم متغيرات من الخطوات السابقة، مثل {city}. ولحقل داخل إجابة أضف اسم الحقل بعد نقطة: {order.status}. يعرض زر «إدراج متغير» في الحقول المتغيرات التي يمكنك استخدامها في تلك النقطة. والمتغير الذي لم يُملأ بعد يُعدّ نصًا فارغًا.

إعداد الفروع

تُفتح الخطوة الجديدة بفرع واحد؛ ولإضافة غيره انقر «إضافة فرع».

1. أعطِ الفرع اسمًا (مثل: مشروع كبير). إن لم تعطه اسمًا يظهر على اللوحة ملخص قاعدته.
2. اكتب القاعدة. كل قاعدة سطر واحد: القيمة المفحوصة في البداية (مثل {budget})، ثم زر المقارنة، ثم القيمة المقارَن بها (قيمة ثابتة أو متغير آخر).
3. لإضافة قاعدة أخرى انقر «و» أو «أو». القواعد المربوطة بـ«و» يجب أن تتحقق معًا، ومع «أو» يكفي أحد الطرفين. «و» تُربط أولًا: «أ و ب أو ج» تعني «(أ و ب) أو ج». ويمكنك تغيير الربط لاحقًا بمفتاح «و | أو» بين القواعد.
4. اختر الخطوة التي يذهب إليها الفرع من القائمة أسفله (يظهر فيها «لم تُحدَّد خطوة هدف» وهي فارغة)، أو اربط مقبض الفرع بخطوة على اللوحة.
5. اختر خطوة لـ«في الحالات الأخرى» في الأسفل أيضًا: إن لم يتحقق شرط أي فرع ينتقل المسار إليها.

تُفحص الفروع بالترتيب من الأعلى إلى الأسفل؛ ويُختار أول فرع يتحقق شرطه ولا يُنظر إلى ما بعده. غيّر الترتيب بزرَّي الأسهم («نقل لأعلى» و«نقل لأسفل»)، واحذف الفرع بـ«حذف الفرع». وإن لم تُحدَّد خطوة للفرع المختار ينتهي الوكيل هناك، ولا ينتقل إلى الفرع التالي.

أنواع المقارنة

يسأل زر المقارنة أولًا عن النوع ثم عن المقارنة. والنوع يحدد طريقة مقارنة القيم:

• «نص»: «يساوي»، «لا يساوي»، «يحتوي على»، «لا يحتوي على»، «يبدأ بـ»، «لا يبدأ بـ»، «ينتهي بـ»، «لا ينتهي بـ». لا يفرّق بين الأحرف الكبيرة والصغيرة ولا بالمسافات في البداية والنهاية ولا بعلامات الأحرف: «REFUND» تساوي «refund».
• «رقم»: «يساوي»، «لا يساوي»، «أكبر من»، «أصغر من»، «أكبر من أو يساوي»، «أصغر من أو يساوي». تُقرأ أيضًا صيغ مثل 1,250.50 و1.250,50، وتُتجاهل رموز العملات. وإن لم يكن أحد الطرفين رقمًا لا تتحقق القاعدة.
• «تاريخ»: «اليوم نفسه»، «يوم مختلف»، «بعد»، «قبل»، «في اليوم نفسه أو بعده»، «في اليوم نفسه أو قبله». تُقارن التواريخ باليوم، وتُقرأ الصيغتان 31.12.2026 و2026-12-31.
• «نعم / لا»: «صحيح (نعم)» و«خطأ (لا)». تُعدّ «نعم» و«true» و«1» صحيحة، و«لا» و«false» و«0» خاطئة.
• «قائمة»: «يحتوي على عنصر»، «لا يحتوي على عنصر»، ومقارنات عدد العناصر («عدد العناصر يساوي»، «عدد العناصر أكبر من» …). تُقرأ إجابة الاختيار المتعدد وقائمة الأداة أو الإجراء ونتيجة «تعديل قائمة» كقوائم.

ولكل نوع أيضًا «فارغ» و«غير فارغ»، ولا تحتاجان إلى قيمة ثانية. فمثلًا تتحقق القاعدة {coupon} «فارغ» إذا لم يُدخل الزائر رمز قسيمة.

مثال

في وكيل عرض سعر يذهب فرع «مشروع كبير» إلى خطوة «طلب» بالقاعدة {budget} · «رقم» · «أكبر من أو يساوي» · 50000. ويذهب فرع «مدينة قريبة» إلى نموذج الموعد بالقاعدتين {city} «يساوي» دبي «أو» {city} «يساوي» الشارقة. وتُربط «في الحالات الأخرى» بخطوة «رسالة» تخبر بأن العرض سيُرسل بالبريد الإلكتروني.

ما يجب الانتباه إليه

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

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

لا تمنع المشكلات الحفظ: يُحفظ الوكيل، لكن الخطوة الناقصة لن تعمل كما يُتوقع في المحادثة. أصلح الخطوات المعلَّمة، ثم جرّب الوكيل بـ«معاينة». ولمعرفة الخطوات المعلَّمة راجع محرر المسارات.