Parámetros

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Importante: Las guías de Dialogflow CX se denominan agentes cuando se usan agentes de Vertex AI. Para evitar confusiones, en este documento se usa el término guía.

Importante: Guías de Dialogflow CX y pasos de parámetros entre Los flujos y guías de Dialogflow CX se documentan aquí, pero que actualmente tienen acceso restringido. La transferencia de parámetros entre agentes de Vertex AI está disponible de forma pública.

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 guías y flujos de Dialogflow CX.

Declaración de parámetros

Puedes definir parámetros de entrada y parámetros de salida.

Cuando se usan agentes de Vertex AI, puedes definir los parámetros en la página del editor del agente.

Cuando uses Dialogflow CX, se definen por guía mediante los parámetros Parameters una vez que hayas creado 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 recibir un identificador de pedido como parámetro y usarlo para recuperar detalles del pedido con un herramienta.

Los parámetros de entrada se definen según la 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, definir los parámetros de entrada de la guía con el mismo nombre que una sesión o parámetro de la página presentes antes de la transición.

Nota: La guía predeterminada no acepta parámetros de entrada. La guía predeterminada funciona como punto de entrada para las conversaciones de los usuarios, por lo que no tiene forma de recibir parámetros de entrada.

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 pasar parámetros para obtener detalles.

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 podría recopilar un número de pedido de un usuario y emitirla a través de un parámetro de salida, o una guía puede utilizar 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 una confirmación debe derivar su valor del resultado del uso de una herramienta, crear ejemplos en los que el resultado de la herramienta usa coincide 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 particular. En cambio, las guías se basan en instrucciones y ejemplos de instrucciones con ejemplos para determinar cómo se deben usar los valores de los parámetros y cómo se deben decidir cuando se especifican los valores de los parámetros.

Piensa en un agente diseñado para la venta de entradas para eventos con las siguientes guías:

1. Una guía llamada Ticket ordering que realiza pedidos con una herramienta llamado Ticket sales API.
   1. Esta guía acepta un parámetro de entrada con el tipo number y nombre. event_id
   2. La herramienta Ticket sales API espera una solicitud que incluya un event_id.
2. Una guía llamada Event selection que ayuda a los usuarios a seleccionar un evento y, luego, los enruta a Ticket ordering con el parámetro event_id para realizar la compra. tickets.

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 hagan lo siguiente:

• Haz que el parámetro de entrada event_id se especifique con algún valor realista, diferente en cada ejemplo.
• Incluir una acción de uso de la herramienta con un cuerpo de solicitud que incluya el mismo valor event_id realista como se especifica 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 el usuario seleccione un evento con algún tipo de event_id, que es diferente en cada ejemplo.
• Incluye una invocación de la guía de Ticket ordering que establece el event_id. según el mismo event_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.