Sahne, bir konuşma tasarlarken kullanabileceğiniz temel kontrol akışının birimidir. Bunlar diğer sahnelerle birbirine bağlanabilir, son kullanıcı için istemler oluşturabilir ve alanları tanımlayabilir. Sahne adı, dosyanın adında belirtilir.
YAML temsili | |
---|---|
onEnter: object ( |
Alanlar | |
---|---|
onEnter |
Bu sahneye geçiş sırasında çağrılacak işleyici. |
intentEvents[] |
Amaçlara göre tetiklenen etkinliklerin listesi. Bu etkinlikler, on_load İşleyicisi çağrıldıktan sonra herhangi bir zamanda tetiklenebilir. Önemli: Bu etkinlikler, bu sahne kapsamındaki amaçlar grubunu tanımlar ve aynı amaçlara veya tetikleyici ifadelerine sahip, dünya genelinde tanımlanmış tüm etkinliklere göre önceliklidir. Amaç adları bir sahne içinde benzersiz olmalıdır. |
conditionalEvents[] |
Koşullu ifadelere göre tetiklenecek etkinliklerin listesi. Bunlar, form doldurulduktan sonra veya bu sahnenin formu yoksa on_load sonrasında değerlendirilir (değerlendirme yalnızca bir kez yapılır). Yalnızca eşleşen ilk etkinlik tetiklenir. |
slots[] |
Sıralı slot listesi. Her alan, çözeceği veri türünü ve bu çözünürlük deneyimini özelleştirmek için yapılandırmayı tanımlar (ör. istemler). |
onSlotUpdated |
Başka bir İşleyici içindeki güncellemelerden kaynaklanmayan bir slot durumunda değişiklik olduğunda işleyici çağrılır. Bu, aralıkların geçersiz kılınmasına, sahnenin geçersiz kılınmasına veya sahne durumunda diğer değişikliklerin yapılmasına izin verir. |
Alan
Bir slot için yapılandırma. Slot'lar; doğal dil (ör. amaç parametreleri), oturum parametreleri ve diğer kaynaklar üzerinden doldurulabilen tek veri birimleridir.
YAML temsili | |
---|---|
name: string type: object ( |
Alanlar | |
---|---|
name |
Zorunlu. Alanın adı. |
type |
Zorunlu. Bu slotun veri türünü tanımlar. |
required |
İsteğe bağlı. İlerlemeden önce alanın doldurulmasının gerekip gerekmediğini gösterir. Doldurulmayan gerekli alanlar, kullanıcı için özelleştirilebilir bir istemi tetikler. |
promptSettings |
İsteğe bağlı. Slot doldurmanın farklı aşamaları için istemleri kaydeder. |
commitBehavior |
İsteğe bağlı. Alanla ilgili davranışı gerçekleştirin. |
config |
İsteğe bağlı. Alanı doldurmak için kullanılan alanla ilişkilendirilmiş ek yapılandırma. Yapılandırmanın biçimi, slot türüne özeldir. Bu yapılandırmaya kullanıcı veya oturum parametresi için kaynak referansları eklenebilir. Bu yapılandırma, işlemler ve kullanıcı etkileşimi ile ilgili yuvaları doldurmak için gereklidir. Örnek: actions.type.CompletePurchaseValue türündeki bir slot için aşağıdaki yapılandırmada, istemci tarafından tanımlanan { "@type": "type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec", "skuId": { "skuType": "SKU_TYPE_IN_APP", "id": "$session.params.userSelectedSkuId", "packageName": "com.example.company" } } |
defaultValue |
İsteğe bağlı. Bu alan için varsayılan bir değer doldurulacak yapılandırma. |
PromptSettings
Slot istemlerinin tanımlandığı tek bir yer.
YAML temsili | |
---|---|
initialPrompt: object ( |
Alanlar | |
---|---|
initialPrompt |
Slot değerinin kendisini iste. Örnek: "Hangi boy istemiştiniz?" |
noMatchPrompt1 |
Kullanıcının girişi, slot için beklenen değer türüyle ilk kez eşleşmediğinde verilmesini sor. Örnek: "Maalesef anlayamadım." |
noMatchPrompt2 |
Kullanıcının girişi ikinci kez slot için beklenen değer türüyle eşleşmediğinde verilmesini iste. Örnek: "Maalesef anlayamadım." |
noMatchFinalPrompt |
Kullanıcının girişi son kez slot için beklenen değer türüyle eşleşmediğinde verilmesini iste. Örnek: "Maalesef anlayamadım." |
noInputPrompt1 |
Kullanıcı ilk kez giriş yapmadığında bilgi istemi. Örnek: "Maalesef anlayamadım." |
noInputPrompt2 |
Kullanıcı ikinci kez giriş yapmadığında bilgi istemi. Örnek: "Maalesef anlayamadım." |
noInputFinalPrompt |
Kullanıcı en son kez giriş sağlamadığında bilgi istemi. Örnek: "Maalesef anlayamadım." |
CommitBehavior
Alanla ilişkili kaydetme davranışının, alan başarıyla doldurulduktan sonra açıklandığı mesaj.
YAML temsili | |
---|---|
writeSessionParam: string |
Alanlar | |
---|---|
writeSessionParam |
Doldurulduktan sonra alan değerini yazacak oturum parametresi. İç içe yerleştirilmiş yolların şu anda desteklenmediğini unutmayın. "$$", alan değerini alanla aynı ada sahip bir oturum parametresine yazmak için kullanılır. Ör: writeSessionParam = "fruit", "$session.params.fruit"e karşılık gelir. writeSessionParam = "ticket", "$session.params.ticket"e karşılık gelir. |
DefaultValue
Bu alan için varsayılan bir değer doldurulacak yapılandırma.
YAML temsili | |
---|---|
sessionParam: string constant: value |
Alanlar | |
---|---|
sessionParam |
İsteğe bağlı. Boş olmayan bir değeri varsa slot değerini başlatmak için kullanılacak oturum parametresi. Değerin türü, alanın türüyle eşleşmelidir. İç içe yerleştirilmiş yolların şu anda desteklenmediğini unutmayın. Örnek: |
constant |
İsteğe bağlı. Alan için sabit varsayılan değer. Bu alan yalnızca bu alan için bir değer |