كيف أُعدّ خطوة تعيين المتغيرات؟

ما فائدتها؟

تكتب خطوة «تعيين متغيرات» قيمة في متغير واحد أو أكثر. وإن أعطيت اسم متغير موجود تتغير قيمته. وتستخدم القيمة في الخطوات اللاحقة بصيغة {name}.

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

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

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

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

إعداد الخطوة

1. اكتب اسم المتغير في الحقل الأول تحت «التعيينات». يُقترح للتعيين الجديد اسم لا يستخدمه الوكيل؛ ويمكنك تغييره.
2. اختر نوع القيمة من القائمة بجانبه وأدخل القيمة تحته.
3. لمتغير آخر انقر «إضافة تعيين»، واحذف الزائد بزر الإغلاق في السطر («حذف التعيين»).

أنواع القيم

• «نص»: النص الذي تكتبه، ويمكن أن يتضمن متغيرات ({first_name} {last_name}). وإن تركته فارغًا يُفرَّغ المتغير.
• «عملية حسابية»: أرقام ومتغيرات و+ − × ÷ (أو * و/) وأقواس، مثل {total} * 1.2. يُنفَّذ الضرب والقسمة أولًا. والنتيجة رقم بمنزلتين عشريتين على الأكثر (12.5).
• «تاريخ»: يضيف مدة إلى تاريخ البداية، والوحدة يوم أو أسبوع أو شهر أو سنة. إن كان حقل البداية فارغًا (يظهر فيه «اليوم») يُستخدم تاريخ اليوم لدى الزائر، والمدة السالبة تعود إلى الوراء. النتيجة بصيغة 05.10.2026. والتاريخ الذي يتجاوز نهاية الشهر يُنقل إلى آخر يوم فيه: إضافة شهر إلى 31 يناير تعطي 28 (أو 29) فبراير.
• «ملخص قائمة»: يحوّل القائمة إلى قيمة واحدة. العملية هي «العدد» أو «المجموع» أو «المتوسط» أو «الأصغر» أو «الأكبر» أو «دمج»؛ ويكتب «دمج» القيم متجاورة مفصولة بفواصل. وفي غير «العدد» اكتب في الحقل المجاور حقل العنصر المراد استخدامه (مثل price)؛ وإن لم يُحدَّد حقل يُستخدم العنصر نفسه. وفي القائمة الفارغة يكون العدد والمجموع 0 والبقية فارغة.

تُطبَّق التعيينات بالترتيب، ويمكن للاحق أن يستخدم القيمة التي كتبها السابق. والقيمة التي لا يمكن حسابها (متغير ليس رقمًا، قسمة على صفر، بداية ليست تاريخًا) تُفرغ المتغير، فلا يتابع الوكيل بقيمة قديمة أو خاطئة.

مثال

في تسجيل فعالية ثلاثة تعيينات: total («عملية حسابية») {guests} * 25؛ وtotal_with_tax («عملية حسابية») {total} * 1.2؛ وdue_date («تاريخ»، بداية فارغة، 7 أيام). ثم يمكن لخطوة «رسالة» أن تقول: «المبلغ الإجمالي {total_with_tax}، وآخر موعد للدفع {due_date}.»

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

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

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

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