Conectarse a un agente de Microsoft Foundry (versión preliminar)

Nota:

Este artículo describe características utilizadas en agentes o flujos de agentes alimentados por el arnés estándar.

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Puede conectar un agente de Microsoft Foundry al agente personalizado, lo que le permite llamar a este agente para responder a un usuario o un desencadenador.

Importante

Este artículo contiene la documentación de la versión preliminar de Microsoft Copilot Studio y está sujeto a modificaciones.

Las funciones de vista previa no están diseñadas para uso en producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que pueda tener acceso anticipado y proporcionar comentarios.

Si está creando un agente listo para producción, consulte Información general sobre Microsoft Copilot Studio.

Prerequisites

Antes de conectar un agente de Microsoft Foundry a Copilot Studio, el agente de Foundry debe tener habilitado el punto de conexión del protocolo Activity. Un agente Foundry recién creado expone por defecto solo los extremos de los protocolos Respuestas y A2A . Si el endpoint de Actividad no está habilitado, la conexión a Copilot Studio falla en tiempo de ejecución con un error 400. Más información en Habilitar la A2A entrante en un agente de Foundry.

Actualmente puedes habilitar el endpoint de Actividad solo de forma programática, usando la API REST o el SDK de Python. No hay opción para activarlo desde el portal de Microsoft Foundry. Infórmate más sobre el procedimiento de habilitación en Configurar y comparte a tu agente.

Después de habilitar el punto de conexión Activity, la sección Endpoints del portal de Foundry para el agente sigue mostrando solo Responses y A2A. Esta omisión en la interfaz es esperada y no significa que el cambio haya fallado. La conexión a Copilot Studio funciona después de aplicar la actualización.

Conéctate a un agente de Microsoft Foundry

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

  2. En Conectar a un agente externo, seleccione Microsoft Foundry en los tipos de agente disponibles.

  3. Seleccione la conexión deseada en la lista de conexiones disponibles o cree una nueva conexión entre Microsoft Foundry y el agente de Copilot Studio. Para crear una nueva conexión, debe proporcionar la dirección URL del punto de conexión del proyecto Foundry.

    Nota:

    Al conectarse a los agentes de Microsoft Foundry desde Copilot Studio, solo puede conectarse a los agentes creados en el nuevo portal de Microsoft Foundry. Conectarse a un agente creado en el portal anterior genera un error que indica 404 - Version not found.

  4. Una vez creada la conexión, seleccione Siguiente.

  5. Escriba un Nombre y una Descripción adecuados para el agente del SDK. La descripción debe describir el propósito del agente de Microsoft Foundry, lo que permite que el agente principal comprenda cuándo se debe usar. Para obtener más información, consulte escribir metadatos efectivos.

  6. Escriba el identificador del agente para el agente de Microsoft Foundry al que desea conectarse.

  7. Ajusta la descripción (si es necesario) para que sea más contextual para el agente principal. Por ejemplo, haga que la descripción sea más específica si tiene otras herramientas o agentes en los que las descripciones pueden superponerse. Actualiza la descripción para asegurarte de que Copilot Studio entienda cuándo invocar este agente.

  8. Seleccione Agregar agente.

  9. Una vez creado el agente, puede probarlo inmediatamente. Si necesita ajustar el identificador del agente más adelante, puede hacerlo en la página de detalles seleccionando el agente en la lista Agentes.

Nota:

  • Si tu primera llamada de prueba al agente Foundry conectado falla con un error similar a "El conector 'Azure AI Foundry Agent Service' devolvió un error HTTP con código 400. Error interno: El endpoint del agente <name> no soporta actividad. Por favor, actualice el endpoint del agente para soportar este protocolo.", el agente de Foundry no tiene activado el endpoint del protocolo Activity . Consulta los requisitos previos en este artículo, luego activa el endpoint de Actividad siguiendo Configurar y comparte tu agente en la documentación de Microsoft Foundry.

  • 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.
  • Last updated on