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

ما فائدتها؟

تشغّل خطوة «حلقة تكرار» الخطوات نفسها لكل عنصر في قائمة. للخطوة مخرجان: «لكل عنصر» و«عند الانتهاء».

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

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

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

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

إعداد الخطوة

1. اختر المصدر في «مصدر العناصر» وأدخل العناصر (أدناه).
2. أدخل «اسم المتغير» (مثل service). في كل دورة يُكتب عنصر تلك الدورة في هذا المتغير.
3. اربط الخطوات التي تعمل لكل عنصر بمخرج «لكل عنصر». واترك مخرج آخر خطوة في الفرع فارغًا: عند انتهاء الفرع يبدأ العنصر التالي. ويمكنك أيضًا ربط آخر خطوة بخطوة الحلقة بنفسك.
4. اربط الخطوة التي يُنتقل إليها بعد انتهاء العناصر بمخرج «عند الانتهاء».

مصدر العناصر

• «قائمة في متغير»: اكتب في «القائمة» متغير قائمة: إجابة اختيار متعدد، أو قائمة أداة أو إجراء، أو نتيجة «تعديل قائمة».
• «عناصر تكتبها»: كل سطر دورة واحدة، وتضيف الأسطر بـ«إضافة عنصر». ويمكن أن تتضمن الأسطر متغيرات.
• «نطاق أرقام»: «البداية» و«النهاية» و«الزيادة» (1 إن كانت فارغة). النهاية مشمولة، وللعدّ تنازليًا اكتب زيادة سالبة (-1). ويمكن أن تكون القيم متغيرات: {guests}.
• «تقسيم نص»: يُقسَّم «النص» عند «الفاصل»: «فاصلة» أو «فاصلة منقوطة» أو «كل سطر» أو «خط عمودي (|)» أو «غير ذلك» (حرف تختاره). كل جزء دورة واحدة، وتُتجاوز الأجزاء الفارغة. ويزيل «إزالة المسافات» المسافات في بداية كل جزء ونهايته.

المتغيرات التي تُكتب في كل دورة

إن كان اسم المتغير service فتُكتب في كل دورة: {service} العنصر، و{service.field} حقل من العنصر، و{service_index} رقم الدورة، و{service_total} عدد العناصر، و{service_last} هل هي الدورة الأخيرة (true/false). وتُحذف هذه المتغيرات عند انتهاء الحلقة. ويحدد «يبدأ العدّاد من» قيمة {service_index} في الدورة الأولى (1 افتراضيًا)، و«أقصى عدد للدورات» أكبر عدد من العناصر يُعالَج؛ ولا يوجد هذان الإعدادان في نطاق الأرقام.

الدورات وخطوات الفرع

تعمل الحلقة 100 دورة على الأكثر، ولا يُعالَج ما زاد من قائمة أطول. وإن كانت القائمة فارغة ينتقل الوكيل مباشرة إلى «عند الانتهاء». وإذا ربطت خطوة في الفرع بخطوة بعد «عند الانتهاء» يخرج الوكيل من الحلقة مبكرًا، وخطوة «نهاية» في الفرع تُنهي المحادثة. ويمكن وضع حلقة داخل حلقة: إن كان مخرج «عند الانتهاء» في الحلقة الداخلية فارغًا تنتقل الحلقة الخارجية إلى عنصرها التالي.

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

مثال

في خطوة «اختيار» من نوع «متعدد» حدّد الزائر الخدمات التي تهمه، والإجابة في {services}. في الحلقة: «مصدر العناصر» هو «قائمة في متغير»، و«القائمة» {services}، و«اسم المتغير» service. ترسل خطوة «إجراء تكامل» على مخرج «لكل عنصر» إشعارًا منفصلًا إلى فريقك لكل خدمة («طلب جديد لـ{service}»)، ويذهب مخرج «عند الانتهاء» إلى «رسالة» شكر.

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

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

لا يُستخدم في اسم المتغير إلا الأحرف اللاتينية a–z والأرقام والشرطة السفلية (_)؛ وتسقط الأحرف العربية والأحرف ذات العلامات والمسافات أثناء الكتابة. والاسم «system» محجوز لمتغيرات النظام، فاختر اسمًا آخر.

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

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