Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Un agente secundario es un agente ligero que existe dentro del contexto del agente principal. Los agentes secundarios permiten agrupar lógicamente herramientas, instrucciones y conocimientos en subagentes claramente definidos dentro de un agente mayor. Son ideales para casos de uso únicos que responden a una única intención o completan una sola tarea. Este artículo explica cómo crear y administrar un agente secundario.
Crear un agente secundario
Vaya a la página Agentes del agente principal y seleccione Agregar un agente.
Seleccione Nuevo agente secundario.
Escriba un nombre distintivo para el nuevo agente secundario.
Determine cuándo se debe usar tu agente. De forma predeterminada, los agentes responden a usuarios o desencadenadores, en función de su descripción.
- Si desea usar el comportamiento predeterminado (El agente elige: en función de la descripción), escriba una breve descripción del propósito del agente.
- De lo contrario, expanda la lista en ¿Cuándo se usará? y seleccione el comportamiento deseado. Para obtener más información sobre los comportamientos admitidos, consulte Determinar cuándo usar el agente.
Escriba instrucciones claras que desea que siga el agente cuando se invoque. Para hacer referencia a herramientas, variables o agregar fórmulas de Power Fx en las instrucciones, escriba una barra diagonal (/) y seleccione la opción deseada en el menú que aparece.
Importante
Al hacer referencia a las herramientas existentes en las instrucciones, decida si la herramienta debe ser accesible directamente por el agente principal o solo cuando se llame explícitamente dentro de las instrucciones. Limitar el uso de una herramienta a referencias de instrucciones explícitas ayuda a evitar confusiones cuando existen herramientas o agentes similares. Por ejemplo, si tiene un agente de "Comprobación del saldo de la cuenta" y una herramienta similar "Obtener saldo de cuenta", restrinja la herramienta a la que solo llame el agente para evitar superposición. Para restringir que una herramienta solo esté disponible cuando se hace referencia a otro agente, desactive Permitir que el agente decida dinámicamente cuándo usar esta propiedad de herramienta en la sección Detalles adicionales de la página de detalles de la herramienta.
Opcionalmente, agregue conocimientos y herramientas que solo este agente secundario pueda usar:
- En la sección Conocimientos , seleccione Agregar y continúe de la misma manera que cuando agregue conocimientos al agente principal.
- En la sección Herramientas , seleccione Agregar y continúe de la misma manera que cuando agregue herramientas al agente principal.
Si aún no desea que este agente esté activo, desactive Habilitado. Puede hacer que el agente secundario esté activo más adelante.
Seleccione Guardar.
Administrar entradas y salidas
De forma predeterminada, un agente secundario recibe una tarea de lenguaje natural para realizar desde el agente principal cuando el agente lo llama. A continuación, cuando completa su tarea, devuelve un resumen del lenguaje natural de lo que sucedió durante su ejecución. En algunos casos, es posible que desee especificar valores de entrada y salida más explícitos para el agente.
Para administrar entradas
Vaya a los detalles del agente secundario.
Desplácese hacia abajo hasta la sección Entradas.
Para agregar una entrada, seleccione Agregar entrada. Defina un Nombre para mostrar y una Descripción, que ayudan al agente a comprender el propósito de la entrada para que pueda rellenar la entrada con un valor relevante al llamar a este agente.
Seleccione un tipo de datos.
Opcionalmente, seleccione Hacer esta entrada obligatoria para pedir que la entrada tenga un valor antes de poder llamar al agente.
Seleccione Guardar.
Nota
Opcionalmente, puede expandir la sección Opciones avanzadas y configurar otras opciones para la entrada, incluida la opción Debe preguntar al usuario. Si la configuración está habilitada, el agente solicita explícitamente al usuario final un valor para la entrada, si no se encuentra uno desde el contexto disponible. Consulte más detalles sobre la otra configuración para las entradas.
Para administrar la lista de salidas
Vaya a los detalles del agente secundario.
Desplácese hacia abajo hasta la sección Salidas.
Para ver la lista actual de salidas, expanda la sección Avanzadas en la sección Salidas.
Para agregar una salida, seleccione Agregar salida. Defina un Nombre para mostrar y una Descripción, que ayudan al agente a comprender el propósito de la salada para que pueda rellenarla con un valor relevante al devolver valores al llamar al agente.
Seleccione un tipo de datos.
Seleccione Guardar.
En la sección Salidas, también puede elegir que se envíe un mensaje al usuario inmediatamente después de que finalice el agente secundario. Para enviar el mensaje, cambie la selección Tras ejecutar.
Determinar cuándo usar el agente
De forma predeterminada, los agentes secundarios responden a una consulta de usuario en función de su descripción. También puede configurar agentes secundarios para interceptar otros eventos y responder a ellos en ¿Cuándo se usará?.
| Evento | Descripción |
|---|---|
| Se recibe un mensaje | Se llama cuando se recibe una actividad de mensaje (el tipo de actividad más común). Se recibe cuando un usuario escribe o dice algo al agente. De forma predeterminada, el agente responde a los mensajes. Para limitar la respuesta del agente a un tipo específico de mensaje, use la lista Tipo de actividad en Detalles adicionales. |
| Se produce un evento de cliente personalizado | Llamada cuando se recibe un evento de actividad. De forma predeterminada, el agente responde a cualquier evento. Para limitar la respuesta del agente a un evento específico, use la propiedad Nombre del evento en Detalles adicionales. |
| Se produce una actividad | Se invoca cuando se recibe una actividad de cualquier tipo. Para limitar la respuesta del agente a un tipo específico de actividad, use la lista Tipo de actividad en Detalles adicionales. |
| La conversación cambia | Se llama cuando se recibe una actividad de actualización de conversación. Por ejemplo, Teams envía una actividad de este tipo cuando un usuario se une a una conversación. |
| Se invoca | Llamada cuando se invoca un evento de actividad. Lo más comúnmente recibido del canal de Teams, cuando el usuario interactúa con una aplicación de Teams, como un mensaje o una extensión de búsqueda. |
| Se redirige a | Se llama cuando se invoca al agente explícitamente en un tema. |
| El usuario está inactivo durante un tiempo | Se llama cuando el usuario no ha interactuado con el agente principal después de un período de tiempo configurado. Seleccione el umbral de inactividad deseado en la lista Duración de inactividad en Detalles adicionales. |
| Se completa un plan | Se llama cuando el agente principal termina de ejecutar todos los pasos planeados para responder a una consulta de usuario o a un desencadenador autónomo. |
| Se va a enviar una respuesta generada por IA | Se llama cuando el agente principal genera una respuesta para un usuario después de llamar a uno o varios temas, herramientas u orígenes de conocimiento. Use la variable del sistema Response.FormattedText para ver la respuesta generada. Establezca la ContinueResponse variable en false si desea impedir que se envíe la respuesta de orquestación (es decir, si modifica el mensaje y envía el suyo propio mediante un nodo Mensaje ). |
Otros detalles
Dependiendo de la selección de ¿Cuándo se usará?, es posible que haya más propiedades disponibles. Las propiedades siguientes siempre están disponibles.
Condición
Especifique las condiciones que se deben cumplir para que se llame al agente. Por ejemplo, es posible que quiera que solo se llame al agente si el canal usado por un empleado es Microsoft Teams.
Si necesita condiciones más complejas, puede cambiar al editor de fórmulas Power Fx: seleccione Generador y, a continuación, seleccione Fórmula.
Prioridad
Se puede activar más de un agente para una única actividad entrante, como un mensaje. De forma predeterminada, la opción que seleccione para ¿Cuándo se usará? determina el orden de activación de los agentes.
Los agentes secundarios y las temáticas comparten el mismo conjunto de activadores o eventos a los que pueden responder. Si un agente y un tema están configurados para responder al mismo evento, como la inactividad del usuario, use la propiedad priority para determinar cuál va primero.
Orden de ejecución:
- Se produce una actividad
- Se recibe un mensaje / Un evento de cliente personalizado se produce / La conversación cambia / Se invoca
- El agente elige
Si se debe llamar a varios agentes o temas en función del mismo tipo de evento, se les llama en el orden de creación (primero más antiguo).
Puede establecer explícitamente la propiedad Prioridad . Los valores de rango más bajos indican una prioridad más alta.