Administrar la puerta de enlace de herramientas

Conecta Azure AI Gateway o una pasarela LiteLLM a Microsoft Agent 365 para descubrir y gobernar los servidores Model Context Protocol (MCP) registrados en la pasarela. El Agente 365 integra los servidores MCP registrados en la experiencia de Herramientas, donde los administradores pueden revisarlos y gobernarlos, monitorizar la actividad de los servidores MCP y configurar protecciones de seguridad compatibles para llamadas a herramientas MCP.

Actualmente, Agent 365 soporta Azure AI Gateway y LiteLLM. Cada pasarela requiere su propio proceso de conexión y configuración.

Utiliza la sección de tu pasarela para completar la configuración de la conexión y la configuración de protección. Luego utiliza los pasos compartidos de descubrimiento y gobernanza:

Important

  • Esta característica se encuentra en versión preliminar.
  • Las características en versión preliminar no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están sujetas a condiciones de uso adicionales y están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

Connect Azure AI Gateway

Utiliza esta sección para conectar Azure AI Gateway y, si es necesario, configurar la protección contra llamadas a herramientas.

Requisitos previos de Azure AI Gateway

Antes de conectar Azure AI Gateway, asegúrate de que la pasarela esté configurada, que tengas el rol de Administrador Global en Microsoft 365 y que sus servidores MCP estén registrados. Para requisitos previos detallados, configuración y guía de gobernanza, consulte Gobernar herramientas con Microsoft Agent 365 y Azure API Management (versión preliminar).

Conecta la puerta de enlace de Azure a Microsoft 365

Note

Debes tener el rol de Administrador Global para conectar Azure AI Gateway. El rol de Administrador de IA no soporta esta operación.

  1. Inicie sesión en el centro de administración de Microsoft 365 como administrador global.
  2. Vaya a Agentes>.
  3. Seleccione Gateways.
  4. Junto a Microsoft Azure, activa el interruptor para conectar un servicio de Azure API Management o Azure AI Gateway.
  5. Revise y acepte los permisos solicitados.

Necesitas dar consentimiento una vez por tenant, y se aplica a todos los servidores MCP en la pasarela conectada. Los servidores individuales no requieren un consentimiento independiente.

Note

Después de conectar la pasarela, el Agente 365 descubre los servidores MCP registrados en ella y los pone a disposición en la página de Herramientas. El descubrimiento puede tardar unos minutos. Ve a Agentes>Herramientas y actualiza la página para ver los servidores MCP descubiertos. Para gestionar los servidores MCP descubiertos, consulte Descubrir y gobernar servidores MCP.

Proteger las llamadas a la herramienta de Azure AI Gateway con Microsoft Defender

Para proteger las llamadas a herramientas a través de Azure AI Gateway, configura la política de protección contra amenazas de la herramienta Agent 365 en el portal de AI Gateway. La política utiliza Microsoft Defender y Microsoft Purview para evaluar las solicitudes de herramientas y resultados.

Para requisitos previos y pasos de configuración específicos de la pasarela, consulta Proteger las llamadas a herramientas con Defender y Purview en la categoría de AI Gateway (vista previa). Esta protección requiere el nivel de AI Gateway en Azure API Management y un token de usuario delegado de Microsoft Entra ID. No se admiten llamadas de servicio a servicio solo de aplicación.

Para monitorizar la actividad del servidor MCP, consulte Supervisar y observar la actividad del servidor MCP.

Conecta LiteLLM

Microsoft Agent 365 te permite conectarte a una pasarela LiteLLM para descubrir y gobernar sus servidores MCP registrados y proteger las llamadas a la herramienta MCP. LiteLLM es una pasarela de IA de terceros y no está construida ni soportada por Microsoft. Para información sobre LiteLLM y el registro de servidores MCP con su gateway, consulte LiteLLM gateway en la documentación de LiteLLM.

Requisitos previos para LiteLLM

Antes de comenzar, asegúrese de que:

  • Tienes acceso a una pasarela LiteLLM con servidores MCP registrados.
  • Tienes un nombre de pasarela, una URL de gateway y una clave API para el proxy de LiteLLM.
  • Tienes el rol de Administrador Global en Microsoft 365 para acceder al Centro de administración de Microsoft 365. Este requisito se aplica a Microsoft 365, no a roles en LiteLLM.

