Fulfillments

Pour le tour de conversation d'un agent, il doit répondre à l'utilisateur final en lui fournissant une réponse à une question, une requête d'informations ou une cessation de session. Votre agent peut également avoir besoin de contacter votre service pour générer des réponses dynamiques ou prendre des mesures pour un tour. Le fulfillment permet d'effectuer toutes ces opérations.

Un fulfillment peut contenir l'un des éléments suivants :

  • Messages de réponse statiques
  • Appels webhook pour les réponses dynamiques et/ou pour effectuer des actions
  • Préréglages de paramètres pour définir ou remplacer les valeurs de paramètres

Lors du tour d'un agent, il est possible (et parfois souhaitable) d'appeler plusieurs fulfillments, chacun pouvant générer un message de réponse. Les agents de conversation (Dialogflow CX) conservent ces réponses dans une file d'attente de réponses. Une fois le tour de l'agent terminé, les agents conversationnels (Dialogflow CX) envoient les réponses triées à l'utilisateur final.

Cas d'utilisation du fulfillment

Le fulfillment est utilisé partout où un message de réponse est nécessaire :

Pour chacun de ces cas d'utilisation, la console ouvre un panneau de modification de fulfillment.

Capture d'écran de fulfilment

Réponses de l'agent (options de dialogue)

Les messages de réponse de l'agent sont des réponses d'agent que vous définissez au moment de la conception. Ces réponses doivent être définies lors de la création d'un fulfillment. Au moment de l'exécution, ces réponses sont ajoutées à la file d'attente de réponses.

Il existe plusieurs types de messages de réponse, qui sont décrits dans les sous-sections suivantes. Dans la console, le panneau de fulfillment comprend une fiche de dialogue avec l'agent initiale. Vous pouvez ensuite cliquer sur + Ajouter une réponse de dialogue pour ajouter d'autres fiches pour les autres types de messages de réponse.

Réponse texte statique

Les messages de réponse textuelle statiques envoient un dialogue sous forme de texte à l'utilisateur final. Si vos appels d'API de détection d'intent ou votre intégration utilisent la synthèse vocale, ce texte sera utilisé pour générer du contenu audio. Dans ce cas, le texte fourni peut éventuellement utiliser le langage de balisage de synthèse vocale (SSML).

Vous pouvez définir plusieurs fiches de réponse textuelle et plusieurs réponses textuelles dans chaque fiche. Si vous définissez plusieurs fiches, elles sont concaténées en une seule réponse au moment de l'exécution. Si vous définissez plusieurs réponses dans une fiche, l'un des messages de la fiche est choisi de manière aléatoire au moment de l'exécution.

Ces messages peuvent contenir des références de paramètres et des fonctions système intégrées.

Charge utile personnalisée

Certaines intégrations permettent une réponse avec une charge utile personnalisée pour gérer les réponses enrichies. Ces charges utiles personnalisées doivent être fournies au format JSON défini dans la documentation de l'intégration. Par exemple, consultez le format de charge utile personnalisée Dialogflow CX Messenger.

Vous pouvez inclure des références de paramètres dans votre fichier JSON de charge utile personnalisée. Ils doivent être traités comme des valeurs de chaîne JSON et sont donc placés entre guillemets doubles. Exemple :

{
  "someField": "$session.params.date"
}

Vous pouvez également envoyer une charge utile personnalisée aux intégrations que vous développez. Elle ne sera pas traitée par les agents de conversation (Dialogflow CX). Vous devez donc la gérer dans votre propre logique métier.

Consultez également la section Modèles de charge utile personnalisée suivante.

Transfert à un agent humain

Cette réponse indique à l'appelant de l'API de détection d'intent que la conversation doit être transmise à un agent humain. Les agents de conversation (Dialogflow CX) n'utilisent ce signal que pour identifier les conversations transmises à des fins de mesure et ne modifient en aucun cas l'état de la session. Votre système ou votre intégration peut utiliser ce signal pour effectuer les actions nécessaires au transfert de la conversation. Les agents de conversation (Dialogflow CX) n'imposent aucune structure pour ces données. Vous pouvez donc choisir n'importe quelle structure adaptée à votre système.

Métadonnées de réussite de la conversation

Cette réponse indique à l'appelant de l'API de détection d'intent que la conversation avec l'agent Conversational Agents (Dialogflow CX) a abouti. Les agents de conversation (Dialogflow CX) n'utilisent ce signal que pour identifier les conversations ayant abouti à des fins de mesure et ne modifient en aucun cas l'état de la session. Votre système ou votre intégration peut utiliser ce signal pour effectuer les actions nécessaires. Les agents de conversation (Dialogflow CX) n'imposent aucune structure pour ces données. Vous pouvez donc choisir n'importe quelle structure adaptée à votre système.

