Añadir un agente Agent2Agent (A2A) como agente conectado (Microsoft Copilot)

Use agentes conectados para permitir que su agente principal delegue tareas específicas a agentes especializados. Este artículo te muestra cómo conectar un agente remoto disponible a través del protocolo Agent2Agent (A2A), para que tu agente principal pueda delegarle las tareas.

Note

El entorno utilizado para construir este agente utiliza facturación basada en el uso. Usar, construir, probar y evaluar agentes puede consumir créditos de Copilot. Más información en Resumen de la facturación basada en el uso.

El protocolo A2A es un estándar abierto para la comunicación y colaboración entre agentes. Como es un estándar abierto, puedes conectar agentes que estén alojados fuera de Copilot Studio y construidos sobre otros frameworks, siempre que implementen A2A. Copilot Studio descubre el agente remoto a partir de su tarjeta de agente y luego utiliza el protocolo A2A para delegarle tareas en tiempo de ejecución.

Agrega todos los agentes conectados en el mismo cuadro de diálogo Agregar un agente conectado. Para una visión general de los agentes conectados y cómo funciona el enrutamiento, véase Connected agents overview. Para conectar a otro agente de Copilot Studio, consulta Añadir un agente de Copilot Studio como agente conectado. Para conectar un agente de Microsoft Foundry, consulta Añadir un agente de Foundry como agente conectado.

Prerequisites

  • Un agente creado con el arnés Microsoft Copilot para ser el agente principal. Consulte Crear un agente (versión preliminar).
  • Un agente remoto que implementa el protocolo Agent-to-Agent y es accesible desde Copilot Studio a través de internet público.
  • La URL de la tarjeta de agente del agente remoto, normalmente https://<your-agent-host>/.well-known/agent-card.json.
  • Los detalles de autenticación que requiere el agente remoto, si los requiere. Copilot Studio admite autenticación, clave de API y OAuth 2.0.
  • Para OAuth 2.0, permiso para añadir un URI de redirección al registro de la aplicación que utiliza el proveedor de identidad del agente remoto. Copilot Studio genera la URL de redirección durante el asistente y debes registrarla antes de crear la conexión.

Note

Dado que las conexiones A2A usan la infraestructura del conector personalizado, también puede usarlas para conectarse a agentes de A2A que se ejecutan de forma local o dentro de una red virtual.

Añadir un agente Agent2Agent (A2A)

