Conectarse a otros agentes desde un agente declarativo

Cuando los usuarios interactúan con un agente declarativo en Microsoft 365 Copilot Chat, puede conectarse a otros agentes para recuperar información adicional o realizar acciones. Estas conexiones se declaran en el manifiesto del agente enumerando los identificadores de título del agente en la worker_agents propiedad. En tiempo de ejecución, Copilot Chat actúa como el agente que media en la interacción: los usuarios ven el intercambio de agente a agente, pero no necesitan seleccionar los agentes conectados.

Cuando un usuario interactúa con un agente declarativo, el agente puede delegar parte de la tarea a un agente conectado. Microsoft 365 Copilot evalúa los agentes conectados declarados en el manifiesto y selecciona uno en función de la tarea actual y el nombre, la descripción y las indicaciones de ejemplo del agente conectado. Copilot envía una solicitud de texto al agente conectado seleccionado, recibe una respuesta de texto e incorpora esa respuesta en la interacción continua del agente declarativo con el usuario.

Cuándo usar agentes conectados

Use agentes conectados para separar o combinar agentes entre funciones o equipos de desarrollo.

Expandirse más allá de lo que un agente puede lograr

Los modelos de lenguaje de gran tamaño (LLM) tienen una ventana de contexto útil limitada y un conjunto de funcionalidades. La confiabilidad de un solo agente de LLM comienza a disminuir a medida que se recuperan más documentos o se habilitan herramientas. Si un agente tiene una calidad inferior después de agregar más conocimientos o capacidades, divida algunas de esas capacidades en otro agente y conéctese a él. El agente existente envía solo la información sobre la tarea que el agente conectado necesita para realizar su parte. El agente conectado funciona en su propia ventana de contexto, libre de otros documentos o capacidades que se encuentran en la conversación del usuario.

Integración con agentes desarrollados externamente

Los agentes declarativos pueden facilitar el trabajo con otros equipos de desarrollo. Cada equipo de desarrollo puede centrarse en las capacidades y la calidad de su agente, utilizando agentes conectados para integrarse con otros agentes. Al igual que con los microservicios, cada agente se puede desarrollar sin afectar a otros agentes. A diferencia de los microservicios, los agentes pueden continuar interactuando entre sí incluso cuando cambian sus interfaces.

Comparta las funcionalidades del agente en varios escenarios

Un agente puede funcionar bien con un conjunto de documentos y acciones, pero sigue siendo difícil para los usuarios. Considere un agente que comprende las tablas y los datos de una base de datos relacional de clientes y ventas. Este agente puede ser útil tanto para que los supervisores de tienda administren el inventario como para que los analistas de negocios informen a los ejecutivos. Si este agente pudiera conectarse a un agente adaptado a los supervisores de la tienda con iniciadores e instrucciones de conversación, y también a un agente adaptado a los analistas de negocios. Ambos tipos de usuarios pueden sacar más partido al usar agentes adaptados a su escenario.

Habilitación de agentes conectados

Debe registrar los agentes conectados en el registro de agentes de Microsoft Agent 365. Conéctese a otros agentes incluyendo los identificadores de título de los agentes en el manifiesto del agente declarativo existente. El otro agente debe ser un agente declarativo o tener una tarjeta de agente Agent2Agent registrada.

En primer lugar, obtenga el identificador de título del agente que va a conectar. El identificador de título de un agente es una cadena de una sola letra, un carácter de subrayado y un GUID. Para un agente declarativo, búsquelo en la salida del comando Aprovisionar en el Kit de herramientas de agentes de Microsoft 365 o en el modo de desarrollador. Para un registro de agente de Microsoft 365, es propiedad id del objeto agentRegistration.

Agregue el identificador de título a la propiedad worker_agents como archivo id. La propiedad se agregó en el worker_agents esquema de agente declarativo versión 1.6.

Autenticación y autorización

La conexión a un agente declarativo se basa en la autenticación existente del usuario para Microsoft 365 Copilot, ya que el agente declarativo se ejecuta dentro de Microsoft 365 Copilot Chat. Para los agentes externos registrados en Microsoft Agent 365, el registro del agente debe declarar cómo Microsoft 365 Copilot autentica en el agente externo. En lugar de incrustar la configuración de autenticación directamente en el registro del agente, el registro hace referencia a un registro de autenticación existente a través del authorization objeto en el agentRegistrationarchivo . Esta separación permite que la configuración de autenticación se administre independientemente de las definiciones de agente. El diseño refleja el de los manifiestos de complementos de API.

Sintaxis

{
  "type": "None | OAuthPluginVault",
  "referenceId": "{string}"
}

La type propiedad especifica el esquema de autenticación utilizado por el agente externo. OAuthPluginVaultusa un registro de SSO de Microsoft Entra. Este referenceId es el valor generado en el Microsoft Entra SSO registration ID portal para desarrolladores de Teams. Consulte Usar el portal para desarrolladores de Teams para obtener más detalles.

Si un usuario puede usar el agente conectado se determina de forma separada de la autenticación. Los usuarios deben tener acceso al agente conectado, ya sea adquiriéndolo ellos mismos o a través de la implementación del administrador. Los administradores deben instalar agentes externos registrados en Microsoft Agent 365 para el usuario.

Procedimientos recomendados

Los agentes declarativos eligen a qué agentes conectarse en función de las indicaciones de namedescriptionejemplo y , del agente conectado. Para un agente declarativo, las consultas de ejemplo son el text campo del conversation_starters manifiesto. Para un agentRegistration, es la examples propiedad del AgentSkill objeto en la tarjeta de agente. La descripción del agente debe describir tanto a los humanos como a los agentes lo que el agente puede hacer. Por ejemplo, considere esta descripción para un agente que trabaja con datos estructurados sobre ventas de videojuegos.

A comprehensive video game sales analytics agent that provides detailed insights into
gaming industry data across multiple dimensions.
Analyze top-performing games, consoles, genres, and publishers with regional breakdowns
for North America, Europe, Japan, and global markets.
Discover best-selling titles of all time, platform-specific performance metrics, genre
popularity trends, and yearly sales patterns.
Compare sales figures across different publishers, identify market leaders by region,
and explore gaming industry evolution over time.
Whether you need to understand which games dominated specific platforms, analyze
publisher market share through visualizations like histograms, or track sales performance
across different years and regions, this agent delivers comprehensive gaming market
intelligence with precise data-driven answers.

Las indicaciones de ejemplo deben informar tanto a los usuarios como a los agentes de los tipos de indicaciones que puede controlar el agente. Dado que los usuarios pueden usar diferentes términos para el mismo concepto, considere la posibilidad de variar la redacción de los temas de conversación. Por ejemplo, cuando se trabaja con casos legales, los buenos iniciadores de conversaciones también pueden usar términos "asunto", "caso", "cliente" y "problema". Los agentes conectados solo usan el text campo de un iniciador de conversación.

Limitaciones

• El agente activo envía texto solo a un agente conectado. Los agentes declarativos devuelven texto o tarjetas adaptativas. Los agentes con tarjetas de agente Agent2Agent devuelven archivos binarios de texto, archivos binarios de imagen en base64 y archivos binarios en base64.

• Mientras se le pide al usuario que confirme las llamadas al complemento API del agente conectado, las tarjetas adaptables se envían al agente activo. El usuario no ve la tarjeta adaptable ni puede usar un cuadro de diálogo. Sin embargo, el agente activo procesa el contenido de datos de la tarjeta adaptable.

Contenido relacionado

• Compilar agentes con Visual Studio Code
• Probar y depurar agentes en Copilot Studio