EventHandler

candidates: 
  - object (StaticPromptCandidate)

object (StaticPromptCandidate)

Lista promptów kandydujących, które mają zostać wysłane do klienta. Każdy prompt ma selektor, który określa, kiedy można go użyć. Zostanie wysłany pierwszy selektor pasujący do żądania, a pozostałe zostaną zignorowane.

selector: 
  object (Selector)
promptResponse: 
  object (StaticPromptResponse)

object (Selector)

Opcjonalnie: Kryteria, czy ten prompt pasuje do żądania. Jeśli selektor jest pusty, prośba zawsze będzie wywoływana.

object (StaticPromptResponse)

Odpowiedź na prompt powiązana z selektorem.

surfaceCapabilities: 
  object (SurfaceCapabilities)

object (SurfaceCapabilities)

Zbiór wymaganych możliwości powierzchni.

capabilities: 
  - enum (Capability)

enum (Capability)

Wymagane. Możliwości platformy wysyłającej żądanie do akcji.

firstSimple: 
  object (StaticSimplePrompt)
content: 
  object (StaticContentPrompt)
lastSimple: 
  object (StaticSimplePrompt)
suggestions: 
  - object (Suggestion)
link: 
  object (StaticLinkPrompt)
override: boolean
canvas: 
  object (StaticCanvasPrompt)

object (StaticSimplePrompt)

Opcjonalnie: Pierwsza odpowiedź głosowa i tekstowa.

object (StaticContentPrompt)

Opcjonalnie: Treści takie jak karta, lista lub multimedia do wyświetlenia użytkownikowi.

object (StaticSimplePrompt)

Opcjonalnie: Ostatnia odpowiedź głosowa i tekstowa.

object (Suggestion)

Opcjonalnie: Sugestie do wyświetlenia użytkownikowi, które zawsze będą pojawiać się na końcu odpowiedzi. Jeśli pole append w powiązanym promptie ma wartość true, tytuły zdefiniowane w tym polu zostaną dodane do tytułów zdefiniowanych we wszystkich wcześniej zdefiniowanych promptach sugestii, a zduplikowane wartości zostaną usunięte.

object (StaticLinkPrompt)

Opcjonalnie: Dodatkowy element z sugestią, który może prowadzić do powiązanej aplikacji lub witryny. Element zostanie wyrenderowany z tytułem „Otwórz ”. Maksymalnie 20 znaków.

boolean

Opcjonalnie: Tryb sposobu łączenia tych wiadomości z wiadomościami zdefiniowanymi wcześniej. Aplikacja true usunie wszystkie wcześniej zdefiniowane wiadomości (pierwsza i ostatnia prosta, treść, link z sugestiami oraz obszar roboczy) i doda wiadomości zdefiniowane w tym promptie. false doda wiadomości zdefiniowane w tym promptie do wiadomości zdefiniowanych w poprzednich odpowiedziach. Ustawienie tego pola na false umożliwia też dołączanie do niektórych pól w prostych promptach, w prompcie Sugestie i Canvas (część promptu Treść). Wiadomości z treścią i linkami zawsze zostaną zastąpione, jeśli zostaną zdefiniowane w prompcie. Wartość domyślna to false.

object (StaticCanvasPrompt)

Odpowiedź używana w przypadku interaktywnego obszaru roboczego.

variants: 
  - object (Variant)

object (Variant)

Lista możliwych wariantów.

speech: string
text: string

string

Opcjonalnie: Reprezentuje mowę, która ma zostać wypowiedziana użytkownikowi. Może to być SSML lub zamiana tekstu na mowę. Domyślnie mowa jest dołączana do mowy poprzedniego promptu prostego. Jeśli pole override w nowym promptie to true mowa zdefiniowana w tym polu zastąpi mowę poprzedniego prostego promptu.

string

Opcjonalnie: Tekst do wyświetlenia w dymku czatu. Jeśli wartość nie zostanie podana, będzie używane renderowanie powyższego pola mowy. Limit wynosi 640 znaków. Domyślnie tekst jest dołączany do tekstu poprzedniego prostego promptu. Jeśli pole override w nowym promptie ma wartość true, tekst zdefiniowany w tym polu zastąpi tekst poprzedniego prostego promptu.

# Union field content can be only one of the following:
card: 
  object (StaticCardPrompt)
image: 
  object (StaticImagePrompt)
table: 
  object (StaticTablePrompt)
media: 
  object (StaticMediaPrompt)
list: 
  object (StaticListPrompt)
collection: 
  object (StaticCollectionPrompt)
collectionBrowse: 
  object (StaticCollectionBrowsePrompt)
# End of list of possible types for union field content.

object (StaticCardPrompt)

karta podstawowa.

object (StaticImagePrompt)

Obraz.

object (StaticTablePrompt)

Karta tabeli.

object (StaticMediaPrompt)

Odpowiedź wskazująca zbiór multimediów do odtworzenia.

object (StaticListPrompt)

Karta zawierająca listę opcji do wyboru.

object (StaticCollectionPrompt)

Karta z listą opcji do wyboru.