El asistente te guía a través de tres o cuatro pasos, dependiendo del método de autenticación que elijas:

  • Si eliges Ninguno o clave API: Conéctate a un agente A2A, conéctate al agente A2A, luego revisa y añade.
  • Si eliges OAuth 2.0: Conéctate a un agente A2A, añade URL de redirección, conéctate con el agente A2A, luego revisa y añade.
  1. Inicie sesión en Copilot Studio.

  2. Elija y abra el agente que quiera usar como agente principal.

  3. En la barra de navegación del agente, selecciona la pestaña Construir .

  4. En el panel de componentes, seleccione Agentes conectados para abrir el cuadro de diálogo Agregar un agente conectado.

  5. En el diálogo, selecciona Añadir y luego Añadir agente A2A.

  6. En el paso Conectar a un agente A2A , introduce los datos del agente remoto:

    • URL de la tarjeta del agente: la URL de la tarjeta del agente remoto, por ejemplo https://agent.example.com/.well-known/agent-card.json. Copilot Studio lee la tarjeta para descubrir el endpoint y las capacidades del agente.
    • Nombre: el nombre que se muestra al autor del agente. Si la tarjeta del agente incluye un nombre, Copilot Studio rellena este campo por ti.
    • Descripción: una descripción clara de cuándo debe usarse este agente A2A, de entre 30 y 1.000 caracteres. Si la tarjeta del agente incluye una descripción, Copilot Studio rellena este campo por ti. El orquestador utiliza esta descripción para decidir cuándo enrutar una solicitud al agente, así que hazla específica y evita solapamientos con tus otras herramientas y agentes. Aprende más sobre cómo redactar metadatos efectivos.

    Note

    Si el nombre y la descripción no se rellenan automáticamente, el agente remoto puede no tener una tarjeta de agente, la tarjeta puede estar en una URL diferente a la que has introducido, o Copilot Studio puede no poder acceder a ella. Comprueba primero la URL y prueba a abrir la tarjeta del agente en tu navegador. Si la tarjeta no está disponible, introduce manualmente un nombre y una descripción.

  7. En Autenticación, selecciona cómo Copilot Studio se autentica con el agente remoto y luego completa los detalles del método que elegiste:

    No puedes continuar hasta que los detalles de autenticación estén completos.

  8. Seleccione Siguiente.

  9. Si seleccionaste OAuth 2.0, aparece el paso de Añadir URL de redirección . Copilot Studio crea el conector para el agente A2A, y la plataforma genera una URL de redirección para él. Registra esa URL con tu proveedor de identidad antes de crear la conexión:

    1. Espera a que se llene el campo de la URL de Redirección . El conector debe existir antes de que se genere la URL.
    2. Selecciona el botón de copiar junto al campo para copiar la URL.
    3. En tu registro de la app de OAuth, añade la URL como URI de redirección y guarda el registro de la app.
    4. Seleccione Siguiente.

    Importante

    Si no registras primero la URL de redirección, el primer intento de autorizar la conexión falla. La URL de redirección se genera por conector, así que es específica para este agente A2A y no puede reutilizarse desde otro conector. Si necesitas la URL más adelante, selecciona el agente A2A en Agentes conectados en el panel de componentes para volver a abrirla.

  10. En el paso Conectar al agente A2A , elige la conexión que este agente utiliza para llegar al agente remoto:

    • Selecciona una conexión existente de la lista de conexiones disponibles.
    • Si no hay conexión disponible, crea una nueva conexión. Si el agente remoto utiliza autenticación por clave API, introduces el valor de la clave API al crear la conexión.
  11. Seleccione Siguiente.

  12. En el paso de Revisión y añadir , revisa el nombre, la descripción y la URL de la tarjeta del agente, y luego selecciona Añadir al agente.

  13. Confirma que el agente conectado aparece en Agentes conectados en el panel de componentes.

Si vuelves y cambias la configuración de autenticación en el paso Conectar a un agente A2A, Copilot Studio descarta el conector que se construyó desde los ajustes anteriores. Tienes que registrar una nueva URL de redirección y elegir una conexión de nuevo.

Note

Eres responsable de revisar y probar cuidadosamente los agentes conectados en el contexto de tus casos de uso específicos, y de tomar todas las decisiones y personalizaciones adecuadas. Cuando te conectas con agentes externos a Copilot Studio, eres responsable del uso de dichos agentes. Entre las consideraciones se incluye asegurar:

  • Los flujos de datos, el manejo y el intercambio de datos entre agentes son apropiados para tu caso de uso y cumplen con los requisitos y leyes pertinentes.
  • Los agentes cumplen las normas adecuadas de calidad, fiabilidad, seguridad y confianza.
  • Se proporcionan permisos, límites y aprobaciones apropiados, si es prudente para tu caso de uso.
  • Existen funciones adecuadas de observabilidad, identidad y trazabilidad, así como de supervisión humana.

Configuración de la autenticación de clave de API

Cuando selecciones la clave API, elige dónde Copilot Studio envía la clave seleccionando un tipo de Parámetro:

  • Cabecera: la clave se envía como cabecera de solicitud. En Nombre de la cabecera, introduce el nombre de la cabecera que espera el agente remoto, como x-api-key.
  • Cadena de consulta: la clave se envía como un parámetro de consulta. En la etiqueta de Parámetro, introduce el nombre del parámetro de cadena de consulta que espera el agente remoto.

Introduces el valor de la clave API al crear la conexión, no en este paso. De ese modo, la clave se almacena con la conexión y no es visible en la configuración del agente.

