كتابة رحلة
الخطوات، وجمل التشغيل، وكيف يعرف المساعد أن الخطوة انتهت.
للرحلة اسم (ما يسميها به المساعد بصوت مسموع)، وجملة تشغيل، وخطوات مرتبة. تكتبها في صفحة Journeys؛ ويستطيع وكيل برمجة متصل عبر MCP أيضًا كتابة مسودة لك — والمسودة لا تعمل أبدًا حتى تنشرها.
جملة التشغيل#
تُقارن جملة التشغيل بـ ما كتبه الزائر، لذا اكتب جملة، لا عنوان قائمة: *«عندما يريد الزائر إرجاع شيء اشتراه أو إعادته»*. عبارة اسمية مثل «المرتجعات» لا تطابق شيئًا تقريبًا.
كيف تنتهي الخطوة#
كل خطوة تحدد كيف نعرف أنها انتهت. هذه قائمة مغلقة — لا يوجد شرط بنص حر، لأن الشرط الذي لا يستطيع المحرك التحقق منه شرط لن يتحقق أبدًا دون أن يلاحظ أحد.
| تنتهي عندما | تحتاج إلى |
|---|---|
click_self | النقر على هدف الخطوة نفسه. |
visible / hidden | ظهور عنصر مستهدف أو اختفاؤه. |
filled | وجود قيمة في حقل مستهدف. |
url_change | تغيّر العنوان إلى شيء تحدده. |
settled | توقف هدف ما عن التغيّر. |
attempts | عدد من المحاولات. |
user_continue | ضغط الزائر على «متابعة». مطلوب لخطوات Hold. |
قاعدة: الخطوة التي تفتح صفحة يجب أن تنتهي بشيء تستطيع الصفحة إظهاره. فتح صفحة يُزيل السكربت ويعيد بناءه على الصفحة الجديدة، لذا فالحدث الذي كان سيقع — كالنقر — لا يمكن أن يصل أبدًا: وستفتح الخطوة الصفحة مجددًا مع كل تحميل. لهذا لا يعرض المحرر لخطوة «فتح صفحة» إلا url_change وvisible وfilled، ويرفض الخادم أي خطة تقول غير ذلك. ويوقف المحرك أيضًا الخطوة بعد عمليتي انتقال، فلا يمكن لخطة خاطئة أن تترك موقعك يعيد التحميل بلا نهاية.
وأمر آخر يفعله المحرك نيابة عنك: ينتظر ظهور هدف الخطوة (بضع ثوانٍ، مع التحقق المستمر) قبل أن يقرر أنه مفقود. الصفحة التي تعرض نموذجها بعد لحظة من التحميل أمر طبيعي، ولا ينبغي أن توقف رحلة.
النشر#
ما يُنشر هو إصدار محدد. تعديل رحلة منشورة يُخرجها من الخدمة، فلا يمكن أبدًا أن تعمل على موقعك خطة لم يوافق عليها أحد. اقرأ الخطوات، ثم انشر مجددًا.
نصيحة: معظم العمل في الرحلة هو تسمية العناصر الصحيحة في صفحتك. يجب أن يطابق هدف الخطوة عنصرًا واحدًا بالضبط — #country-select أو select[aria-label="Passport"] كلاهما مناسب إذا لم يطابقهما في الصفحة إلا عنصر واحد، بينما يُرفض button المجرد: فالمرجع الذي قد يعني أربعين شيئًا ليس مؤشرًا. إذا كان لديك وكيل برمجة متصل (راجع وكلاء البرمجة)، فيستطيع قراءة صفحاتك وكتابة مسودة الخطوات — وأنت تراجع وتنشر.