object (StaticCollectionBrowsePrompt)

Karta przedstawiająca zbiór stron internetowych do otwarcia.

title: string
subtitle: string
text: string
image: 
  object (StaticImagePrompt)
imageFill: enum (ImageFill)
button: 
  object (StaticLinkPrompt)

string

Opcjonalnie: Ogólny tytuł karty.

string

Opcjonalnie: Podtytuł karty.

string

Wymagane. Tekst karty. Potrzebny jest ten tekst, o ile nie ma zdjęcia. Obsługuje ograniczony zestaw składni formatowania Markdown na potrzeby formatowania.

object (StaticImagePrompt)

Opcjonalnie: Baner powitalny karty. Wysokość jest stała na 192 dp.

enum (ImageFill)

Opcjonalnie: Sposób wypełniania tła obrazu.

object (StaticLinkPrompt)

Opcjonalnie: Klikalny przycisk wyświetlany na karcie.

url: string
alt: string
height: integer
width: integer

string

Wymagane. Źródłowy adres URL obrazu. Obrazy mogą być w formacie JPG, PNG lub GIF (animowane lub nieanimowane). Na przykład: https://www.agentx.com/logo.png.

string

Wymagane. Opis tekstowy obrazu, który ma być używany na potrzeby ułatwień dostępu, np. przez czytniki ekranu.

integer

Opcjonalnie: Wysokość obrazu w pikselach.

integer

Opcjonalnie: Szerokość obrazu w pikselach.

name: string
open: 
  object (OpenUrl)

string

Nazwa linku

object (OpenUrl)

Określa, co się stanie, gdy użytkownik otworzy link.

url: string
hint: enum (UrlHint)

string

Pole adresu URL, którym może być dowolny z tych elementów: – adresy URL http/https służące do otwierania aplikacji powiązanej z aplikacją lub strony internetowej

enum (UrlHint)

Wskazuje wskazówkę dotyczącą typu adresu URL.

title: string
subtitle: string
image: 
  object (StaticImagePrompt)
columns: 
  - object (TableColumn)
rows: 
  - object (TableRow)
button: 
  object (StaticLinkPrompt)

string

Opcjonalnie: Ogólny tytuł tabeli. Ta opcja jest wymagana, jeśli ustawiono podtytuł.

string

Opcjonalnie: Podtytuł tabeli.

object (StaticImagePrompt)

Opcjonalnie: Obraz powiązany z tabelą.

object (TableColumn)

Opcjonalnie: Nagłówki i wyrównanie kolumn.

object (TableRow)

Opcjonalnie: Dane wiersza tabeli. Pierwsze 3 wiersze na pewno się wyświetlą, ale inne mogą zostać wycięte na niektórych platformach. Przetestuj za pomocą symulatora, które wiersze będą wyświetlane dla danej platformy. Na platformach obsługujących funkcję WEB_BROWSER możesz kierować użytkowników na stronę internetową z dodatkowymi danymi.

object (StaticLinkPrompt)

Opcjonalnie: Przycisk.

header: string
align: enum (HorizontalAlignment)

string

Tekst nagłówka kolumny.

enum (HorizontalAlignment)

Wyrównanie w poziomie kolumny z treściami. Jeśli nie określono inaczej, treść zostanie wyrównana do krawędzi początkowej.

cells: 
  - object (TableCell)
divider: boolean

object (TableCell)

Komórki w tym wierszu. Pierwsze 3 komórki są wyświetlane, ale inne mogą zostać wycięte na niektórych platformach. Przetestuj za pomocą symulatora, które komórki zostaną wyświetlone na danej powierzchni.

boolean

Wskazuje, czy po każdym wierszu powinien być separator.

text: string

string

Zawartość tekstowa komórki.

mediaType: enum (MediaType)
startOffset: string
optionalMediaControls: 
  - enum (OptionalMediaControls)
mediaObjects: 
  - object (MediaObject)
repeatMode: enum (RepeatMode)

enum (MediaType)

Typ multimediów w tej odpowiedzi.

string (Duration format)

Odsunięcie pierwszego obiektu multimedialnego.

Czas trwania w sekundach z maksymalnie dziewięcioma cyframi po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

enum (OptionalMediaControls)

Opcjonalne typy elementów sterujących multimediami, które obsługuje ta sesja odpowiedzi na multimedia. Jeśli jest ustawione, żądanie jest przekazywane do firm zewnętrznych, gdy wystąpi określone zdarzenie multimedialne. Jeśli nie jest ustawiona, firma zewnętrzna musi nadal obsługiwać 2 domyślne typy ustawień: ZAKOŃCZONO i NIEPOWODZENIE.

object (MediaObject)

Lista obiektów multimedialnych.

enum (RepeatMode)

Tryb powtarzania w przypadku listy obiektów multimediów.

name: string
description: string
url: string
image: 
  object (MediaImage)

string

Nazwa tego obiektu multimedialnego.

string

Opis tego obiektu multimedialnego.

string

Adres URL wskazujący treści multimedialne.

object (MediaImage)

