Las guías pueden aceptar y emitir información de contexto usando parámetros definidos de forma explícita. Los parámetros se usan para almacenar información sobre una conversación, como las selecciones del usuario, los resultados de las acciones, etcétera. Puedes pasar los valores de estos parámetros entre guías y flujos de Dialogflow CX.
Declaración de parámetros
Puedes definir parámetros de entrada y parámetros de salida.
Cuando usas los agentes de Vertex AI, puedes definir los parámetros en la página del editor del agente.
Cuando usas Dialogflow CX, los parámetros se definen por guía mediante la pestaña Parámetros una vez que creaste la guía.
Los parámetros tienen un nombre, una descripción y uno de los siguientes tipos:
- String
- Número
- Booleano
- Tipo de parámetro específico de la herramienta
También puedes especificar si un parámetro es una lista.
Parámetros de entrada
Los parámetros de entrada permiten que las guías usen valores pasados desde flujos y otras guías. Por ejemplo, una guía podría recibir el nombre preferido de un usuario como parámetro y usarlo para agradecerle personalmente, o podría recibir un identificador de pedido como parámetro y usarlo para recuperar detalles del pedido con una herramienta.
Los parámetros de entrada se definen por guía, y las guías no tienen visibilidad de otros tipos de parámetros de Dialogflow CX de forma predeterminada. Cuando un flujo de Dialogflow CX pasa a una guía, los parámetros de página y sesión se propagan a la guía si la guía de destino tiene un parámetro de entrada con el mismo nombre. Para comunicar información de un flujo a una guía durante una transición, define los parámetros de entrada de la guía con el mismo nombre que una sesión o un parámetro de página presentes antes de la transición.
Crea ejemplos para controlar cómo el valor del parámetro de entrada debería afectar las acciones. Por ejemplo, si un parámetro de entrada debe afectar la manera en que el agente se refiere al usuario, crea ejemplos que definan un valor para el parámetro y, luego, usa el mismo valor en acciones de declaración dentro del ejemplo. Consulta cómo pasar parámetros para obtener más detalles.
Los parámetros de resultado
Los parámetros de salida permiten que las guías emitan información para que la usen otros flujos o guías. Por ejemplo, una guía puede recopilar un número de pedido de un usuario y emitirlo a través de un parámetro de salida, o una guía puede usar una herramienta para reservar un vuelo y emitir el número de confirmación a través de un parámetro de salida.
Crea ejemplos para controlar cómo la guía debe decidir el valor de cada parámetro de salida. Por ejemplo, si un parámetro de salida que representa un número de confirmación debe derivar su valor del resultado del uso de una herramienta, crea ejemplos en los que el resultado del uso de la herramienta coincida con el valor del parámetro de salida de la guía.
Pasa parámetros
Las guías, a diferencia de los flujos, no admiten la inserción de valores de parámetros con una sintaxis en particular. En cambio, las guías se basan en instrucciones y ejemplos de instrucciones breves para determinar cómo se deben usar los valores de parámetros y cómo se deben decidir estos cuando se especifican valores de parámetros.
Piensa en un agente diseñado para la venta de entradas para eventos con las siguientes guías:
- Una guía llamada
Ticket ordering
que realiza pedidos con una herramienta llamadaTicket sales API
.- Esta guía acepta un parámetro de entrada con el tipo
number
y el nombreevent_id
. - La herramienta
Ticket sales API
espera una solicitud que incluya unevent_id
.
- Esta guía acepta un parámetro de entrada con el tipo
- Una guía llamada
Event selection
, que ayuda a los usuarios a seleccionar un evento y, luego, los enruta aTicket ordering
con el parámetroevent_id
para comprar entradas.
En este ejemplo, para garantizar que event_id
se pase de manera confiable de Event selection
a Ticket ordering
y de Ticket ordering
a Ticket sales API
, se necesitan varios ejemplos.
La guía de Ticket ordering
debe incluir varios ejemplos que hagan lo siguiente:
- Haz que el parámetro de entrada
event_id
se especifique con algún valor realista, diferente en cada ejemplo. - Incluye una acción de uso de la herramienta con un cuerpo de solicitud que incluya el mismo valor realista
event_id
que se especificó en el parámetro de entrada.
La guía de Event selection
debe incluir varios ejemplos que hagan lo siguiente:
- Incluye una declaración de usuario en la que este seleccione un evento con un
event_id
realista, diferente en cada ejemplo. - Incluye una invocación de guía de
Ticket ordering
, que establece el parámetroevent_id
en el mismoevent_id
realista según lo decidido por la selección del usuario.
Además de agregar ejemplos, intenta agregar instrucciones específicas a las instructions, el objetivo o los detalles de la herramienta en las que se explique cómo se deben usar los parámetros. Por ejemplo, la guía Ticket ordering
incluye la siguiente instrucción:
- Use parameter event_id to send a buy_tickets request with ${TOOL: Ticket sales API}
Con los ejemplos y las instrucciones descritos, la guía Event selection
decide correctamente un event_id
en función de la selección del usuario y lo pasa como un parámetro de entrada llamado event_id
al Ticket ordering playbook
. Luego, Ticket ordering
pasa el mismo event_id
en el cuerpo de una solicitud a Ticket sales API
. Las guías dependen de ejemplos
con valores de parámetros distintos para ayudarlas a inferir cómo se deben usar los parámetros.