Scene

Sahne, bir konuşma tasarlarken kontrol akışının temel birimidir. Bu sahneler diğer sahnelerle birleştirilebilir, 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ş yaparken ç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 sahnenin kapsamında olan amaçlar grubunu tanımlar ve aynı amaçlara veya tetikleme ifadelerine sahip olan ve genel olarak tanımlanmış tüm etkinliklere göre önceliklidir. Bir sahne içindeki amaç adları benzersiz olmalıdır.
conditionalEvents[]

object (ConditionalEvent)

Koşullu ifadelere göre tetiklenecek etkinliklerin listesi. Bu sahneler, form doldurulduktan sonra veya bu sahnede bir form yoksa (değerlendirme yalnızca bir kez yapılır) on_load olduktan hemen sonra değerlendirilir. Yalnızca eşleşen ilk etkinlik tetiklenir.
slots[]

object (Slot)

Sıralı aralık listesi. Her alan, çözümleyeceği veri türünü ve bu çözünürlük deneyimini (ör. istemler) özelleştirmek için yapılandırılacak verileri tanımlar.
onSlotUpdated

object (EventHandler)

İşleyici, başka bir İşleyici'deki güncellemelerden kaynaklanmayan bir alanın durumunda değişiklik olduğunda çağrıldı. Bu, alanların geçersiz kılınmasına, sahnenin geçersiz kılınmasına veya sahne durumunda yapılan diğer değişikliklere izin verir.

Alan

Alan yapılandırması. Alanlar, doğal dil (ör. intent parametreleri), oturum parametreleri ve diğer kaynaklarla 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 alanın veri türünü tanımlar.
required

boolean

İsteğe bağlı. İlerlemeden önce alanın doldurulmasının gerekli olup olmadığını 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 ilişkili kaydetme davranışı.
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, alanın türüne göre belirlenir. Bu yapılandırmaya, kullanıcı veya oturum parametresine kaynak referansları eklenebilir. Bu yapılandırma, işlemler ve kullanıcı etkileşimiyle ilgili alanları doldurmak için gereklidir.

Örnek: actions.type.CompletePurchaseValue türündeki bir alan için aşağıdaki yapılandırma, istemci tanımlı userSelectedSkuId oturum parametresine referans vererek dijital iyi sipariş önerir:

{ "@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 değeri dolduracak yapılandırma.

PromptSettings

Alan 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)

Alan değerinin kendisi için istem girin. Örnek: "Hangi bedeni istemiştiniz?"
noMatchPrompt1

object (EventHandler)

Kullanıcının girişi, alan için beklenen değer türüyle ilk kez eşleşmediğinde komut istemi. Örnek: "Maalesef anlayamadım."
noMatchPrompt2

object (EventHandler)

Kullanıcının girişi, alan için beklenen değer türüyle ikinci kez eşleşmediğinde komut istemi. Örnek: "Maalesef anlayamadım."
noMatchFinalPrompt

object (EventHandler)

Kullanıcının girişi, alan için son kez beklenen değer türüyle eşleşmediğinde komut istemi. Örnek: "Maalesef anlayamadım."
noInputPrompt1

object (EventHandler)

Kullanıcı ilk kez giriş sağlamadığında komut istemi. Örnek: "Maalesef anlayamadım."
noInputPrompt2

object (EventHandler)

Kullanıcı ikinci kez giriş sağlamadığında komut istemi. Örnek: "Maalesef anlayamadım."
noInputFinalPrompt

object (EventHandler)

Kullanıcı son kez giriş sağlamadığında komut istemi. Örnek: "Maalesef anlayamadım."

CommitBehavior

Başarıyla doldurulduktan sonra alanla ilişkili kaydetme davranışını açıklayan mesaj.

YAML temsili 
writeSessionParam: string
Alanlar
writeSessionParam

string

Alan değeri doldurulduktan sonra yazılacak 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. Örnek: writeSessionParam = "meyve" "$session.params.fruit" değerine karşılık gelir. WriteSessionParam = "ticket" "$session.params.ticket" öğesine karşılık gelir.

DefaultValue

Bu alan için varsayılan değeri dolduracak yapılandırma.

YAML temsili 
sessionParam: string
constant: value
Alanlar
sessionParam

string

İsteğe bağlı. Alan değerini başlatmak için kullanılacak oturum parametresi (boş olmayan bir değer içeriyorsa). 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 seçenek yalnızca bu alan için bir değer sessionParam aracılığıyla doldurulmamışsa kullanılır. Bu değerin türü, alanın türüyle eşleşmelidir.