Les playbooks peuvent accepter et émettre des informations contextuelles à l'aide de paramètres définis explicitement. Les paramètres servent à stocker des informations sur une conversation, telles que des sélections d'utilisateurs, des résultats d'actions, etc. Vous pouvez transmettre les valeurs de ces paramètres entre les playbooks et les flux Dialogflow CX.
Déclaration du paramètre
Vous pouvez définir des paramètres d'entrée et des paramètres de sortie.
Lorsque vous utilisez des agents Vertex AI, vous pouvez définir des paramètres sur la page de l'éditeur.
Lorsque vous utilisez Dialogflow CX, les paramètres sont définis pour chaque playbook créé à l'aide de l'onglet Paramètres.
Les paramètres ont un nom, une description et l'un des types suivants:
- Chaîne
- Number
- Booléen
- Type de paramètre spécifique à l'outil
Vous pouvez également spécifier si un paramètre est une liste.
Paramètres d'entrée
Les paramètres d'entrée permettent aux playbooks d'utiliser les valeurs transmises à partir de flux et d'autres playbooks. Par exemple, un playbook peut recevoir le nom préféré d'un utilisateur en tant que paramètre et l'utiliser pour le remercier personnellement, ou recevoir un identifiant de commande en tant que paramètre et l'utiliser pour récupérer les détails de la commande à l'aide d'un outil.
Les paramètres d'entrée sont définis par playbook, et les autres types de paramètres Dialogflow CX ne sont pas visibles par défaut. Lorsqu'un flux Dialogflow CX passe à un playbook, les paramètres de page et de session sont propagés vers le playbook si le playbook cible comporte un paramètre d'entrée portant le même nom. Pour communiquer des informations d'un flux à un playbook lors d'une transition, définissez ses paramètres d'entrée portant le même nom qu'un paramètre de session ou de page présent avant la transition.
Créez des exemples pour contrôler l'impact de la valeur du paramètre d'entrée sur les actions. Par exemple, si un paramètre d'entrée doit affecter la façon dont l'agent fait référence à l'utilisateur, créez des exemples qui définissent une valeur pour le paramètre, puis utilisez la même valeur dans les actions d'énoncé de l'exemple. Pour en savoir plus, consultez la section Transmettre des paramètres.
Paramètres de sortie
Les paramètres de sortie permettent aux playbooks d'émettre des informations qui seront utilisées par d'autres flux ou playbooks. Par exemple, un playbook peut collecter un numéro de commande auprès d'un utilisateur et l'émettre via un paramètre de sortie, ou utiliser un outil pour réserver un vol et émettre le numéro de confirmation via un paramètre de sortie.
Créez des exemples pour contrôler la manière dont le playbook doit décider de la valeur de chaque paramètre de sortie. Par exemple, si un paramètre de sortie représentant un numéro de confirmation doit dériver sa valeur de la sortie de l'utilisation d'un outil, créez des exemples dans lesquels la sortie de l'outil correspond à la valeur du paramètre de sortie du playbook.
Paramètres transmis
Contrairement aux flux, les playbooks ne permettent pas d'injecter des valeurs de paramètre avec une syntaxe particulière. À la place, les playbooks s'appuient sur des instructions et des exemples de requêtes few-shot pour déterminer comment les valeurs de paramètre doivent être utilisées et comment les valeurs doivent être définies lors de la spécification des valeurs de paramètre.
Prenons l'exemple d'un agent conçu pour la vente de billets d'événements et utilisant les playbooks suivants:
- Un playbook nommé
Ticket ordering
, qui passe des commandes à l'aide de l'outilTicket sales API
.- Ce playbook accepte un paramètre d'entrée de type
number
et nomméevent_id
. - L'outil
Ticket sales API
attend une requête incluant un élémentevent_id
.
- Ce playbook accepte un paramètre d'entrée de type
- Un playbook nommé
Event selection
, qui aide les utilisateurs à sélectionner un événement, puis les achemine versTicket ordering
avec le paramètreevent_id
pour acheter des billets.
Dans cet exemple, pour vous assurer que event_id
est transmis de manière fiable de Event selection
à Ticket ordering
et de Ticket ordering
à Ticket sales API
, plusieurs exemples sont nécessaires.
Le playbook Ticket ordering
doit inclure plusieurs exemples:
- Le paramètre d'entrée
event_id
doit être spécifié avec une valeur réaliste, différente dans chaque exemple. - Incluez une action d'utilisation de l'outil avec un corps de requête qui inclut la même valeur
event_id
réaliste que celle spécifiée dans le paramètre d'entrée.
Le playbook Event selection
doit inclure plusieurs exemples:
- Incluez un énoncé utilisateur dans lequel l'utilisateur sélectionne un événement avec un
event_id
réaliste, différent dans chaque exemple. - Incluez un appel de playbook de
Ticket ordering
qui définit le paramètreevent_id
sur le mêmeevent_id
réaliste que défini par la sélection de l'utilisateur.
En plus d'ajouter des exemples, ajoutez des instructions spécifiques aux instructions, à l'objectif ou aux détails de l'outil expliquant comment utiliser les paramètres. Par exemple, le playbook Ticket ordering
inclut les instructions suivantes:
- Use parameter event_id to send a buy_tickets request with ${TOOL: Ticket sales API}
Avec les exemples et les instructions décrits, le playbook Event selection
choisit correctement un event_id
en fonction de la sélection de l'utilisateur et le transmet en tant que paramètre d'entrée nommé event_id
à Ticket ordering playbook
. Ensuite, Ticket ordering
transmet le même event_id
dans le corps d'une requête à Ticket sales API
. Les playbooks reposent sur des exemples avec des valeurs de paramètres distinctes pour les aider à déterminer comment les paramètres doivent être utilisés.