Obraz wyświetlany z kartą multimediów.

# Union field image can be only one of the following:
large: 
  object (StaticImagePrompt)
icon: 
  object (StaticImagePrompt)
# End of list of possible types for union field image.

object (StaticImagePrompt)

Duże zdjęcie, np. okładka albumu itp.

object (StaticImagePrompt)

Mała ikona obrazu wyświetlana po prawej stronie tytułu. Został zmniejszony do rozmiaru 36 x 36 dp.

title: string
subtitle: string
items: 
  - object (ListItem)

string

Opcjonalnie: Tytuł listy.

string

Opcjonalnie: Podtytuł listy.

object (ListItem)

Wymagane. Pozycje listy.

key: string
title: string
description: string
image: 
  object (StaticImagePrompt)

string

Wymagane. Klucz NLU zgodny z nazwą klucza wpisu w powiązanym typie. Po kliknięciu elementu ten klucz zostanie wysłany z powrotem jako parametr wyboru opcji.

string

Wymagane. Tytuł produktu. Po kliknięciu tekst zostanie opublikowany z powrotem w rozmowie dosłownie tak, jakby to użytkownik napisał go. Każdy tytuł musi być niepowtarzalny w obrębie zestawu elementów.

string

Opcjonalnie: Tekst główny elementu.

object (StaticImagePrompt)

Opcjonalnie: Obraz elementu.

title: string
subtitle: string
items: 
  - object (CollectionItem)
imageFill: enum (ImageFill)

string

Opcjonalnie: Tytuł kolekcji.

string

Opcjonalnie: Podtytuł kolekcji.

object (CollectionItem)

Wymagane. Elementy kolekcji.

enum (ImageFill)

Opcjonalnie: Typ opcji wyświetlania obrazu.

key: string
title: string
description: string
image: 
  object (StaticImagePrompt)

string

Wymagane. Klucz NLU zgodny z nazwą klucza wpisu w powiązanym typie Type. Po kliknięciu elementu ten klucz zostanie wysłany z powrotem jako parametr wyboru opcji.

string

Wymagane. Tytuł produktu. Po kliknięciu tekst zostanie opublikowany z powrotem w rozmowie dosłownie tak, jakby to użytkownik napisał go. Każdy tytuł musi być niepowtarzalny w obrębie zestawu elementów.

string

Opcjonalnie: Tekst główny elementu.

object (StaticImagePrompt)

Opcjonalnie: Obraz elementu.

items: 
  - object (CollectionBrowseItem)
imageFill: enum (ImageFill)

object (CollectionBrowseItem)

Elementy w kolekcji Przeglądaj. Rozmiar listy powinien mieścić się w zakresie [2, 10].

enum (ImageFill)

Opcja wyświetlania obrazów w kolekcji.

title: string
description: string
footer: string
image: 
  object (StaticImagePrompt)
openUriAction: 
  object (OpenUrl)

string

Wymagane. Tytuł elementu kolekcji.

string

Opis elementu kolekcji.

string

Tekst stopki elementu kolekcji wyświetlany pod opisem. Pojedynczy wiersz tekstu obcięty wielokropkiem.

object (StaticImagePrompt)

Obraz elementu kolekcji.

object (OpenUrl)

Wymagane. Identyfikator URI do otworzenia po wybraniu elementu.

title: string

string

Wymagane. Tekst widoczny w elemencie z sugestią. Po kliknięciu tekst zostanie opublikowany z powrotem w rozmowie dosłownie tak, jakby to użytkownik napisał go. Każdy tytuł musi być niepowtarzalny w zestawie elementów z sugestią. Maks. 25 znaków

url: string
data: 
  - value
suppressMic: boolean
sendStateDataToCanvasApp: boolean
enableFullScreen: boolean
continueTtsDuringTouch: boolean

string

Wymagane. Adres URL widoku internetowego do wczytania.

value (Value format)

Opcjonalnie: Dane JSON przekazywane na stronę internetową środowiska immersyjnego jako zdarzenie. Jeśli pole override w promptie zawiera wartości false zdefiniowane w tym promptie Canvas, zostaną dodane po wartościach danych zdefiniowanych w poprzednich promptach Canvas.

boolean

Opcjonalnie: Wartość prawda oznacza, że mikrofon nie włączy się do rejestrowania danych wejściowych po przedstawieniu użytkownikowi tej szczegółowej odpowiedzi.

boolean

Opcjonalnie: Jeśli true, metadane dotyczące rozmowy są dołączane i odsyłane z powrotem do aplikacji Canvas.

boolean

Opcjonalnie: Jeśli true, aplikacja Canvas zajmuje pełny ekran i nie ma nagłówka na górze. Na ekranie wczytywania pojawi się też komunikat z wyświetlaną nazwą akcji, nazwą dewelopera i instrukcjami zamknięcia akcji. Wartość domyślna: false.

boolean

Opcjonalnie: Jeśli wybrano opcję prawda, dotknięcia ekranu nie zatrzymują zamiany tekstu na mowę przez całą sesję Canvas. Wartość domyślna: false.