Administrar entradas y salidas de tema

Note

Este artículo describe características utilizadas en agentes o flujos de agentes alimentados por el arnés estándar.

Los temas pueden tener parámetros de entrada y salida. Cuando un tema redirecciona a otro tema, puede usar estos parámetros para pasar información entre los temas.

Si tu agente utiliza orquestación generativa, puede rellenar automáticamente las entradas antes de ejecutar un tema usando el contexto de la conversación o generar preguntas para preguntar al usuario por los valores. Este comportamiento es similar a cómo funciona el relleno generativo de ranuras en las herramientas.

Los agentes que utilizan orquestación generativa pueden generar una respuesta contextual como salida de un tema. En tales casos, no es necesario configurar un mensaje literal desde el propio tema.

Las entradas y salidas de temas pueden compartir valores con otros temas y herramientas dentro del mismo plan generado.

Añadir entradas y salidas

Para añadir entradas o salidas para un tema, selecciona Detalles en la barra de herramientas situada en la parte superior del lienzo de autoría. Alternativamente, selecciona Detalles en el menú contextual de un tema en la página de la lista de Temas .

En el panel de detalles del tema , puedes seleccionar la pestaña Entradas o Salidas y luego seleccionar Crear una nueva variable para crear nuevas variables de entrada o salida.

Para cada parámetro de entrada y salida, debe introducir un nombre, seleccionar un tipo de datos e introducir una descripción para la variable correspondiente.

Si el agente usa IA generativa para decidir cómo responder a los usuarios, hay más propiedades disponibles para las variables de entrada. Específicamente, ¿cómo rellenará el agente esta entrada? determina cómo el agente llena esta variable con un valor antes de ejecutar el tema. De forma predeterminada, cada entrada está configurada para Rellenar dinámicamente con la mejor opción. El agente intenta obtener el valor a partir del contexto disponible, como el mensaje del usuario o una conversación previa. Si no se encuentra un valor adecuado, el agente genera una pregunta para pedirle al usuario un valor. Puede optar por anular una entrada con un valor en lugar de preguntarle al usuario. Para reemplazar un parámetro de entrada, seleccione Establecer como valor en ¿Cómo rellenará el agente esta entrada? e introduzca el valor deseado. Este valor puede ser un valor literal, una variable existente o una fórmula de Power Fx.

Para asegurarse de que el agente captura el tipo de valor correcto para la entrada, también debe especificar un tipo de entidad en Identificar como.

Captura de pantalla del panel Detalles con una nueva variable de entrada agregada

Las configuraciones adicionales pueden configurarse para las entradas con el fin de controlar el comportamiento del agente al solicitar un valor o validar una respuesta del usuario.

Uno de estos ajustes, Debería solicitar al usuario, solo está disponible para entradas de tema. Determina si el agente debe intentar rellenar la variable con un valor antes de ejecutar el tema. Esta propiedad se selecciona por defecto.