الوثائق · 🧭 الرحلات

كيف تعمل الرحلة

من ينفذ، وما الذي يُسمح للمساعد برؤيته، وماذا يحدث عندما يتعذّر تنفيذ خطوة.

عندما يطلب الزائر شيئًا تغطيه رحلة، يبدؤها المساعد ثم يتراجع. ومن تلك اللحظة تُنفَّذ الخطوات بواسطة محرك يعمل على صفحتك أنت، دون أي نموذج ذكاء اصطناعي في الحلقة. المساعد يروي؛ لا يقود.

ما الذي يُعطى للمساعد#

يتلقى المساعد شيئين عن الرحلة: اسمها وجملة التشغيل الخاصة بها. الخطوات، والعناصر التي تشير إليها، لا تُرسل إليه أبدًا — لا قبل، ولا أثناء، ولا بعد.

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

ما الذي يراه الزائر#

بطاقة صغيرة في الدردشة توضح أي خطوة تعمل ومن أصل كم.
في خطوة Guide، تعليمات ليفعل ذلك بنفسه، مع الإشارة إلى العنصر الصحيح في الصفحة.
في خطوة Hold، زر Continue (متابعة) — لا يتحرك شيء حتى يضغطه.
طريقة لإيقاف كل شيء، في أي خطوة، دون مغادرة الدردشة.

عندما يتعذّر تنفيذ خطوة#

قبل كل إجراء، يتحقق المحرك من العنصر الذي سيلمسه: هل هو موجود فعلًا في الصفحة، وهل هو مرئي، وهل يقبل التفاعل، وهل يعود إلى العنصر نفسه الذي وُصف له. إذا فشل أي من ذلك تُسقط الخطوة — ولا تُجرَّب. الخطوة التي لا يتأكد منها المحرك خطوة لا ينفذها.

إذا أُسقطت الخطوة نفسها ثلاث مرات متتالية، تتوقف الرحلة وتذكر السبب. ثم يستأنف المساعد المحادثة بشكل طبيعي. الصفحة التي تغيّرت أثناء الرحلة تنهيها بلطف؛ ولا تترك الزائر يشاهد شيئًا يعيد المحاولة من تلقاء نفسه.

كيف تنتهي#

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

أين تعمل#

لوحة الدردشة موجودة في إطار منفصل على نطاقنا؛ والمحرك يعمل على صفحتك. أربعة أشياء فقط تعبر هذا الحد: الخطة المراد تنفيذها، و*متابعة*، و*إيقاف*، وأي خطوة وصلت إلى أين. هوية الزائر، وجلسته، ونص المحادثة تبقى من جهتنا ولا تدخل صفحتك أبدًا.

نصيحة: في مشروع بلا رحلات لا يُنزَّل المحرك أصلًا — لا طلب إضافي، ولا شيء يُضاف إلى صفحتك.

الرحلة لا تبدأ أبدًا.

إما أن الميزة غير مفعّلة للمشروع — تحقق في صفحة Journeys من متطلب لم يعد مستوفى — أو أن جملة التشغيل لا تشبه ما كتبه الزائر. تُقارن جمل التشغيل بجمل حقيقية، لا بعناوين القوائم.

تتوقف في المنتصف.

لم تجد خطوة ما طُلب منها النقر عليه، ثلاث مرات. وهذا يعني عادة أن الصفحة تغيّرت: عنصر أُعيدت تسميته، أو نُقل، أو أصبح يظهر فقط بعد شيء آخر. افتح الرحلة، وأصلح تلك الخطوة، وانشرها مجددًا.

إنها تنتظر ولا يحدث شيء.

إنها في خطوة Hold أو Guide، وهذا بالضبط المكان الذي يُفترض أن تنتظر فيه الزائر. تنتهي هذه الخطوات عندما يتصرف الزائر أو يضغط «متابعة» — لا من تلقاء نفسها أبدًا.