action_done
Geri alınabilir bir değişikliğin ne yaptığını belirten, Geri al düğmesi içeren tek bir satır.
Kullanıcınız istedi ve yapıldı: "INNER GOODNESS Yulaf Sütü 1L sepetinize eklendi · Geri al". Öncesinde dokunulacak bir onay kartı yok. Kendisini geri alan aksiyonu (undo) belirten bir aksiyon, doğrudan çalışabilen bir write aksiyonudur ve sunucu yanıtta confirm_card yerine bu satırı çizer. Sepete ekleme, takip etme ya da kaydetme gibi kullanıcının her seferinde onaylamak istemeyeceği ve tek dokunuşla geri alabileceği değişiklikler için uygundur.
Ekran görüntüsü değildir; tarayıcınızda SDK'nın kendi boyut ve renkleriyle canlı olarak çizilir.
Flutter SDK ile 0.69.0 ve Web SDK ile 0.46.0 sürümünden itibaren yerel olarak render edilir. Bu desteği bildirmeyen bir derlemeye asla gönderilmez; yazma aksiyonlarında onay kartı kullanılmaya devam eder.
Ne zaman çizilir
Yalnızca sunucu tarafından çizilir, model tarafından asla çizilmez. Bu bloğu çizen bir derlemede, aynı turda tersi sunulan ve undo tanımlı bir write aksiyonu kart olmadan çalışır. Geri alınamaz bir aksiyon her zaman onay ister. undo tanımı olmayan bir yazma aksiyonu da her zaman onay ister. undo tanımı olan bir aksiyonda kartı tutmak isterseniz, kodunuzda veya konsolda Aksiyonlar › ilgili aksiyon › Güvenlik adımı altından confirm: "always" değerini belirleyebilirsiniz.
Bu satır, modelin kullanıcının dilinde ne gerçekleştiğini anlatan cümlesidir ve tüm kartlarla aynı kurala tabidir: İçindeki herhangi bir sayı mutlaka aksiyonlarınızın döndürdüğü bir sayı olmalıdır. Böyle bir sayı yoksa confirmTemplate şablonunuz kullanılır.
Props
Her blok ayrıca type alanını ve 1 ila 300 karakter uzunluğunda zorunlu bir fallback_text alanını içerir.
| Prop | Tür | Zorunlu | Kısıtlamalar |
|---|---|---|---|
invocation_id | string | Evet | Sunucu tarafından atanır: Geri al işleminin geri aldığı çağrı. |
action_name | string | Evet | Çalıştırılan kayıtlı aksiyon. |
text | string | Evet | 1 to 200 characters. The model's line about what happened, held to the numbers your actions returned; your confirmTemplate without one. |
undo_until | string | Hayır | ISO 8601 in UTC (...Z); a numeric offset fails validation. Ten minutes after the action ran. Past it the SDK hides Undo, and the server refuses it. |
undone | boolean | Hayır | İşlem geri alındığında kayıtlı blokta ayarlanır; böylece geri yüklenen bir yazışmada durum bu şekilde görünür. |
Ağ aktarımı
{
"id": "blk_14",
"type": "action_done",
"fallback_text": "Added INNER GOODNESS Oat Milk 1L to your cart",
"props": {
"invocation_id": "inv_3c90",
"action_name": "add_to_cart",
"text": "Added INNER GOODNESS Oat Milk 1L to your cart",
"undo_until": "2026-10-29T10:10:00.000Z"
}
}Etkileşim
Geri al düğmesine kaç kez dokunulursa dokunulsun, POST /v1/invocations/:id/undo üzerinden ters aksiyonu yalnızca bir kez çalıştırır. Sunucu isteği üstlenir; ardından bir konsol aksiyonunun tersini kendisi çalıştırır ya da SDK'ya işleyicisiyle çalıştırması için iletir ve satırda "Geri alındı" ifadesi görünür. Başarısız olan bir geri alma işlemi bunu belirtir ve tekrar denenebilir. Geri al seçeneği, aksiyon çalıştıktan sonra on dakika boyunca sunulur; ekranda ne görünürse görünsün, bu süreden sonra sunucu işlemi reddeder.
Erişilebilirlik
Bir durum satırıdır: Ekranda belirdiğinde ve ardından "Geri alındı" dediğinde seslendirilir.