- YAML temsili
- StaticPrompt
- StaticPromptCandidate
- Seçici
- SurfaceCapabilities
- StaticPromptResponse
- StaticSimplePrompt
- Varyant
- StaticContentPrompt
- StaticCardPrompt
- StaticImagePrompt
- StaticLinkPrompt
- OpenUrl
- StaticTablePrompt
- TableColumn
- TableRow
- TableCell
- StaticMediaPrompt
- MediaObject
- MediaImage
- StaticListPrompt
- ListItem
- StaticCollectionPrompt:
- CollectionItem
- StaticCollectionBrowsePrompt
- CollectionBrowseItem
- Öneri
- StaticCanvasPrompt
Bir etkinlikten sonra yürütülecek bir işleyici tanımlar. Etkinliklere örnek olarak, bir sahnedeki amaç ve koşula dayalı etkinlikler verilebilir.
YAML temsili | |
---|---|
webhookHandler: string # Union field |
Alanlar | ||
---|---|---|
webhookHandler |
Çağrılacak webhook işleyicinin adı. |
|
prompt alanı. İstemler satır içine alınabilir veya ada göre referans gösterilebilir. prompt şunlardan yalnızca biri olabilir: |
||
staticPrompt |
Satır içi statik istem. Paketlerdeki dize kaynaklarına referanslar içerebilir. |
|
staticPromptName |
Çağrılacak statik istemin adı. |
StaticPrompt
İstem adaylarının listesini temsil eder. Bunlardan biri kullanıcıya verilen yanıtta gösterilecek istem olarak seçilir. Bu mesaj yerelleştirilebilir.
YAML temsili | |
---|---|
candidates:
- object ( |
Alanlar | |
---|---|
candidates[] |
Müşteriye gönderilecek aday istemlerinin listesi. Her istemde, ne zaman kullanılabileceğini belirleyen bir seçici bulunur. Bir istekle eşleşen ilk seçici gönderilir ve geri kalanı yok sayılır. |
StaticPromptCandidate
Statik bir istem adayını temsil eder.
YAML temsili | |
---|---|
selector: object ( |
Alanlar | |
---|---|
selector |
İsteğe bağlı. Bu istemin bir istekle eşleşip eşleşmediğine ilişkin ölçütler. Seçici boşsa bu istem her zaman tetiklenir. |
promptResponse |
Seçiciyle ilişkili istem yanıtı. |
Seçici
İstemin bir istekle eşleşip eşleşmediğine ilişkin ölçütleri tanımlar.
YAML temsili | |
---|---|
surfaceCapabilities:
object ( |
Alanlar | |
---|---|
surfaceCapabilities |
Gerekli yüzey özellikleri grubu. |
SurfaceCapabilities
Kullanıcının işlem için istekte bulunmak üzere kullandığı yüzeyi temsil eder.
YAML temsili | |
---|---|
capabilities:
- enum ( |
Alanlar | |
---|---|
capabilities[] |
Zorunlu. İşlem'e istekte bulunan yüzeyin özellikleri. |
StaticPromptResponse
Kullanıcıya gönderilecek yapılandırılmış yanıtları (ör. metin, konuşma, kartlar, tuval verileri, öneri çipleri) temsil eder.
YAML temsili | |
---|---|
firstSimple: object ( |
Alanlar | |
---|---|
firstSimple |
İsteğe bağlı. İlk sesli ve yalnızca metin yanıtı. |
content |
İsteğe bağlı. Kullanıcıya gösterilecek kart, liste veya medya gibi bir içerik. |
lastSimple |
İsteğe bağlı. Sesli ve yalnızca metin içeren son yanıt. |
suggestions[] |
İsteğe bağlı. Öneriler her zaman yanıtın sonunda görünür ve kullanıcıya gösterilir. İçeren istemdeki |
link |
İsteğe bağlı. İlişkilendirilmiş uygulamaya veya siteye bağlantı verebilen ek bir öneri çipi. Çip, "Aç |
override |
İsteğe bağlı. Bu mesajların önceden tanımlanmış iletilerle nasıl birleştirileceğini belirleyen mod. |
canvas |
Etkileşimli tuval deneyimi için kullanılacak bir yanıt. |
StaticSimplePrompt
Kullanıcıya gönderilecek basit bir istemi temsil eder.
YAML temsili | |
---|---|
variants:
- object ( |
Alanlar | |
---|---|
variants[] |
Olası varyantların listesi. |
Varyant
Basit istemin parçası olan bir varyantı temsil eder.
YAML temsili | |
---|---|
speech: string text: string |
Alanlar | |
---|---|
speech |
İsteğe bağlı. Kullanıcıya konuşulacak konuşmayı temsil eder. SSML veya metin okuma olabilir. Varsayılan olarak konuşma, önceki Basit istemin konuşmasına eklenir. İçeren istemdeki |
text |
İsteğe bağlı. Sohbet balonunda gösterilecek metin. Sağlanmazsa yukarıdaki konuşma alanının bir ekran oluşturma işlemi kullanılır. Uzunluk sınırı 640 karakterdir. Metin, varsayılan olarak önceki Basit istemin metnine eklenir. İçeren istemdeki |
StaticContentPrompt
StaticPrompt'un İçerik bölümü için bir yer tutucu.
YAML temsili | |
---|---|
# Union field |
Alanlar | ||
---|---|---|
content alanı. İstemde yalnızca bir içerik türü bulunabilir. content şunlardan yalnızca biri olabilir: |
||
card |
Temel bir kart. |
|
image |
Bir resim. |
|
table |
Tablo kartı. |
|
media |
Oynatılacak medya grubunu belirten yanıt. |
|
list |
Aralarından seçim yapabileceğiniz seçeneklerin listesini sunan bir kart. |
|
collection |
Aralarından seçim yapabileceğiniz seçeneklerin listesini gösteren bir kart. |
|
collectionBrowse |
Açılacak web sayfaları koleksiyonunu gösteren bir kart. |
StaticCardPrompt
Bazı bilgileri (ör. resim ve/veya metin) gösteren temel bir kart.
YAML temsili | |
---|---|
title: string subtitle: string text: string image: object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Kartın genel başlığı. |
subtitle |
İsteğe bağlı. Kartın alt başlığı. |
text |
Zorunlu. Resim yoksa gereken kart gövde metni. Biçimlendirme için sınırlı bir Markdown söz dizimini destekler. |
image |
İsteğe bağlı. Kartın lokomotif resmi. Yükseklik 192 dp'ye sabitlenir. |
imageFill |
İsteğe bağlı. Resim arka planının nasıl doldurulacağı. |
button |
İsteğe bağlı. Kartta gösterilecek tıklanabilir bir düğme. |
StaticImagePrompt
Kartta gösterilen bir resim.
YAML temsili | |
---|---|
url: string alt: string height: integer width: integer |
Alanlar | |
---|---|
url |
Zorunlu. Resmin kaynak URL'si. Resimler JPG, PNG ve GIF (animasyonlu ve animasyonsuz) olabilir. Örneğin, |
alt |
Zorunlu. Erişilebilirlik için kullanılacak resmin metin açıklaması (ör. ekran okuyucular). |
height |
İsteğe bağlı. Resmin piksel cinsinden yüksekliği. |
width |
İsteğe bağlı. Resmin piksel cinsinden genişliği. |
StaticLinkPrompt
Öneri çipi olarak gösterilecek ve kullanıcı tarafından açılabilecek bir bağlantıyı tanımlar.
YAML temsili | |
---|---|
name: string
open:
object ( |
Alanlar | |
---|---|
name |
Bağlantının adı |
open |
Kullanıcı bağlantıyı açtığında nasıl davranacağını tanımlar. |
OpenUrl
Kullanıcı bağlantıyı açtığında nasıl davranacağını tanımlar.
YAML temsili | |
---|---|
url: string
hint: enum ( |
Alanlar | |
---|---|
url |
Şunlardan herhangi biri olabilecek URL alanı: - Uygulamayla Bağlantılı Uygulama veya web sayfası açmak için http/https URL'leri |
hint |
URL türüyle ilgili bir ipucu gösterir. |
StaticTablePrompt
Metin tablosunu gösteren tablo kartı.
YAML temsili | |
---|---|
title: string subtitle: string image: object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Tablonun genel başlığı. Altyazı ayarlanmışsa ayarlanmalıdır. |
subtitle |
İsteğe bağlı. Tablonun alt başlığı. |
image |
İsteğe bağlı. Tabloyla ilişkilendirilen resim. |
columns[] |
İsteğe bağlı. Başlıklar ve sütunların hizalaması. |
rows[] |
İsteğe bağlı. Tablonun satır verileri. İlk 3 satırın gösterilmesi garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzey için hangi satırların gösterileceğini görmek üzere lütfen simülatörle test yapın. |
button |
İsteğe bağlı. Düğme. |
TableColumn
Tablodaki bir sütunu açıklar.
YAML temsili | |
---|---|
header: string
align: enum ( |
Alanlar | |
---|---|
header |
Sütunun başlık metni. |
align |
İçeriğin sütunla yatay hizalaması. Belirtilmemişse içerik ön kenara hizalanır. |
TableRow
Tablodaki bir satırı açıklar.
YAML temsili | |
---|---|
cells:
- object ( |
Alanlar | |
---|---|
cells[] |
Bu satırdaki hücreler. İlk 3 hücrenin gösterilmesi garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzey için hangi hücrelerin gösterileceğini görmek üzere lütfen simülatörle test yapın. |
divider |
Her satırdan sonra ayırıcı olup olmadığını gösterir. |
TableCell
Bir satırdaki hücreyi açıklar.
YAML temsili | |
---|---|
text: string |
Alanlar | |
---|---|
text |
Hücrenin metin içeriği. |
StaticMediaPrompt
Medya hakkında ad, açıklama, url vb. bilgiler içerir. Sonraki kimlik: 11
YAML temsili | |
---|---|
mediaType: enum ( |
Alanlar | |
---|---|
mediaType |
Bu yanıtın medya türü. |
startOffset |
İlk medya nesnesinin başlangıç ofseti. En fazla dokuz kesir basamağı içeren ve " |
optionalMediaControls[] |
Bu medya yanıt oturumunun destekleyebileceği isteğe bağlı medya denetimi türleri. Ayarlanırsa belirli bir medya etkinliği gerçekleştiğinde 3p'ye istek gönderilir. Ayarlanmazsa 3p yine de TAMAM ve BAŞARISIZ olmak üzere iki varsayılan kontrol türünü işlemelidir. |
mediaObjects[] |
Medya nesnelerinin listesi. |
repeatMode |
Medya Nesneleri listesi için modu tekrar edin. |
MediaObject
Tek bir medya nesnesini temsil eder.
YAML temsili | |
---|---|
name: string
description: string
url: string
image:
object ( |
Alanlar | |
---|---|
name |
Bu medya nesnesinin adı. |
description |
Bu medya nesnesinin açıklaması. |
url |
Medya içeriğini işaret eden URL. |
image |
Medya kartıyla birlikte gösterilecek resim. |
MediaImage
MediaPrompt içinde gösterilecek resim.
YAML temsili | |
---|---|
# Union field |
Alanlar | ||
---|---|---|
image alanı. Yalnızca bir MediaImage türüne izin verilir. image şunlardan yalnızca biri olabilir: |
||
large |
Albümün kapağı vb. büyük bir resim. |
|
icon |
Başlığın sağında gösterilen küçük resim simgesi. 36x36 dp olarak yeniden boyutlandırıldı. |
StaticListPrompt
Aralarından seçim yapabileceğiniz seçeneklerin listesini sunan bir kart.
YAML temsili | |
---|---|
title: string
subtitle: string
items:
- object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Listenin başlığı. |
subtitle |
İsteğe bağlı. Listenin alt başlığı. |
items[] |
Zorunlu. Liste öğeleri. |
ListItem
Listedeki bir öğe.
YAML temsili | |
---|---|
key: string
title: string
description: string
image:
object ( |
Alanlar | |
---|---|
key |
Zorunlu. İlişkili türdeki giriş anahtarı adıyla eşleşen NLU anahtarı. Öğeye dokunulduğunda bu anahtar seçim parametresi olarak geri gönderilir. |
title |
Zorunlu. Öğenin başlığı. Bu metine dokunulduğunda, kullanıcı yazmış gibi, görüşmede aynen geri gönderilir. Her başlık, öğe kümesi içinde benzersiz olmalıdır. |
description |
İsteğe bağlı. Öğenin gövde metni. |
image |
İsteğe bağlı. Öğe resmi. |
StaticCollectionPrompt
Aralarından seçim yapabileceğiniz bir dizi seçeneği sunan kart.
YAML temsili | |
---|---|
title: string subtitle: string items: - object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Koleksiyonun başlığı. |
subtitle |
İsteğe bağlı. Koleksiyonun alt başlığı. |
items[] |
Zorunlu. Koleksiyon öğeleri'ne dokunun. |
imageFill |
İsteğe bağlı. Resim görüntüleme seçeneğinin türü. |
CollectionItem
Koleksiyondaki bir öğe.
YAML temsili | |
---|---|
key: string
title: string
description: string
image:
object ( |
Alanlar | |
---|---|
key |
Zorunlu. İlişkili Tür'deki giriş anahtarı adıyla eşleşen NLU anahtarı. Öğeye dokunulduğunda bu anahtar seçim parametresi olarak geri gönderilir. |
title |
Zorunlu. Öğenin başlığı. Bu metine dokunulduğunda, kullanıcı yazmış gibi, görüşmede aynen geri gönderilir. Her başlık, öğe kümesi içinde benzersiz olmalıdır. |
description |
İsteğe bağlı. Öğenin gövde metni. |
image |
İsteğe bağlı. Öğe resmi. |
StaticCollectionBrowsePrompt
Bir dizi web dokümanı, büyük parçalardan oluşan bir koleksiyon olarak sunulur. Öğeler, ilişkili web dokümanını bir web görüntüleyicide başlatmak için seçilebilir.
YAML temsili | |
---|---|
items: - object ( |
Alanlar | |
---|---|
items[] |
Göz atma koleksiyonundaki öğeler. Liste boyutu [2, 10] aralığında olmalıdır. |
imageFill |
Koleksiyondaki resimler için resim görüntüleme seçeneği. |
CollectionBrowseItem
Öğe koleksiyonda.
YAML temsili | |
---|---|
title: string description: string footer: string image: object ( |
Alanlar | |
---|---|
title |
Zorunlu. Koleksiyon öğesinin başlığı. |
description |
Koleksiyon öğesinin açıklaması. |
footer |
Koleksiyon öğesinin açıklamanın altında görüntülenen altbilgi metni. Üç nokta ile kısaltılmış tek satırlık metin. |
image |
Koleksiyon öğesinin resmi. |
openUriAction |
Zorunlu. Öğe seçilmişse açılacak URI. |
Öneri
Bir öneri çipini temsil eder. Kolaylık sağlamak için kullanıcıya gösterilen bir kullanıcı arayüzü öğesidir.
YAML temsili | |
---|---|
title: string |
Alanlar | |
---|---|
title |
Zorunlu. Öneri çipinde gösterilen metin. Bu metine dokunulduğunda, kullanıcı yazmış gibi, görüşmede aynen geri gönderilir. Öneri çipi grubundaki her başlık benzersiz olmalıdır. Maks. 25 karakter |
StaticCanvasPrompt
Kullanıcıya gönderilecek Etkileşimli Tuval yanıtını temsil eder. Bu, kullanıcıyla konuşmak için yer alan istemdeki firstSimple
alanıyla birlikte kullanılabilir ve etkileşimli bir tuval yanıtı görüntüleyebilir.
YAML temsili | |
---|---|
url: string data: - value suppressMic: boolean sendStateDataToCanvasApp: boolean enableFullScreen: boolean continueTtsDuringTouch: boolean |
Alanlar | |
---|---|
url |
Zorunlu. Yüklenecek web görünümünün URL'si. |
data[] |
İsteğe bağlı. Kapsamlı deneyim web sayfasına etkinlik olarak aktarılacak JSON verileri. İçeren istemdeki |
suppressMic |
İsteğe bağlı. Doğru değeri, bu kapsamlı yanıt kullanıcıya sunulduktan sonra mikrofonun giriş yakalamak için açılmayacağı anlamına gelir. |
sendStateDataToCanvasApp |
İsteğe bağlı. |
enableFullScreen |
İsteğe bağlı. |
continueTtsDuringTouch |
İsteğe bağlı. Doğru değerine ayarlanırsa ekrana dokunmak tüm tuval oturumu boyunca TTS'yi durdurmaz. Varsayılan değer: false. |