Gérer la passerelle des outils

Connectez Azure AI Gateway ou une passerelle LiteLLM à Microsoft Agent 365 pour découvrir et gouverner les serveurs Model Context Protocol (MCP) enregistrés auprès de la passerelle. L’Agent 365 intègre les serveurs MCP enregistrés dans l’expérience Tools, où les administrateurs peuvent les examiner et les gouverner, surveiller l’activité des serveurs MCP et configurer les protections de sécurité prises en charge pour les appels d’outils MCP.

La découverte et la gouvernance de la passerelle s’appliquent aux serveurs MCP enregistrés auprès de la passerelle connectée et supportés par l’intégration. Ne supposez pas que la passerelle couvre toutes les intégrations MCP ou tous les appels effectués en dehors de cette passerelle.

Agent 365 prend actuellement en charge Azure AI Gateway et LiteLLM. Chaque passerelle nécessite sa propre connexion et processus de configuration.

Utilisez la section de votre passerelle pour compléter la configuration de connexion et de protection. Ensuite, utilisez les étapes de découverte et de gouvernance partagées :

Important

  • Cette fonctionnalité est en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont soumises à des conditions d’utilisation supplémentaires, et sont disponibles avant une version officielle de telle sorte que les clients puissent tirer parti d’un accès anticipé et fournir leurs commentaires.

Connecter Azure AI Gateway

Utilisez cette section pour connecter la passerelle Azure AI et, si nécessaire, configurer la protection contre les appels d’outils.

Prérequis Azure AI Gateway

Avant de connecter Azure AI Gateway, assurez-vous que la passerelle est configurée, que vous avez le rôle d’administrateur global dans Microsoft 365, et que ses serveurs MCP sont enregistrés. Pour des prérequis détaillés, des conseils de configuration et de gouvernance, consultez les outils Govern avec Microsoft Agent 365 et Gestion des API Azure (aperçu).

Connectez la passerelle Azure à Microsoft 365

Note

Vous devez avoir le rôle d’administrateur global pour connecter Azure AI Gateway. Le rôle d’administrateur IA ne supporte pas cette opération.

  1. Connectez-vous au centre d'administration Microsoft 365 en tant qu'Administrateur général.
  2. Accédez à Agents>.
  3. Sélectionnez Passerelles.
  4. À côté de Microsoft Azure, activez le bouton pour connecter un service Gestion des API Azure ou Azure AI Gateway.
  5. Passez en revue et acceptez les autorisations demandées.

Vous devez fournir votre consentement une fois par locataire, et cela s’applique à tous les serveurs MCP dans la passerelle connectée. Les serveurs individuels n’ont pas besoin d’un consentement distinct.

Note

Après avoir connecté la passerelle, l’Agent 365 découvre les serveurs MCP enregistrés chez elle et les met à disposition sur la page Outils. La découverte pourrait prendre quelques minutes. Allez dans Agents>Outils et rafraîchissez la page pour voir les serveurs MCP découverts. Pour gérer les serveurs MCP découverts, voir Découvrir et gouverner les serveurs MCP.

Protégez les appels d’outils Azure AI Gateway avec Microsoft Defender

Pour protéger les appels d’outils via Azure AI Gateway, configurez la politique de protection contre les menaces de l’outil Agent 365 dans le portail IA Gateway. La politique utilise Microsoft Defender et Microsoft Purview pour évaluer les demandes et résultats des outils.

Pour les prérequis et les étapes de configuration spécifiques à la passerelle, voir Protéger les appels d’outils avec Defender et Purview dans le niveau AI Gateway (aperçu). Cette protection nécessite le niveau IA Gateway dans Gestion des API Azure et un jeton utilisateur Microsoft Entra ID délégué. Les appels service-à-service uniquement par application ne sont pas pris en charge.

Pour surveiller l’activité des serveurs MCP, voir Surveiller et observer l’activité des serveurs MCP.

Connect LiteLLM

Microsoft Agent 365 vous permet de vous connecter à une passerelle LiteLLM pour découvrir et gouverner ses serveurs MCP enregistrés et protéger les appels d’outils MCP. LiteLLM est une passerelle IA tierce et n'est ni développée ni prise en charge par Microsoft. Pour des informations sur LiteLLM et l’enregistrement des serveurs MCP auprès de sa passerelle, consultez la passerelle LiteLLM dans la documentation LiteLLM.

Prérequis pour LiteLLM