Lire du contenu audio préenregistré

Cette réponse lit un fichier audio pour les intégrations compatibles avec cette fonctionnalité.

Les exigences concernant les formats de fichiers audio peuvent varier d'une intégration à l'autre. Par exemple, consultez les exigences pour la passerelle de téléphonie Dialogflow CX.

Pour les intégrations de téléphonie partenaires, l'URL du fichier audio doit être accessible par le partenaire. Une URL accessible au public, comme un fichier public dans Cloud Storage, est toujours accessible par le partenaire. Le partenaire peut également fournir un accès limité aux fichiers audio. Pour en savoir plus, consultez la documentation du partenaire.

Texte audio de sortie

Cette réponse est semblable à la réponse text, mais elle ne s'applique qu'à la synthèse vocale. Si votre agent peut gérer à la fois les sessions textuelles et les sessions vocales, vous pouvez utiliser des réponses uniques pour texte et texte audio de sortie afin de créer une expérience utilisateur différente pour le texte par rapport à voix. Si un texte audio de sortie est fourni pour une session vocale, les réponses en texte brut sont ignorées.

Si votre agent gère des sessions textuelles et vocales, et que vous souhaitez utiliser les mêmes messages de réponse dans les deux cas, utilisez simplement les réponses textuelles pour les deux types de session.

Le texte audio de sortie est concaténé de la même façon que les réponses textuelles. Si les réponses de texte audio de sortie sont un mélange de texte et de SSML, le résultat concaténé est traité comme du SSML. Dans l'idéal, le concepteur de l'agent doit utiliser soit du texte, soit du SSML.

Réponse conditionnelle

Ce type de réponse est utilisé pour les réponses conditionnelles. Le format général est :

if [condition]
  [response]
elif [condition]
  [response]
elif [condition]
  [response]
else
  [response]
endif

où :

  • [condition] est le même format que celui utilisé pour les conditions de routage.
  • [response] est une réponse textuelle.
  • Les blocs elif et else sont facultatifs.

Exemple :

if $session.params.user-age >= 21
  Ok, you may enter.
else
  Sorry, you cannot enter.
endif

[condition] et [response] peuvent utiliser des fonctions système intégrées pour générer des valeurs dynamiques pendant les conversations. Pour plus d'informations, veuillez consulter les références des fonctions système et des conditions de routage. [condition] est résolu en fonction de l'état de la session au début de l'exécution. Si [response] s'appuie sur l'état de la session, il est résolu en fonction de l'état de la session mis à jour à la fin de l'exécution.

Pour les agents multilingues, [condition] est commun à toutes les langues, tandis que [response] est spécifique à chaque langue. Lorsque vous modifiez [condition] pour une langue dans la console, l'élément est mis à jour dans toutes les langues de l'agent. Et dans la mesure où l'élément devient une nouvelle condition, [response] est effacé pour toutes les langues. autres que celle sélectionnée lors de la mise à jour de [condition].

Transfert d'appel téléphonique

Pour certaines intégrations de téléphonie, vous pouvez spécifier un numéro de téléphone aux États-Unis pour le transfert d'appel. Au moment de l'exécution, lorsque l'agent virtuel Conversational Agents (Dialogflow CX) appelle un fulfillment avec un transfert d'appel, l'appel est transféré vers le numéro spécifié et la gestion des agents virtuels est suspendue.

Réponse de l'outil de data store

Ce type de réponse configure les réponses de l'agent renvoyées par les outils de datastore associés. Si vous avez configuré un outil de stockage de données dans ce traitement, une fiche de réponse de l'outil de stockage de données est renseignée automatiquement.

  • Liens vers les sources: vous permet de définir le nombre maximal de citations qui seront renvoyées à l'utilisateur après la réponse. Une citation est un lien vers la source d'informations dans le data store, affiché sous forme de boutons. La valeur par défaut est 1.
  • Citations intégrées: au lieu de liens listés après la réponse, ce champ vous permet de limiter le nombre de citations intégrées renvoyées par phrase.
  • Remplacement génératif: cocher cette case indique à l'agent d'essayer d'obtenir une réponse générée par IA si le data store renvoie un résultat vide. En cas d'échec, il passe aux réponses statiques.
  • Réponses statiques: vous pouvez saisir des réponses textuelles statiques dans le champ final. Ils sont envoyés à l'utilisateur mot pour mot.

Messages de réponse spécifiques au canal

