Las guías pueden aceptar y emitir información de contexto. con parámetros definidos de forma explícita. Los parámetros se usan para almacenar información sobre una conversación, como selecciones de los usuarios, resultados de acciones, etcétera. Puedes pasar los valores de estos parámetros entre las secuencias de comandos y los flujos.
Declaración de parámetros
Puedes definir parámetros de entrada y parámetros de salida.
Cuando usas la consola de Agent Builder, puedes definir parámetros en la página del editor de agentes.
Cuando usas la consola de CX de Dialogflow, los parámetros se definen por guía con la pestaña Parameters una vez que creaste una 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. de flujos y otras guías. Por ejemplo, una guía puede recibir el nombre preferido de un usuario como parámetro y usarlo para agradecerle personalmente al usuario o un identificador de pedido como parámetro y usarlo para recuperar detalles del pedido con un herramienta.
Los parámetros de entrada se definen por playbook, y estos no tienen visibilidad de otros tipos de parámetros de la consola de Dialogflow CX de forma predeterminada. Cuando un flujo 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 de planificación durante una transición, define los parámetros de entrada de la guía de planificación con el mismo nombre que un parámetro de sesión o de página presente 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 forma en que hace referencia el agente para el usuario, crea ejemplos que definan un valor para el parámetro y, luego, usan el mismo valor en acciones de expresiones en el ejemplo. Consulta cómo pasar parámetros para obtener más información.
Los parámetros de resultado
Los parámetros de salida permiten que las guías emitan información. para que los usen otros flujos o guías. Por ejemplo, una guía de instrucciones podría recopilar un número de pedido de un usuario y emitirlo a través de un parámetro de salida, o bien podría 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 debe decidirse la guía 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 obtener 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 de prácticas.
Cómo pasar parámetros
Las guías, a diferencia de los flujos, no admiten la inserción de valores de parámetros. con una sintaxis particular. En cambio, los libros de jugadas se basan en instrucciones y ejemplos de instrucciones breves para determinar cómo se deben usar los valores de los parámetros y cómo se deben decidir los valores cuando se especifican los valores de los parámetros.
Considera un agente diseñado para la venta de entradas de eventos con los siguientes libros de jugadas:
- Una guía llamada
Ticket ordering
que realiza pedidos con una herramienta llamadoTicket sales API
.- Esta guía de planificación 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 de planificación acepta un parámetro de entrada con el tipo
- Una guía de implementación llamada
Event selection
que ayuda a los usuarios a seleccionar un evento y, luego, los dirige aTicket ordering
con el parámetroevent_id
para comprar boletos.
En este ejemplo, para asegurarte de que event_id
se pase de forma confiable desde
De Event selection
a Ticket ordering
y de Ticket ordering
a
Ticket sales API
, varias
ejemplos
los componentes necesarios.
La guía de Ticket ordering
debe incluir varios ejemplos que incluyan 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 herramientas con un cuerpo de solicitud que incluya el mismo valor realista de
event_id
que se especifica en el parámetro de entrada.
La guía de Event selection
debe incluir varios ejemplos que cumplan con los siguientes requisitos:
- Incluye una enunciación del usuario en la que este seleccione un evento con algunos
event_id
realistas, diferentes en cada ejemplo. - Incluye una invocación de la guía de
Ticket ordering
que establece elevent_id
. según el mismoevent_id
realista que decida la política del usuario selección.
Además de agregar ejemplos, intenta agregar instrucciones específicas al
instrucciones,
objetivo o
detalles de la herramienta
explicar cómo se deben usar los parámetros. Por ejemplo:
la guía Ticket ordering
incluye las siguientes instrucciones:
- Use parameter event_id to send a buy_tickets request with ${TOOL: Ticket sales API}
Con los ejemplos y las instrucciones descritos, Event selection
la guía decide correctamente un event_id
en función de la selección del usuario
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 los ejemplos
con valores de parámetros distintos para ayudar a inferir cómo se deben usar los parámetros.