Las siguientes secciones explican cómo conectar el gateway LiteLLM y configurar la protección para las llamadas a herramientas MCP. Tras la configuración, utiliza los pasos compartidos para descubrir y gobernar los servidores MCP.

Conecta la pasarela LiteLLM a Microsoft 365

  1. Inicia sesión en el Centro de administración de Microsoft 365 con el rol de administrador de Microsoft 365 listado en los requisitos previos.
  2. Ve a Agentes>Configuración>Gateways.
  3. En LiteLLM Gateway, selecciona Conectar gateway.
  4. Escribe la siguiente información:
    • Nombre de la pasarela: Un nombre descriptivo para identificar esta pasarela en el centro de administración de Microsoft 365.
    • URL de la pasarela: La URL de tu proxy de LiteLLM.
    • Clave API: Una clave API para el proxy LiteLLM.

Necesitas dar consentimiento una vez por tenant, y se aplica a todos los servidores MCP en la pasarela conectada. Los servidores individuales no requieren un consentimiento independiente.

Note

Después de conectar la pasarela LiteLLM, el Agente 365 descubre los servidores MCP registrados con ella y los pone a disposición en la página de Herramientas . El descubrimiento puede tardar unos minutos. Ve a Agentes>Herramientas y actualiza la página para ver los servidores MCP descubiertos. Para gestionar los servidores MCP descubiertos, consulte Descubrir y gobernar los servidores MCP

Proteger las llamadas a la herramienta MCP de LiteLLM

Microsoft Agent 365 Guardrails utiliza Microsoft Defender para evaluar llamadas a herramientas MCP que realiza LiteLLM y proporciona protección contra amenazas en tiempo de ejecución.

Configura la protección en este orden:

  1. Crea o identifica la aplicación Microsoft Entra que LiteLLM utiliza para la pasarela.
  2. Completa la configuración requerida de Microsoft Entra.
  3. Completa la configuración correspondiente en LiteLLM.

Creación del registro de aplicaciones

  1. En el Centro de administración de Microsoft Entra, cambia al inquilino de destino.
  2. Vaya a Registros de aplicaciones y seleccione Nuevo registro.
  3. Para el nombre de la aplicación, introduce litellm-enterprise-api.
  4. En Tipos de cuenta admitidos, seleccione Solo cuentas en este directorio organizativo.
  5. Seleccione Registrar.
  6. Copia el ID de la aplicación (cliente) y guárdalo como GATEWAY_API_APP_ID para la configuración de LiteLLM.

Note

Si la pasarela ya tiene una aplicación API adecuada, reutiliza la aplicación existente en lugar de crear otra. Conserva sus roles, asignaciones, credenciales y permisos no relacionados existentes.

Configurar LiteLLM

Después de completar la configuración de Microsoft Entra, use GATEWAY_API_APP_ID para completar la configuración correspondiente del gateway. Para la guía de configuración de LiteLLM, consulte la pasarela LiteLLM en la documentación de LiteLLM.

Descubre y gobierna los servidores MCP

Después de conectar Azure AI Gateway o LiteLLM, puedes acceder a los servidores MCP que se registran en la pasarela conectada a través de la experiencia Tools en el Centro de administración de Microsoft 365. Estos pasos de descubrimiento y gobernanza son comunes a ambos gateways.

  1. En el Centro de administración de Microsoft 365, vaya a Agentes>.
  2. Filtra la lista por origen y luego selecciona el gateway cuyos servidores MCP quieres ver.
  3. Selecciona un servidor MCP para revisar sus detalles y las herramientas que expone.

Puedes bloquear o permitir que un servidor MCP gestione su disponibilidad. Para el procedimiento común de gobernanza, véase Bloquear o permitir un servidor MCP.

Para servidores MCP compatibles, también puedes gestionar la disponibilidad de herramientas individuales. Para obtener más información, consulte Administración de herramientas individuales dentro de un servidor MCP.

  • Darrera actualització el