Añadir un agente de Foundry como agente conectado (GitHub 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 Microsoft Foundry existente para que tu agente principal pueda transferirle tareas.

Note

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

Puede añadir todos los agentes conectados desde el mismo cuadro de diálogo Añadir 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 remoto a través del protocolo Agent2Agent (A2A), consulte Añadir un agente A2A como agente conectado. Para conectar un agente construido con el SDK de agentes de Microsoft 365, consulte Añadir un agente SDK de agentes de Microsoft 365 como agente conectado.

Prerequisites

  • Un agente creado con el arnés GitHub Copilot para ser el agente principal. Consulte Crear un agente (versión preliminar).
  • Un agente existente de Foundry creado en un proyecto en el portal de Microsoft Foundry, con el protocolo de Actividad activado y el ID de Agente del agente disponible. Los agentes de Foundry no tienen activado el protocolo de Actividad por defecto. Consulta Habilitar el protocolo de actividad en tu agente de Foundry.
  • La URL del endpoint de Azure AI Project para el proyecto que aloja el agente de Foundry.
  • Permiso para acceder al proyecto Foundry. La conexión se autentica con el inicio de sesión de tu usuario Microsoft Entra ID.

Note

Solo puedes conectarte a agentes creados en el portal actual de Microsoft Foundry. Conectarse a un agente creado en el portal anterior devuelve un error 404 - Version not found.

Añadir un agente de Foundry

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

  6. En el paso Connect to Fundición de IA de Azure, elige la conexión que utiliza este agente para acceder a Microsoft Foundry:

    • Selecciona una conexión existente de la lista Conexión.
    • Si no hay conexión disponible, selecciona Crear nueva conexión y continúa al siguiente paso.

  7. Si estás creando una nueva conexión, introduce los detalles de la conexión y luego selecciona Crear:

    • Nombre de mostrar (opcional): un nombre que te ayude a identificar esta conexión más adelante.
    • Tipo de autenticación: Inicio de sesión de usuario con Microsoft Entra ID. Este valor se establece automáticamente.
    • Azure AI Project Endpoint: la URL del endpoint del proyecto de Foundry que aloja el agente.

  8. Vuelve al paso Conectar a Fundición de IA de Azure, confirma que tu conexión está seleccionada y luego selecciona Siguiente.

  9. En el paso de Revisión y Añadir , introduce los datos del agente de Foundry que quieres conectar y luego selecciona Añadir al agente:

    • Nombre: el nombre que se muestra al autor del agente.
    • Descripción: una descripción clara de cuándo debe utilizarse este agente de Foundry. 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. Para obtener más información, consulte escribir metadatos efectivos.
    • ID de agente: el ID del agente de Foundry con el que quieres conectarte.

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

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.

Activa el protocolo de Actividad en tu agente de Foundry

Copilot Studio se comunica con un agente Foundry conectado utilizando el protocolo Activity. Los agentes de Foundry no tienen este protocolo activado por defecto, así que debes activarlo antes de que tu agente principal pueda intercambiar mensajes con el agente de Foundry. Si el protocolo Activity no está activado, aún puedes añadir la conexión, pero llamar al agente de Foundry falla.

Puedes activar el protocolo de actividad de cualquiera de las siguientes formas:

  • Publica el agente de Foundry en Microsoft 365 o Microsoft Teams. Cuando publicas un agente de prompts en Microsoft 365 o Teams, el protocolo de Actividad y el esquema de autorización requerido BotServiceRbac se activan automáticamente. Elige esta opción si ya planeas publicar el agente en esos canales.

  • Actívala manualmente con una llamada a la API REST. Si no publicas el agente en Microsoft 365 o Teams, llama a la API REST de Foundry Agents - Update agent para añadir el activity protocolo y el BotServiceRbac esquema de autorización al agente.

Para más información sobre cómo configurar y compartir tu agente Foundry, consulta Configurar y compartir tu agente Microsoft Foundry.

Habilitar el protocolo Activity con una llamada a la API REST

Invoca la API REST de Foundry Agents - Update agent. Sustituye {{endpoint}}, {{agent_name}}, y {{token}} por el endpoint, nombre del agente y token de acceso para tu proyecto Foundry.

Importante

Mantén responses y Entra en las listas. Eliminarlos interrumpe la charla con el agente desde el portal de Foundry o SDK.

PATCH {{endpoint}}/agents/{{agent_name}}?api-version=v1
Authorization: Bearer {{token}}
Content-Type: application/merge-patch+json
Foundry-Features: AgentEndpoints=V1Preview

{
    "agent_endpoint": {
        "protocols": [
            "responses",
            "activity"
        ],
        "authorization_schemes": [
            {
                "type": "Entra",
                "isolation_key_source": {
                    "kind": "Entra"
                }
            },
            {
                "type": "BotServiceRbac"
            }
        ]
    }
}

Cómo el orquestador enruta al agente de Foundry

Después de añadir el agente de Foundry, 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 de Foundry 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 el agente de Foundry:

  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 de Foundry.

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

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

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

  • Se actualizó por última vez el