Agregar un agente secundario

Un agente hijo 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 hijo

1. Vaya a la página Agentes del agente principal y seleccione Agregar un agente.

2. Seleccione Nuevo agente secundario.

3. Escriba un nombre distintivo para su nuevo agente hijo.

4. 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 Determine cuándo usar su agente.

5. 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 referenciar herramientas existentes en las instrucciones de tu subagente, decide si la herramienta debe ser accesible directamente por tu agente principal o solo cuando se llame explícitamente dentro de las instrucciones del subagente. Limitar el uso de una herramienta a referencias explícitas de instrucciones ayuda a evitar confusiones entre orquestadores 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 el uso de una herramienta para que solo esté disponible cuando se haga referencia desde otro agente, desactive la opción Permitir que el agente decida dinámicamente cuándo usar esta herramienta en la sección Detalles adicionales de la página de la herramienta.

6. Opcionalmente, añadir conocimientos y herramientas que solo este agente hijo pueda utilizar:

   • 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.

7. Si aún no desea que este agente esté activo, desactive Habilitado. Puede hacer que el agente secundario esté activo en un momento posterior.

8. 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. Cuando completa su tarea, devuelve un resumen en lenguaje natural de lo ocurrido durante su ejecución. En algunos casos, es posible que desee especificar valores de entrada y salida más explícitos para el agente.

Configurar entradas y recolección de entradas

1. Desde la página de agentes de tu agente parental, selecciona a tu agente hijo.

2. Desplázate hasta la sección de Entradas .

3. 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.

4. Seleccione un tipo de datos.

5. Opcionalmente, seleccione Hacer esta entrada obligatoria para pedir que la entrada tenga un valor antes de poder llamar al agente.

6. Seleccione Guardar.

Configuraciones avanzadas de entrada

Selecciona Avanzado para ampliar la sección y mira los otros ajustes que puedes configurar para la entrada.

La configuración avanzada incluye las siguientes configuraciones relacionadas con cómo el agente rellena el valor de entrada al llamar al agente hijo:

• Debe avisar al usuario: Si esta configuración está activada, el agente solicita explícitamente al usuario final un valor para la entrada si el agente no puede encontrar el valor en el contexto disponible. Esto es útil cuando quieres asegurarte de que el agente obtenga un valor para esta entrada, incluso si el agente que llama no proporciona uno o no tiene el contexto relevante para completarlo. Cuando esta opción está activada, el agente hijo genera una pregunta para pedir al usuario la información requerida, lo cual puede ayudar a mejorar la precisión de la respuesta del agente.
• Prompt - Personalizar: Selecciona para personalizar la redacción específica de un prompt para la recopilación y lograr un control más preciso y determinado.
• Cuántas reprompts: Especifica cuántas veces el agente debe volver a pedir al usuario un valor para esta entrada si el valor proporcionado no es válido. Esto es útil para asegurar que el agente obtenga un valor válido para esta entrada. Puedes seleccionar hasta dos reprompts.
• Prompt de reintentar - Personalizar: Seleccione para personalizar la redacción específica de los mensajes para repeticiones cuando el valor proporcionado no cumpla con las condiciones especificadas, para un control más determinista.
• Condición: Especificar condiciones que la entrada proporcionada debe cumplir para ser consideradas válidas.
• Prompt de condición no cumplida: Personaliza una redacción específica de la indicación para pedir al usuario un valor diferente cuando el valor proporcionado no cumpla las condiciones especificadas.
• Acción si no se encuentra ninguna entidad: Especifica la acción que el agente debe realizar si no puede encontrar un valor para esta entrada en el contexto disponible o en el prompt. Selecciona si escalar, establecer la variable en un valor específico o dejar el valor vacío.
• Mensaje de no se encuentra entidad: Si seleccionas que el agente escale cuando no se encuentre valor para esta entrada, personaliza el mensaje que el agente envía al usuario.

Configurar las salidas de los agentes hijos y el comportamiento de completación

En Salidas, puedes configurar los valores de salida que tu agente hijo devuelva al agente padre cuando termine. También puedes configurar el comportamiento del agente padre después de que el agente secundario termine.

Configurar el comportamiento del agente principal tras la finalización del agente secundario

Puede especificar el comportamiento del agente padre después de que el agente hijo termine de ejecutarse bajo la categoría "Después de ejecutarse" en la sección Salidas:

• No responder: Por defecto, el agente padre continúa con el siguiente paso de su plan de orquestación después de que el agente hijo termine y devuelva todos los resultados al agente padre. También puedes seleccionar que el agente principal envíe un mensaje al usuario inmediatamente después de que el agente hijo termine, antes de continuar con el siguiente paso de su plan de orquestación seleccionando alguna de las otras opciones.
• Escribe la respuesta con IA generativa: El agente padre envía un mensaje al usuario con una respuesta de IA generativa inmediatamente después de que el agente hijo termine, usando las salidas del agente hijo como contexto para la respuesta.
• Enviar respuesta específica: El agente padre envía un mensaje específico al usuario inmediatamente después de que el agente hijo termine, independientemente de las salidas del agente hijo. Al seleccionar esta opción, puedes personalizar el contenido del mensaje.
• Enviar una tarjeta adaptativa: El agente padre envía al usuario una tarjeta adaptativa inmediatamente después de que el agente hijo haya terminado. Cuando seleccionas esta opción, puedes personalizar el contenido adaptativo de la carta.

Configuración de salidas

1. Vaya a los detalles del agente secundario.

2. Desplázate hasta la sección de Resultados.

3. Para ver la lista actual de salidas, expanda la sección Avanzadas en la sección Salidas.

4. Para agregar una salida, seleccione Agregar salida. Defina un Nombre para mostrar y una Descripción, que ayuden al agente a comprender el propósito de la salida para que pueda rellenarla con un valor relevante al devolver valores al agente que llama.

5. Seleccione un tipo de datos.

6. 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 de 'Después de 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á?.

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 desee 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.

Captura de pantalla que muestra la opción para ir al editor de fórmulas.

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 en que se disparan 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 de prioridad para determinar a cuál se da prioridad.

Orden de ejecución:

1. Se produce una actividad
2. Se recibe un mensajeUn evento de cliente personalizado se produceLa conversación cambiaSe invoca
3. 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 la propiedad de Prioridad explícitamente. Los valores de rango más bajos indican una prioridad más alta.

Uso de agentes y herramientas por parte de niños

Los agentes de Copilot Studio que usan orquestación generativa tienen limitaciones en el número máximo y recomendado de herramientas que pueden utilizar. Para más información, véase Limitaciones en las herramientas en los agentes.

Cuando se llama a un agente hijo, utiliza sus propias herramientas y conocimientos para responder al usuario o al evento. Como los agentes hijos tienen su propia orquestación, tienen sus propios límites respecto al número de herramientas, independientes de los límites del agente principal.

El límite separado es uno de los beneficios de usar agentes hijos: puedes agrupar lógicamente herramientas y conocimientos en agentes más pequeños que se centran en tareas específicas, sin afectar los límites generales del agente principal. Sin embargo, existe una compensación en la latencia añadida debido a la capa adicional de orquestación.