Dokümanlar · 🧭 Yolculuklar

Yolculuk çalışırken ne oluyor

Kim hareket ediyor, asistanın görmesine ne izin var ve bir adım yapılamazsa ne oluyor.

Ziyaretçi bir yolculuğun kapsadığı şeyi istediğinde asistan yolculuğu başlatır ve kenara çekilir. O andan sonra adımları sizin sayfanızda çalışan bir motor yürütür; arada model yoktur. Asistan anlatır, sürmez.

Asistana ne veriliyor#

Asistan bir yolculuk hakkında iki şey görür: adı ve tetikleyici cümlesi. Adımlar ve o adımların işaret ettiği öğeler ona hiç gönderilmez — ne öncesinde, ne sırasında, ne sonrasında.

Kural: *"Kimsenin yazmadığı bir adımı asla atmaz"* cümlesinin bir niyet değil bir olgu olmasının sebebi budur. Modele ulaşan bir öğe adı, modelin bir varyantını üretebileceği bir öğe adıdır. Modele hiç ulaşmıyor, dolayısıyla üretilecek bir varyant da yok.

Ziyaretçi ne görüyor#

Sohbette küçük bir kart: kaç adımdan hangisinin çalıştığını gösterir.
Guide adımında "bu adımı siz yapın" der ve sayfada doğru yeri işaret eder.
Hold adımında bir Devam düğmesi bekler — ziyaretçi basmadan hiçbir şey ilerlemez.
Her adımda, sohbetten çıkmadan yolculuğu durdurma imkânı.

Bir adım yapılamazsa#

Motor her eylemden önce dokunacağı öğeyi kontrol eder: sayfada gerçekten var mı, görünür mü, etkileşimli mi ve kendisine tarif edilen öğeye geri çözümleniyor mu. Bunlardan biri sağlanmıyorsa adım denenmez, düşürülür. Motorun emin olmadığı adım, yapmadığı adımdır.

Aynı adım üst üste üç kez düşerse yolculuk durur ve sebebini söyler. Sohbet normal şekilde asistanla devam eder. Altından sayfası değişmiş bir yolculuk kibarca biter; ziyaretçiyi kendi kendini tekrar deneyen bir şeyi izlerken bırakmaz.

Nasıl bitiyor#

Asistana sonuç yolculuk başına bir kez bildirilir, adım adım değil — ve ancak iş bittiğinde: tamamlandı ya da durduruldu. O mesaj gelene kadar hiçbir şeyin bittiğini söylemez, çünkü gerçekten bilmiyordur.

Nerede çalışıyor#

Sohbet paneli bizim alan adımızda ayrı bir çerçevede durur; motor sizin sayfanızda çalışır. O sınırdan yalnızca dört şey geçer: çalıştırılacak plan, *devam*, *durdur* ve hangi adımda olunduğu. Ziyaretçinin kim olduğu, oturumu ve konuşma metni bizim tarafta kalır, sayfanıza hiç girmez.

İpucu: Yolculukları açık olmayan bir projede motor hiç indirilmez — fazladan tek bir istek yok, sayfanıza eklenen hiçbir şey yok.

Yolculuk hiç başlamıyor.

Ya özellik o proje için etkin değildir — Yolculuklar sayfasından sonradan bozulmuş bir şartı kontrol edin — ya da tetikleyici cümle ziyaretçinin yazdığına benzemiyordur. Tetikleyiciler menü etiketleriyle değil, gerçek cümlelerle karşılaştırılır.

Ortada duruyor.

Bir adım tıklaması söylenen şeyi üst üste üç kez bulamamıştır. Bu genelde sayfanın değiştiği anlamına gelir: bir öğenin adı değişmiş, yeri kaymış ya da artık başka bir şeyden sonra görünüyordur. Yolculuğu açın, o adımı düzeltin, yeniden yayınlayın.

Bekliyor, hiçbir şey olmuyor.

Hold ya da guide adımındadır; orada beklemesi gerekir. Bu adımlar ziyaretçi hareket edince ya da Devam'a basınca biter — kendiliğinden asla.