- Représentation YAML
- StaticPrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticPromptCandidate
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- Sélecteur
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- SurfaceCapabilities
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticPromptResponse
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticSimplePrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- Variante
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticContentPrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticCardPrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticImagePrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticLinkPrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- OpenUrl
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticTablePrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- TableColumn
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- TableRow
- TableCell
- StaticMediaPrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- MediaObject
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- MediaImage
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticListPrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- ListItem
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticCollectionPrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- CollectionItem
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticCollectionBrowsePrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- CollectionBrowseItem
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- Suggestion
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
- StaticCanvasPrompt
<ph type="x-smartling-placeholder">
- </ph>
- Représentation YAML
Définit un gestionnaire à exécuter après un événement. Les événements basés sur des intents et des conditions dans une scène sont des exemples d'événements.
Représentation YAML | |
---|---|
webhookHandler: string # Union field |
Champs | ||
---|---|---|
webhookHandler |
Nom du gestionnaire de webhooks à 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 |
Requête statique intégrée. Peut contenir des références à des ressources de chaîne dans les bundles. |
|
staticPromptName |
Nom de la requête statique à appeler. |
StaticPrompt
Représente une liste de propositions d'invites, dont l'une sera sélectionnée en tant qu'invite à 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 requête est associée à un sélecteur pour déterminer quand l'utiliser. 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 pour déterminer si cette requête correspond à une requête. Si le sélecteur est vide, cette invite est toujours déclenchée. |
promptResponse |
Réponse d'invite associée au sélecteur. |
Sélecteur
Définit les critères pour déterminer si une requête correspond à 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. Les capacités de la surface qui envoie une requête à l'action. |
StaticPromptResponse
Représente les réponses structurées à envoyer à l'utilisateur, telles que du texte, des conversations, des fiches, des données de canevas, des chips de suggestion, etc.
Représentation YAML | |
---|---|
firstSimple: object ( |
Champs | |
---|---|
firstSimple |
Facultatif. Première réponse vocale et texte uniquement. |
content |
Facultatif. Contenu tel qu'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 et apparaîtront toujours à la fin de la réponse. Si le champ |
link |
Facultatif. Chip de suggestion supplémentaire pouvant rediriger les utilisateurs vers l'application ou le site associé. Le chip s'affichera avec le titre "Ouvrir |
override |
Facultatif. Mode de fusion des messages avec des messages définis précédemment. |
canvas |
Réponse à utiliser pour l'expérience interactive sur le canevas. |
StaticSimplePrompt
Représente une requête simple à envoyer à un utilisateur.
Représentation YAML | |
---|---|
variants:
- object ( |
Champs | |
---|---|
variants[] |
Liste des variantes possibles. |
Variant
Représente une variante qui fait partie de la requête simple.
Représentation YAML | |
---|---|
speech: string text: string |
Champs | |
---|---|
speech |
Facultatif. Représente le discours à prononcer à l'utilisateur. Il peut s'agir de messages SSML ou de synthèse vocale. Par défaut, les paroles sont ajoutées à celles de la requête Simple précédente. Si le champ |
text |
Facultatif. Texte à afficher dans la bulle de chat. S'il n'est pas fourni, un rendu par affichage du champ vocal ci-dessus sera utilisé. Limité à 640 caractères. Par défaut, le texte est ajouté au texte de la requête 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 du tableau. |
|
media |
Réponse indiquant un ensemble de contenus multimédias à lire. |
|
list |
Fiche présentant une liste d'options disponibles. |
|
collection |
Fiche présentant une liste d'options disponibles. |
|
collectionBrowse |
Fiche présentant un ensemble de pages Web à ouvrir. |
StaticCardPrompt
Une carte basique permettant d'afficher certaines informations (par exemple, une image et/ou un 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 fiche. |
text |
Obligatoire. Corps du texte de la carte, qui est nécessaire à moins qu'une image ne soit présente. Accepte un ensemble limité de syntaxes Markdown pour la mise en forme. |
image |
Facultatif. Une image héros pour la carte. La hauteur est fixe à 192 dp. |
imageFill |
Facultatif. Mode de remplissage de l'arrière-plan de l'image. |
button |
Facultatif. Bouton cliquable à afficher dans la fiche. |
StaticImagePrompt
Une image affichée dans la carte.
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 (animé ou non). Exemple : |
alt |
Obligatoire. Description textuelle de l'image à utiliser pour l'accessibilité, par exemple avec des 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'affichera sous forme de 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 contenir l'un des éléments suivants: - URL http/https permettant d'ouvrir une application associée à une application ou une page Web |
hint |
Indique une indication pour le type d'URL. |
StaticTablePrompt
Fiche du tableau permettant d'afficher un tableau de texte.
Représentation YAML | |
---|---|
title: string subtitle: string image: object ( |
Champs | |
---|---|
title |
Facultatif. Titre général de la table. Doit être défini si sous-titre est défini. |
subtitle |
Facultatif. Sous-titre du tableau. |
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és sur certaines surfaces. Effectuez un test avec le simulateur pour voir quelles lignes 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 de la colonne de pondération du contenu. S'il n'est pas spécifié, le contenu sera aligné sur le bord initial. |
Ligne de tableau
Décrit une ligne du tableau.
Représentation YAML | |
---|---|
cells:
- object ( |
Champs | |
---|---|
cells[] |
Cellules de cette ligne. L'affichage des trois premières cellules est garanti, mais d'autres peuvent être coupés sur certaines surfaces. Effectuez un test avec le simulateur pour voir quelles cellules seront affichées pour une surface donnée. |
divider |
Indique s'il doit y avoir un séparateur 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 contenu multimédia, telles que le nom, la description, l'URL, etc. Identifiant suivant: 11
Représentation YAML | |
---|---|
mediaType: enum ( |
Champs | |
---|---|
mediaType |
Type de support 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 facultatives compatibles avec cette session de réponse multimédia. Si cette règle est définie, la requête est envoyée à 3p lorsqu'un événement multimédia donné se produit. Si cette règle n'est pas configurée, 3p doit tout de même gérer deux types de commandes par défaut : FINISHED et FAILED. |
mediaObjects[] |
Liste des objets multimédias. |
repeatMode |
Mode de répétition pour la liste des objets Media. |
MediaObject
Représente un objet multimédia unique.
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 une MediaPrompt.
Représentation YAML | |
---|---|
# Union field |
Champs | ||
---|---|---|
Champ d'union image . Un seul type est autorisé pour MediaImage. 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 s'affiche à droite du titre. Elle est redimensionnée à 36 x 36 dp. |
StaticListPrompt
Fiche présentant une liste d'options disponibles.
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
Élément dans la liste.
Représentation YAML | |
---|---|
key: string
title: string
description: string
image:
object ( |
Champs | |
---|---|
key |
Obligatoire. Clé NLU correspondant au nom de la clé d'entrée dans le type associé. Lorsque l'utilisateur appuie sur l'élément, cette clé est publiée en tant que paramètre d'option de sélection. |
title |
Obligatoire. Titre de l'article. Lorsque l'utilisateur appuiera sur ce texte, il sera publié tel quel 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 disponibles.
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 la collection. |
imageFill |
Facultatif. Type d'option d'affichage de l'image. |
CollectionItem
Un é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 la clé d'entrée dans le type associé. Lorsque l'utilisateur appuie sur l'élément, cette clé est publiée en tant que paramètre d'option de sélection. |
title |
Obligatoire. Titre de l'article. Lorsque l'utilisateur appuiera sur ce texte, il sera publié tel quel 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. Les éléments peuvent être sélectionnés pour lancer le 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'élément de la collection, affiché sous la description. Une seule ligne de texte, tronquée par des points de suspension. |
image |
Image de l'élément de 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 appuiera sur ce texte, il sera publié tel quel 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. Cette option peut être utilisée en conjonction avec le champ firstSimple
dans l'invite associée pour parler à l'utilisateur en plus d'afficher une réponse interactive du canevas.
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. La valeur "true" signifie que le micro ne sera pas activé pour la capture d'entrée une fois que cette réponse immersive aura é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 tapotements sur l'écran n'arrêtent pas la synthèse vocale pendant toute la session de canevas. Valeur par défaut : "false". |