- Représentation YAML
- StaticPrompt
- StaticPromptCandidate
- Sélecteur
- SurfaceCapabilities
- StaticPromptResponse
- StaticSimplePrompt
- Variante
- StaticContentPrompt
- StaticCardPrompt
- StaticImagePrompt
- StaticLinkPrompt
- OpenUrl
- StaticTablePrompt
- TableColumn
- TableRow
- TableCell
- StaticMediaPrompt
- MediaObject
- MediaImage
- StaticListPrompt
- ListItem
- StaticCollectionPrompt
- CollectionItem
- StaticCollectionBrowsePrompt
- CollectionBrowseItem
- Suggestion
- StaticCanvasPrompt
Définit un gestionnaire à exécuter après un événement. Les événements basés sur un intent et une condition sont des exemples d'événements dans une scène.
Représentation YAML | |
---|---|
webhookHandler: string # Union field |
Champs | ||
---|---|---|
webhookHandler |
Nom du gestionnaire de webhook à appeler. |
|
Champ d'union prompt . Les requêtes peuvent être intégrées ou référencées par leur nom. prompt ne peut être qu'un des éléments suivants : |
||
staticPrompt |
Invite statique intégrée. Peut contenir des références à des ressources de chaîne dans des bundles. |
|
staticPromptName |
Nom de l'invite statique à appeler. |
StaticPrompt
Représente une liste d'invites candidates, dont l'une sera sélectionnée comme requête à afficher dans la réponse à l'utilisateur. Ce message peut être localisé.
Représentation YAML | |
---|---|
candidates:
- object ( |
Champs | |
---|---|
candidates[] |
Liste des invites candidates à envoyer au client. Chaque invite dispose d'un sélecteur permettant de déterminer quand elle peut être utilisée. Le premier sélecteur qui correspond à une requête est envoyé, et les autres sont ignorés. |
StaticPromptCandidate
Représente une requête statique candidate.
Représentation YAML | |
---|---|
selector: object ( |
Champs | |
---|---|
selector |
Facultatif. Critères permettant de déterminer si cette invite correspond à une requête. Si le sélecteur est vide, cette invite se déclenchera systématiquement. |
promptResponse |
Réponse de l'invite associée au sélecteur. |
Sélecteur
Définit les critères de correspondance entre une requête et une requête.
Représentation YAML | |
---|---|
surfaceCapabilities:
object ( |
Champs | |
---|---|
surfaceCapabilities |
Ensemble des fonctionnalités de surface requises. |
SurfaceCapabilities
Représente la surface utilisée par l'utilisateur pour envoyer une requête à l'action.
Représentation YAML | |
---|---|
capabilities:
- enum ( |
Champs | |
---|---|
capabilities[] |
Obligatoire. Capacités de la surface à envoyer une requête à l'action. |
StaticPromptResponse
Représente des réponses structurées à envoyer à l'utilisateur, telles que du texte, des conversations, des cartes, des données de canevas, des chips de suggestion, etc.
Représentation YAML | |
---|---|
firstSimple: object ( |
Champs | |
---|---|
firstSimple |
Facultatif. Première réponse vocale et textuelle. |
content |
Facultatif. Contenus (par exemple, une carte, une liste ou un contenu multimédia) à présenter à l'utilisateur. |
lastSimple |
Facultatif. Dernière réponse vocale et textuelle. |
suggestions[] |
Facultatif. Suggestions à présenter à l'utilisateur, qui apparaîtront toujours à la fin de la réponse. Si le champ |
link |
Facultatif. Un chip de suggestion supplémentaire qui peut rediriger vers l'application ou le site associés. Le chip s'affiche avec le titre "Ouvrir |
override |
Facultatif. Mode de fusion de ces messages avec les messages précédemment définis. |
canvas |
Réponse à utiliser pour l'expérience de canevas interactif. |
StaticSimplePrompt
Représente une invite simple à envoyer à un utilisateur.
Représentation YAML | |
---|---|
variants:
- object ( |
Champs | |
---|---|
variants[] |
Liste des variantes possibles. |
Variant
Représente une variante faisant partie de l'invite simple.
Représentation YAML | |
---|---|
speech: string text: string |
Champs | |
---|---|
speech |
Facultatif. Représente la voix à énoncer. Il peut s'agir d'un balisage SSML ou d'une synthèse vocale. Par défaut, les paroles sont ajoutées à celles de l'invite simple précédente. Si le champ |
text |
Facultatif. Texte à afficher dans la bulle de chat. Si ce champ n'est pas spécifié, le rendu du champ de saisie vocale ci-dessus sera utilisé à l'écran. Limité à 640 caractères. Par défaut, le texte est ajouté au texte de l'invite simple précédente. Si le champ |
StaticContentPrompt
Espace réservé pour la partie "Contenu" d'une requête statique.
Représentation YAML | |
---|---|
# Union field |
Champs | ||
---|---|---|
Champ d'union content . Une requête ne peut contenir qu'un seul type de contenu. content ne peut être qu'un des éléments suivants : |
||
card |
Une carte basique |
|
image |
Image. |
|
table |
Fiche tableau. |
|
media |
Réponse indiquant un ensemble de contenus multimédias à lire. |
|
list |
Fiche présentant une liste d'options à sélectionner. |
|
collection |
Fiche présentant une liste d'options à sélectionner. |
|
collectionBrowse |
Fiche présentant un ensemble de pages Web à ouvrir. |
StaticCardPrompt
Fiche de base permettant d'afficher certaines informations, par exemple une image et/ou du texte.
Représentation YAML | |
---|---|
title: string subtitle: string text: string image: object ( |
Champs | |
---|---|
title |
Facultatif. Titre général de la fiche. |
subtitle |
Facultatif. Sous-titre de la carte. |
text |
Obligatoire. Corps du texte de la carte (obligatoire, sauf si une image est présente). Accepte un ensemble limité de syntaxes Markdown pour la mise en forme. |
image |
Facultatif. Une hero image pour la fiche. La hauteur est fixée à 192 dp. |
imageFill |
Facultatif. Façon dont l'arrière-plan de l'image sera rempli. |
button |
Facultatif. Bouton cliquable à afficher dans la fiche. |
StaticImagePrompt
Image affichée dans la fiche.
Représentation YAML | |
---|---|
url: string alt: string height: integer width: integer |
Champs | |
---|---|
url |
Obligatoire. URL source de l'image. Les images peuvent être au format JPG, PNG et GIF (avec ou sans animation). Exemple : |
alt |
Obligatoire. Description textuelle de l'image à utiliser pour l'accessibilité, par exemple les lecteurs d'écran. |
height |
Facultatif. Hauteur de l'image en pixels. |
width |
Facultatif. Largeur de l'image en pixels. |
StaticLinkPrompt
Définit un lien qui s'affiche sous la forme d'un chip de suggestion et peut être ouvert par l'utilisateur.
Représentation YAML | |
---|---|
name: string
open:
object ( |
Champs | |
---|---|
name |
Nom du lien |
open |
Définit le comportement lorsque l'utilisateur ouvre le lien. |
OpenUrl
Définit le comportement lorsque l'utilisateur ouvre le lien.
Représentation YAML | |
---|---|
url: string
hint: enum ( |
Champs | |
---|---|
url |
Champ d'URL, qui peut correspondre à: - URL http/https pour ouvrir une page Web ou une application associée à une application |
hint |
Indique une indication concernant le type d'URL. |
StaticTablePrompt
Fiche de tableau permettant d'afficher un tableau de texte.
Représentation YAML | |
---|---|
title: string subtitle: string image: object ( |
Champs | |
---|---|
title |
Facultatif. Titre général du tableau. Doit être défini si sous-titre est défini. |
subtitle |
Facultatif. Sous-titre de la table. |
image |
Facultatif. Image associée au tableau. |
columns[] |
Facultatif. En-têtes et alignement des colonnes. |
rows[] |
Facultatif. Données de ligne de la table. L'affichage des trois premières lignes est garanti, mais d'autres peuvent être coupées sur certaines surfaces. Effectuez un test avec le simulateur afin d'identifier les lignes qui seront affichées pour une surface donnée. Sur les surfaces compatibles avec la fonctionnalité |
button |
Facultatif. Bouton. |
TableColumn
Décrit une colonne de la table.
Représentation YAML | |
---|---|
header: string
align: enum ( |
Champs | |
---|---|
header |
Texte de l'en-tête de la colonne. |
align |
Alignement horizontal du contenu par rapport à la colonne. Si aucune valeur n'est spécifiée, le contenu sera aligné sur le bord avant. |
TableRow
Décrit une ligne de la table.
Représentation YAML | |
---|---|
cells:
- object ( |
Champs | |
---|---|
cells[] |
Cellules sur cette ligne. L'affichage des trois premières cellules est garanti, mais d'autres peuvent être coupées sur certaines surfaces. Effectuez un test avec le simulateur pour identifier les cellules qui seront affichées pour une surface donnée. |
divider |
Indique si un séparateur doit être présent après chaque ligne. |
TableCell
Décrit une cellule dans une ligne.
Représentation YAML | |
---|---|
text: string |
Champs | |
---|---|
text |
Contenu textuel de la cellule. |
StaticMediaPrompt
Contient des informations sur le support, telles que le nom, la description, l'URL, etc. Identifiant suivant: 11
Représentation YAML | |
---|---|
mediaType: enum ( |
Champs | |
---|---|
mediaType |
Type de contenu de cette réponse. |
startOffset |
Décalage de début du premier objet multimédia. Durée en secondes avec neuf chiffres au maximum après la virgule. Se termine par " |
optionalMediaControls[] |
Types de commandes multimédias facultatifs compatibles avec cette session de réponse multimédia. Si cette règle est définie, la demande sera envoyée aux 3p lorsqu'un événement multimédia spécifique se produit. Si cette règle n'est pas configurée, 3p doit tout de même gérer deux types de contrôle par défaut : FINISHED (Terminé) et FAILED (ÉCHEC). |
mediaObjects[] |
Liste des objets multimédias. |
repeatMode |
Mode de répétition pour la liste des objets Media. |
MediaObject
Représente un seul objet multimédia.
Représentation YAML | |
---|---|
name: string
description: string
url: string
image:
object ( |
Champs | |
---|---|
name |
Nom de cet objet multimédia. |
description |
Description de cet objet multimédia. |
url |
URL pointant vers le contenu multimédia. |
image |
Image à afficher avec la fiche multimédia. |
MediaImage
Image à afficher dans un MediaPrompt.
Représentation YAML | |
---|---|
# Union field |
Champs | ||
---|---|---|
Champ d'union image . Un seul type d'élément MediaImage est autorisé. image ne peut être qu'un des éléments suivants : |
||
large |
Une grande image, comme la couverture de l'album, etc. |
|
icon |
Une petite icône d'image affichée à droite du titre Elle est redimensionnée au format 36 x 36 dp. |
StaticListPrompt
Fiche présentant une liste d'options à sélectionner.
Représentation YAML | |
---|---|
title: string
subtitle: string
items:
- object ( |
Champs | |
---|---|
title |
Facultatif. Titre de la liste. |
subtitle |
Facultatif. Sous-titre de la liste. |
items[] |
Obligatoire. Éléments de liste. |
ListItem
Un élément de la liste.
Représentation YAML | |
---|---|
key: string
title: string
description: string
image:
object ( |
Champs | |
---|---|
key |
Obligatoire. Clé NLU correspondant au nom de clé d'entrée dans le type associé. Lorsque l'utilisateur appuie sur l'élément, cette clé est publiée à nouveau sous la forme d'un paramètre d'option de sélection. |
title |
Obligatoire. Titre de l'article. Lorsque l'utilisateur appuie dessus, ce texte est republié dans la conversation, comme si l'utilisateur l'avait saisi. Chaque titre doit être unique parmi l'ensemble d'éléments. |
description |
Facultatif. Corps du texte de l'élément. |
image |
Facultatif. Image de l'article. |
StaticCollectionPrompt
Fiche présentant un ensemble d'options à sélectionner.
Représentation YAML | |
---|---|
title: string subtitle: string items: - object ( |
Champs | |
---|---|
title |
Facultatif. Titre de la collection. |
subtitle |
Facultatif. Sous-titre de la collection. |
items[] |
Obligatoire. Éléments de collection. |
imageFill |
Facultatif. Type d'option d'affichage d'image. |
CollectionItem
Élément de la collection.
Représentation YAML | |
---|---|
key: string
title: string
description: string
image:
object ( |
Champs | |
---|---|
key |
Obligatoire. Clé NLU correspondant au nom de clé d'entrée dans le type associé. Lorsque l'utilisateur appuie sur l'élément, cette clé est publiée à nouveau sous la forme d'un paramètre d'option de sélection. |
title |
Obligatoire. Titre de l'article. Lorsque l'utilisateur appuie dessus, ce texte est republié dans la conversation, comme si l'utilisateur l'avait saisi. Chaque titre doit être unique parmi l'ensemble d'éléments. |
description |
Facultatif. Corps du texte de l'élément. |
image |
Facultatif. Image de l'article. |
StaticCollectionBrowsePrompt
Présente un ensemble de documents Web sous la forme d'une collection d'éléments de grande taille. Vous pouvez sélectionner des éléments pour lancer leur document Web associé dans un lecteur Web.
Représentation YAML | |
---|---|
items: - object ( |
Champs | |
---|---|
items[] |
Éléments de la collection "Parcourir". La taille de la liste doit être comprise dans la plage [2, 10]. |
imageFill |
Option d'affichage des images de la collection. |
CollectionBrowseItem
Élément de la collection.
Représentation YAML | |
---|---|
title: string description: string footer: string image: object ( |
Champs | |
---|---|
title |
Obligatoire. Titre de l'élément de la collection. |
description |
Description de l'élément de la collection. |
footer |
Texte de pied de page de l'article de collection affiché sous la description. Une seule ligne de texte, tronquée par des points de suspension |
image |
Image de l'élément de la collection. |
openUriAction |
Obligatoire. URI à ouvrir si l'élément est sélectionné. |
Suggestion
Représente un chip de suggestion, un élément d'interface utilisateur présenté à l'utilisateur pour plus de commodité.
Représentation YAML | |
---|---|
title: string |
Champs | |
---|---|
title |
Obligatoire. Texte affiché dans le chip de suggestion. Lorsque l'utilisateur appuie dessus, ce texte est republié dans la conversation, comme si l'utilisateur l'avait saisi. Chaque titre doit être unique parmi les chips de suggestion. 25 caractères max. |
StaticCanvasPrompt
Représente une réponse Interactive Canvas à envoyer à l'utilisateur. Vous pouvez l'utiliser conjointement avec le champ firstSimple
dans l'invite associée pour parler à l'utilisateur en plus d'afficher une réponse de canevas interactif.
Représentation YAML | |
---|---|
url: string data: - value suppressMic: boolean sendStateDataToCanvasApp: boolean enableFullScreen: boolean continueTtsDuringTouch: boolean |
Champs | |
---|---|
url |
Obligatoire. URL de la vue Web à charger. |
data[] |
Facultatif. Données JSON à transmettre à la page Web de l'expérience immersive en tant qu'événement. Si le champ |
suppressMic |
Facultatif. Si la valeur est "true", le micro n'est pas activé pour capturer l'entrée après que cette réponse immersive a été présentée à l'utilisateur. |
sendStateDataToCanvasApp |
Facultatif. Si la valeur est |
enableFullScreen |
Facultatif. Si la valeur est |
continueTtsDuringTouch |
Facultatif. Si la valeur est "true", les appuis sur l'écran n'interrompent pas la synthèse vocale pendant toute la session de canevas. Valeur par défaut : "false". |