Lorsque vous définissez l'exécution, vous pouvez créer des messages de réponse spécifiques aux canaux. Vous pouvez ainsi créer des réponses ciblées pour le chat textuel, la voix, les SMS, les intégrations spécifiques qui prennent en charge les canaux, etc. Les messages de réponse qui ne sont pas spécifiques à un canal sont appelés messages de réponse par défaut.

Au moment de l'exécution, les agents de conversation (Dialogflow CX) sélectionnent le message de réponse par défaut ou un message de réponse spécifique au canal lorsqu'une requête de détection d'intent spécifie un canal. Nous vous recommandons de définir des messages de réponse par défaut, même si vous utilisez des messages de réponse spécifiques au canal. Les messages de réponse par défaut peuvent servir de solution de secours lorsque votre système ne parvient pas à fournir de canal valide.

Le nom de la chaîne est un champ personnalisé que vous pouvez définir sur n'importe quel texte. Si vous utilisez directement l'API Conversational Agents (Dialogflow CX) pour les appels d'exécution, vous pouvez utiliser n'importe quel nom de canal de votre choix. Si vous utilisez une intégration existante, vous devez utiliser les noms de canaux que l'intégration reconnaît.

Définir des messages de réponse spécifiques au canal au moment de la conception

Pour fournir des messages de réponse spécifiques au canal pour le traitement lorsque vous utilisez la console:

  • Cliquez sur Ajouter un canal après avoir ajouté les messages de réponse par défaut. L'interface utilisateur vous permet d'ajouter des messages de réponse spécifiques à un canal. Cliquez à nouveau sur Ajouter un canal pour ajouter un autre canal.

Pour fournir des messages de réponse spécifiques au canal pour l'exécution lorsque vous utilisez l'API:

  • Définissez le champ Fulfillment.messages[i].channel sur le canal souhaité pour chaque message de réponse. Si ce champ n'est pas défini, la réponse est un message de réponse par défaut.

Utiliser des messages de réponse spécifiques au canal au moment de l'exécution

Pour recevoir un message de réponse spécifique à une chaîne, la chaîne doit être spécifiée dans le message de requête de détection d'intent. Consultez le champ queryParams.channel dans la méthode detectIntent du type Sessions.

Sélectionnez un protocole et une version pour la référence de session :

Protocole V3 V3beta1
REST Ressource de session Ressource de session
RPC Interface de session Interface de session
C++ SessionsClient Non disponible
C# SessionsClient Non disponible
Go SessionsClient Non disponible
Java SessionsClient SessionsClient
Node.js SessionsClient SessionsClient
PHP Non disponible Non disponible
Python SessionsClient SessionsClient
Ruby Non disponible Non disponible

Si aucune chaîne n'est définie dans une requête ou si aucune chaîne correspondante n'est trouvée lors du traitement, le message de réponse par défaut est renvoyé par les agents de conversation (Dialogflow CX).

Modèles de charge utile personnalisée

Si vous utilisez souvent des charges utiles personnalisées, vous devez utiliser des modèles de charge utile personnalisée. Les charges utiles personnalisées sont parfois volumineuses et complexes. L'utilisation de modèles peut donc faciliter le processus de création d'agents.

Vous pouvez fournir ces modèles dans les paramètres de votre agent, ce qui les rend disponibles à la sélection chaque fois que vous créez un traitement pour votre agent.

Par exemple, la charge utile JSON pour les boutons "Oui" et "Non" peut être définie comme des modèles de charge utile personnalisée. Lorsque vous créez un traitement qui nécessite ces boutons, il vous suffit de sélectionner le modèle lorsque vous créez le traitement.

Lorsque vous sélectionnez un modèle pour une charge utile personnalisée de traitement, le contenu du modèle est inséré dans la charge utile. Vous pouvez ensuite modifier la charge utile si nécessaire.

Si vous modifiez un modèle, la modification ne se propage pas automatiquement à toutes les charges utiles de traitement où il a été référencé.

Pour créer un modèle de charge utile personnalisée, consultez les paramètres généraux de l'agent.

Pour sélectionner un modèle de charge utile personnalisée lors de la création d'un traitement, cliquez sur Sélectionner un modèle lorsque vous créez une charge utile personnalisée de traitement.

Appels Webhook

Lorsqu'un fulfillment est appelé et qu'il possède un webhook, l'agent envoie une requête à votre webhook. Le webhook peut effectuer toutes les actions nécessaires dans votre service, fournir un message de réponse dynamique, remplacer les valeurs des paramètres et modifier la page actuelle.

Vous trouverez ci-dessous la description des paramètres des webhooks pour l'exécution:

