# Yolculuk yazmak

> Yolculuklar · Adımlar, tetikleyici cümle ve bir adımın bittiğini nereden anlıyoruz.

Bir yolculuğun **adı** (asistanın yüksek sesle söylediği ad), bir **tetikleyici cümlesi** ve sırayla **adımları** vardır. Yolculuklar sayfasından yazarsınız; MCP ile bağlı bir kod ajanı da sizin için taslak çıkarabilir — taslak, siz yayına almadan çalışmaz.

## Tetikleyici cümle

Tetikleyici, **ziyaretçinin yazdığıyla** karşılaştırılır; o yüzden menü etiketi değil cümle yazın: *"ziyaretçi satın aldığı bir şeyi iade etmek ya da geri göndermek istediğinde"*. "İadeler" gibi bir isim cümlesi neredeyse hiçbir şeye eşleşmez.

## Bir adım nasıl biter

Her adım, bittiğini nereden anlayacağımızı söyler. Bu kapalı bir listedir — serbest metinle koşul yazılmaz, çünkü motorun kontrol edemediği bir koşul sessizce hiç gerçekleşmeyen bir koşuldur.

| Bitiş | Gereken |
| --- | --- |
| `click_self` | Adımın kendi hedefine tıklandı. |
| `visible` / `hidden` | Bir hedef göründü ya da kayboldu. |
| `filled` | Bir hedef alan dolduruldu. |
| `url_change` | Adres, söylediğiniz bir şeye dönüştü. |
| `settled` | Bir hedef değişmeyi bıraktı. |
| `attempts` | Belirli sayıda deneme. |
| `user_continue` | Ziyaretçi Devam'a bastı. Çekilme adımlarında zorunlu. |

> **Kural:** **Sayfa açan bir adım, sayfanın gösterebileceği bir şeyle bitmek zorunda.** Sayfayı açmak script'i koparıp yeni sayfada yeniden kuruyor; olacak olan bir olay — bir tıklama — hiç gelemez ve adım her yüklemede sayfayı yeniden açar. Bu yüzden editör "sayfa aç" adımında yalnız `url_change`, `visible` ve `filled` sunuyor, sunucu da aksini söyleyen bir planı reddediyor. Motor ayrıca bir adımı iki gezinmeden sonra durduruyor: yanlış bir plan sitenizi asla durmadan yenileyemez.

Motorun sizin adınıza yaptığı bir şey daha: bir adımın hedefini, yok saymadan önce **bekliyor** (birkaç saniye, sürekli yoklayarak). Formunu yüklendikten bir an sonra çizen bir sayfa normaldir ve bir yolculuğu durdurmamalı.

## Yayına almak

Yayına alınan şey **belirli bir versiyondur**. Yayındaki bir yolculuğu düzenlemek onu yayından düşürür; böylece kimsenin onaylamadığı bir plan sitenizde çalışamaz. Adımları okuyun, sonra yeniden yayına alın.

> **İpucu:** Bir yolculuktaki işin çoğu, sayfanızdaki doğru öğeleri adlandırmaktır. Bir adımın hedefi **tam olarak bir** öğeyle eşleşmek zorunda — `#ulke-secimi` ya da `select[aria-label="Pasaport"]` ikisi de olur, yeter ki sayfada o tanıma yalnız bir şey karşılık versin; çıplak bir `button` ise reddedilir: kırk şeyi gösterebilen bir referans işaretçi değildir. Bağlı bir kod ajanınız varsa (bkz. **Kod ajanları**) sayfalarınızı okuyup adımları taslak olarak yazabilir; siz gözden geçirip yayına alırsınız.

---

Bu sayfayı web'de okuyun: [Yolculuk yazmak](/tr/docs/journeys/writing-a-journey)
