Dokümanlar · 🧭 Yolculuklar

Yolculuk yazmak

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_selfAdımın kendi hedefine tıklandı.
visible / hiddenBir hedef göründü ya da kayboldu.
filledBir hedef alan dolduruldu.
url_changeAdres, söylediğiniz bir şeye dönüştü.
settledBir hedef değişmeyi bıraktı.
attemptsBelirli sayıda deneme.
user_continueZiyaretç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.