Scene

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 (EventHandler)
intentEvents: 
  - object (IntentEvent)
conditionalEvents: 
  - object (ConditionalEvent)
slots: 
  - object (Slot)
onSlotUpdated: 
  object (EventHandler)
Alanlar
onEnter

object (EventHandler)

Bu sahneye geçiş sırasında çağrılacak işleyici.
intentEvents[]

object (IntentEvent)

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[]

object (ConditionalEvent)

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[]

object (Slot)

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

object (EventHandler)

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 (ClassReference)
required: boolean
promptSettings: 
  object (PromptSettings)
commitBehavior: 
  object (CommitBehavior)
config: value
defaultValue: 
  object (DefaultValue)
Alanlar
name

string

Zorunlu. Alanın adı.
type

object (ClassReference)

Zorunlu. Bu slotun veri türünü tanımlar.
required

boolean

İ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

object (PromptSettings)

İsteğe bağlı. Slot doldurmanın farklı aşamaları için istemleri kaydeder.
commitBehavior

object (CommitBehavior)

İsteğe bağlı. Alanla ilgili davranışı gerçekleştirin.
config

value (Value format)

İ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 userSelectedSkuId oturum parametresine referans içeren dijital bir sipariş teklifi sunulmaktadır:

{ "@type": "type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec", "skuId": { "skuType": "SKU_TYPE_IN_APP", "id": "$session.params.userSelectedSkuId", "packageName": "com.example.company" } }
defaultValue

object (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 (EventHandler)
noMatchPrompt1: 
  object (EventHandler)
noMatchPrompt2: 
  object (EventHandler)
noMatchFinalPrompt: 
  object (EventHandler)
noInputPrompt1: 
  object (EventHandler)
noInputPrompt2: 
  object (EventHandler)
noInputFinalPrompt: 
  object (EventHandler)
Alanlar
initialPrompt

object (EventHandler)

Slot değerinin kendisini iste. Örnek: "Hangi boy istemiştiniz?"
noMatchPrompt1

object (EventHandler)

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

object (EventHandler)

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

object (EventHandler)

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

object (EventHandler)

Kullanıcı ilk kez giriş yapmadığında bilgi istemi. Örnek: "Maalesef anlayamadım."
noInputPrompt2

object (EventHandler)

Kullanıcı ikinci kez giriş yapmadığında bilgi istemi. Örnek: "Maalesef anlayamadım."
noInputFinalPrompt

object (EventHandler)

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

string

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

string

İ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: sessionParam = "fruit", $session.params.fruit değerine karşılık gelir. sessionParam = "ticket", $session.params.ticket değerine karşılık gelir.
constant

value (Value format)

İsteğe bağlı. Alan için sabit varsayılan değer. Bu alan yalnızca bu alan için bir değer sessionParam aracılığıyla doldurulmadıysa kullanılır. Bu değerin türü, alanın türüyle eşleşmelidir.