Terme Définition
Activer le webhook Cela active le webhook pour le traitement.
Webhook Sélectionnez la ressource webhook.
Tag La balise de texte que vous fournissez ici sera renseignée dans le champ WebhookRequest.fulfillmentInfo.tag de la requête de webhook envoyée à votre service de webhook. Vous pouvez l'utiliser pour contrôler le comportement du webhook de manière spécifique à l'exécution.
Renvoyer une réponse partielle Permet d'annuler la lecture d'une réponse partielle. Pour en savoir plus, consultez les paramètres avancés de synthèse vocale.

Préréglages des paramètres

Vous pouvez utiliser un fulfillment pour fournir des préréglages qui définissent ou remplacent les valeurs de paramètre actuelles. Ces préréglages seront appliqués avant de résoudre les messages de réponse statique ou d'appeler un webhook.

Vous pouvez également utiliser des fonctions système pour prédéfinir le paramètre sur une valeur générée dynamiquement.

Voici quelques exemples :

  • Définissez un paramètre now sur l'heure actuelle :

    Paramètre Valeur
    maintenant $sys.func.NOW()

  • Incrémentez le counter d'un paramètre existant par 1 :

    Paramètre Valeur
    compteur $sys.func.ADD($session.params.counter, 1)

  • Définir un paramètre new-cost sur la valeur du paramètre other-cost, tout en conservant la valeur complète de l'objet composite:

    Paramètre Valeur
    new-cost $sys.func.IDENTITY($session.params.other-cost)

Outils de datastore

Pour en savoir plus sur cette fonctionnalité, consultez la documentation des outils de datastore.

Paramètres vocaux avancés

Ces paramètres vocaux avancés peuvent éventuellement remplacer les mêmes paramètres vocaux de la page, les paramètres vocaux du flux et les paramètres vocaux de l'agent.

File d'attente de réponses

Lors du tour d'un agent, il est possible (et parfois souhaitable) d'appeler plusieurs fulfillments, chacun pouvant générer un message de réponse. Les agents de conversation (Dialogflow CX) conservent ces réponses dans une file d'attente de réponses.

Réponse partielle pour l'API de diffusion

Par défaut, les agents conversationnels (Dialogflow CX) n'envoient les réponses triées à l'utilisateur final qu'une fois le tour de l'agent terminé. Vous pouvez également activer l'option Renvoyer une réponse partielle dans le fulfillment afin de renvoyer des réponses actuellement en file d'attente en tant que réponse partielle lors de l'utilisation des API de diffusion. Pour en savoir plus, consultez la section Cycle de vie d'une page.

Par exemple, si votre webhook est susceptible de s'exécuter pendant une longue période, vous pouvez ajouter une réponse statique dans le fulfillment et activer la réponse partielle. Les agents de conversation (Dialogflow CX) vident la file d'attente de réponses et envoient tous les messages sous forme de réponse partielle avant d'appeler le webhook.

La réponse partielle n'est actuellement pas compatible avec les éléments suivants, mais elle le sera prochainement:

Pour tester cette fonctionnalité dans le simulateur, vous devez activer la réponse partielle.

Capture d'écran de réponse partielle dans le simulateur

Dans l'exemple suivant, gardez à l'esprit que votre webhook prend 5 secondes à s'exécuter et que la réponse partielle n'est pas activée. Le tour de conversation de l'agent Conversational Agents (Dialogflow CX) n'est pas terminé tant que le webhook n'est pas terminé. Pendant ce délai de 5 secondes, les réponses sont mises en file d'attente et ne sont renvoyées à l'utilisateur final qu'une fois le tour terminé. Cela nuit à l'expérience utilisateur.

Sans réponse partielle.

Si vous activez la réponse partielle dans le premier traitement, les agents de conversation (Dialogflow CX) renvoient rapidement le premier message de traitement et appellent le webhook. Une fois le webhook terminé, les agents de conversation (Dialogflow CX) renvoient la réponse finale. L'expérience utilisateur est améliorée dans ce scénario, car l'utilisateur ne doit pas attendre trop longtemps. De plus, l'appel du webhook s'exécute simultanément avec une réponse envoyée à l'utilisateur final.

Avec réponse partielle.

Langage de balisage de synthèse vocale (SSML)

Vous pouvez utiliser le langage de balisage de synthèse vocale (SSML) dans les champs de traitement du texte ou du texte audio. Vous pouvez ainsi personnaliser votre réponse audio en fournissant des détails sur les pauses, ainsi que la mise en forme audio des acronymes, des dates, des heures, des abréviations ou du texte qui devrait être censuré.

Pour en savoir plus sur la syntaxe, consultez la documentation SSML pour la synthèse vocale.

Précédent
Paramètres
Suivant
Webhooks