Configuración de la autenticación de OAuth 2.0

Cuando selecciones OAuth 2.0, elige un tipo de configuración:

  • Dinámico: Copilot Studio registra a un cliente con el proveedor de identidad del agente remoto por ti. Introduce la URL de autorización y la URL del token.

  • Manual: usa un registro de la app que ya hayas creado con el proveedor de identidad del agente remoto. Escriba los siguientes valores:

    • ID de cliente: el ID de cliente de tu registro de la app.
    • Secreto del cliente: el secreto del cliente en el registro de tu app.
    • URL de autorización: el punto final de autorización del proveedor de identidad.
    • URL del token: el endpoint del token del proveedor de identidad.
    • URL de token de actualización: el endpoint utilizado para actualizar tokens de acceso.
    • Ámbitos (opcionales): los ámbitos a solicitar, separados por espacios.

Utiliza Dynamic cuando el proveedor de identidad del agente remoto admite el registro dinámico del cliente. Usa Manual cuando necesites controlar el registro de la app, por ejemplo cuando tu proveedor de identidad requiera URI de redirección preregistrada o consentimiento.

Cualquiera de los dos tipos de configuración requiere que registres una URL de redirección con tu proveedor de identidad. Después de seleccionar Siguiente, Copilot Studio crea el conector y muestra la URL de redirección generada en el paso Añadir URL de redirección.

Encontrar la URL de redirección más tarde

Si cierras el asistente o pierdes la URL de redirección, puedes verla de nuevo en cualquier momento:

  1. En la pestaña Build, selecciona el agente A2A en Agentes conectados en el panel de componentes.

  2. En el cuadro de diálogo Editar agente A2A , copie el valor en el campo de URL de Redirección .

El campo URL de Redirección aparece solo para agentes A2A que usan OAuth 2.0.

Cómo el orquestador enruta el mensaje al agente A2A

Después de añadir el agente A2A, el tiempo de ejecución de orquestación determina automáticamente cuándo delegar en él. La decisión de enrutamiento se basa en:

  • Nombre y descripción del agente conectado
  • Mensaje del usuario y contexto de la conversación
  • Instrucciones de su agente principal

Tip

Escribe una descripción clara y específica para el agente A2A para que el orquestador pueda determinar con precisión cuándo enrutar las solicitudes hacia él. Evite que las descripciones de los agentes conectados se superpongan.

Delegación de prueba

Después de añadir al agente A2A:

  1. En la barra de navegación del agente, seleccione la pestaña Versión preliminar.

  2. Envía un mensaje que coincida con el dominio del agente A2A.

  3. Verifica que la respuesta proviene del agente de A2A y sea adecuada.

  4. Envía un mensaje fuera del dominio del agente A2A para confirmar que tu agente principal lo gestiona.

Si necesitas cambiar el nombre o la descripción más adelante, edita el agente conectado desde el panel de componentes. Consulta la sección Gestionar agentes conectados en un agente.

Solucionar problemas de conexión

Problema Elementos que se deben comprobar
Autorizar la conexión falla con un error de redirección en el URI La URL de redirección que generó Copilot Studio no está registrada con tu proveedor de identidad. Copia la URL desde el cuadro de diálogo Editar agente A2A , añádela a tu registro de la app y luego autoriza la conexión de nuevo.
El campo URL de Redirección permanece vacío en el asistente El conector aún se está creando. Si el paso muestra un error en su lugar, selecciona Reintentar.
El nombre y la descripción no se completan a partir de la ficha del agente Comprueba que la URL de la tarjeta del agente sea correcta y que Copilot Studio pueda acceder a la tarjeta. Introduce el nombre y la descripción manualmente si la tarjeta no está disponible.
La conexión que creaste ya no funciona después de modificar el asistente Cambiar la configuración de autenticación descarta el conector creado con la configuración anterior. Registra la nueva URL de redirección y elige una conexión de nuevo.