Avant de commencer, vérifiez que :

  • Vous avez accès à une passerelle LiteLLM avec des serveurs MCP enregistrés.
  • Vous avez un nom de passerelle, une URL de passerelle et une clé API pour le proxy LiteLLM.
  • Vous avez le rôle d’Administrateur Global dans Microsoft 365 pour accéder au Microsoft 365 admin center. Cette exigence s’applique à Microsoft 365, pas aux rôles dans LiteLLM.

Les sections suivantes expliquent comment connecter la passerelle LiteLLM et configurer la protection pour les appels d’outils MCP. Après la configuration, utilisez les étapes partagées pour découvrir et gouverner les serveurs MCP.

Connectez la passerelle LiteLLM à Microsoft 365

  1. Connectez-vous au centre d’administration Microsoft 365 avec le rôle d’administrateur Microsoft 365 indiqué dans les prérequis.
  2. Accédez à Agents>Paramètres>Passerelles.
  3. Sous LiteLLM Gateway, sélectionnez Connecter la passerelle.
  4. Entrez les informations suivantes :
    • Nom de la passerelle : Un nom convivial pour identifier cette passerelle dans le Microsoft 365 admin center.
    • URL de passerelle : L’URL de votre proxy LiteLLM.
    • Clé API : Une clé API pour le proxy LiteLLM.

Vous devez fournir votre consentement une fois par locataire, et cela s’applique à tous les serveurs MCP dans la passerelle connectée. Les serveurs individuels n’ont pas besoin d’un consentement distinct.

Note

Après avoir connecté la passerelle LiteLLM, l’Agent 365 découvre les serveurs MCP qui y sont enregistrés et les rend disponibles sur la page Outils. La découverte pourrait prendre quelques minutes. Allez dans Agents>Outils et rafraîchissez la page pour voir les serveurs MCP découverts. Pour gérer les serveurs MCP découverts, voir Découvrir et gouverner les serveurs MCP

Protéger les appels d’outils MCP LiteLLM

Microsoft Agent 365 Guardrails utilise Microsoft Defender pour évaluer les appels d’outils MCP créés par LiteLLM et fournir une protection contre les menaces à l’exécution.

Configurez la protection dans cet ordre :

  1. Créez ou identifiez l’application Microsoft Entra que LiteLLM utilise pour la passerelle.
  2. Complétez la configuration requise de Microsoft Entra.
  3. Complétez la configuration correspondante dans LiteLLM.

Créer l'enregistrement de l'application

  1. Dans le centre d’administration Microsoft Entra, basculez vers le locataire cible.
  2. Accédez à inscriptions d'applications, puis sélectionnez Inscription .
  3. Pour le nom de l’application, entrez litellm-enterprise-api.
  4. Pour les types de comptes pris en charge, sélectionnez Comptes dans cet annuaire organisationnel uniquement.
  5. Cliquez sur Inscrire.
  6. Copiez l’ID de l’application (client) et conservez-le comme GATEWAY_API_APP_ID pour la configuration LiteLLM.

Note

Si la passerelle dispose déjà d’une application API appropriée, il faut réutiliser l’application existante au lieu d’en créer une autre. Préserver ses rôles, affectations, accréditations et permissions existantes.

Configurez LiteLLM

Après avoir terminé la configuration Microsoft Entra, utilisez GATEWAY_API_APP_ID pour compléter la configuration correspondante de la passerelle. Pour les conseils de configuration de LiteLLM, voir la passerelle LiteLLM dans la documentation LiteLLM.

Découvrez et gérez les serveurs MCP

Après avoir connecté Azure AI Gateway ou LiteLLM, vous pouvez accéder aux serveurs MCP qui s’enregistrent auprès de la passerelle connectée via l’expérience Tools dans le centre d’administration Microsoft 365. Ces étapes de découverte et de gouvernance sont communes aux deux passerelles.

  1. Dans le Centre d’administration Microsoft 365, accédez à Agents>.
  2. Filtrez la liste par source, puis sélectionnez la passerelle dont vous souhaitez consulter les serveurs MCP.
  3. Sélectionnez un serveur MCP pour examiner ses détails et les outils qu’il expose.

Vous pouvez bloquer ou autoriser un serveur MCP pour gérer sa disponibilité. Pour la procédure de gouvernance commune, voir Bloquer ou autoriser un serveur MCP.

Pour les serveurs MCP pris en charge, vous pouvez également gérer la disponibilité des outils individuels. Pour plus d’informations, voir Gérer des outils individuels au sein d’un serveur MCP.