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, par exemple les sélections d'utilisateurs, les résultats des actions, etc. Vous pouvez transmettre les valeurs de ces paramètres des playbooks et des flux Dialogflow CX.
Déclaration de 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 d'agents.
Lorsque vous utilisez Dialogflow CX, les paramètres sont définis par playbook à l'aide des paramètres. après avoir créé un playbook.
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 autorisent les playbooks à 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 comme paramètre et de l'utiliser pour remercier personnellement l'utilisateur, ou peut recevoir un identifiant de commande en tant que paramètre et l'utiliser pour récupérer les détails d'une commande .
Les paramètres d'entrée sont définis par playbook, et les playbooks n'ont pas visibilité de d'autres types de paramètres Dialogflow CX par défaut. Lorsqu'un flux Dialogflow CX passe à un playbook, les paramètres de page et de session sont propagés dans le playbook si le playbook cible comporte un paramètre d'entrée portant le même nom. Pour communiquer les informations d'un flux à un playbook lors d'une transition, Définir des paramètres d'entrée du playbook portant le même nom qu'une session ou un paramètre 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 se réfère à 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é dans l'exemple. Voir transmission des paramètres pour plus de détails.
Paramètres de sortie
Les paramètres de sortie permettent aux playbooks d'émettre des informations. à utiliser par d'autres flux ou playbooks. Par exemple, un playbook peut collecter un numéro de commande auprès des un utilisateur et l'émettre via un paramètre de sortie, ou un playbook peut utiliser outil pour réserver un vol et émettre le numéro de confirmation via un paramètre de sortie.
Créer des exemples pour contrôler la façon dont le playbook doit décider la valeur de chaque paramètre de sortie. Par exemple, si un paramètre de sortie représentant une confirmation doit dériver sa valeur du résultat d'une utilisation d'un outil, créer des exemples où la sortie de l'outil use correspond à la valeur du paramètre de sortie du playbook.
Paramètres de transmission
Contrairement aux flux, les playbooks ne permettent pas d'injecter des valeurs de paramètre avec une syntaxe particulière. Au lieu de cela, les playbooks s'appuient sur des instructions et 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 lorsque vous spécifiez les valeurs des paramètres.
Prenons l'exemple d'un agent conçu pour la vente de billets pour des événements avec les playbooks suivants:
- Un playbook nommé
Ticket ordering
, qui passe des commandes à l'aide d'un outil nomméeTicket sales API
.- Ce playbook accepte un paramètre d'entrée de type
number
et de nomevent_id
- L'outil
Ticket sales API
s'attend à une requête incluant unevent_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 l'achemine versTicket ordering
avec le paramètreevent_id
pour effectuer l'achat. des demandes d'assistance.
Dans cet exemple, pour s'assurer que event_id
est transmis de manière fiable depuis
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 le même
une valeur
event_id
réaliste comme spécifiée dans le paramètre d'entrée.
Le playbook Event selection
doit inclure plusieurs exemples:
- Incluez un énoncé utilisateur dans lequel celui-ci sélectionne un événement avec des
event_id
, qui est différent dans chaque exemple. - Incluez un appel de playbook de
Ticket ordering
qui définitevent_id
par rapport au même paramètreevent_id
réaliste que celui défini de votre choix.
En plus d'ajouter des exemples, essayez d'ajouter des instructions spécifiques à la section
instructions,
goal ou
détails de l'outil
expliquant comment les paramètres
doivent être utilisés. Par exemple :
Le playbook Ticket ordering
comprend l'instruction suivante:
- Use parameter event_id to send a buy_tickets request with ${TOOL: Ticket sales API}
Avec les exemples et les instructions décrits, le Event selection
le playbook décide correctement d'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
au
Ticket ordering playbook
Ensuite, Ticket ordering
transmet le même event_id
dans le corps d'une requête à Ticket sales API
. Les playbooks dépendent d'exemples
avec des valeurs de paramètres distinctes pour les aider à déduire
la façon dont les paramètres doivent être utilisés.