Agent 365 : Premiers API disponibles sur Microsoft Graph

Introduction

Microsoft a recemment lance la premiere version des API pour la gestion des agents de Agent 365 sur le canal bêta de Microsoft Graph. Cette evolution promet une meilleure gouvernance et gestion des agents a grande echelle, bien que les API actuelles soient encore limitees dans leur fonctionnalite.

Vue d'ensemble des API disponibles

L'API fournit plusieurs points de terminaison qui permettent d'obtenir une liste des agents, de recuperer des details sur un agent specifique, mais limite actuellement les actions de gestion. Voici ce qu'il faut savoir :

• Les permissions delegate et application sont compatibles, contrairement a certaines informations mentionnees dans la documentation actuelle.
• Pour l'utilisation des methodes de lecture, il faut le scope CopilotPackages.Read.All.
• Les operations d'ecriture necessitent le scope CopilotPackages.ReadWrite.All.

Cependant, les permissions d'application ne fonctionnent que pour la méthode LIST, tandis que les methodes telles que GET renvoient actuellement une erreur "424 Failed Dependency" dans le contexte de l'application.

Recuperer une liste des agents

Pour obtenir une liste de tous les agents disponibles dans votre tenant, il faut inclure un filtre explicite dans votre requête Graph API. Voici un exemple :

1GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages?$filter=supportedHosts/any(x:x eq 'Copilot')

En comparant les résultats obtenus via la requête API avec ceux presentes dans l'interface utilisateur (UI) d'Agent 365, on note parfois des divergences. Par exemple, le nombre d'agents liste peut differer.

Recuperer les details sur un agent specifique

Pour obtenir des informations detaillees sur un agent particulier, utilisez une requête API GET avec son ID unique. Exemple :

1GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages/P_13001d9b-2af4-bd2f-5458-ffa544bc62b7

Les resultats incluent plusieurs proprietes d'interet comme :

• isBlocked : Pour activer ou desactiver l'agent
• Publisher : Le fournisseur de l'agent
• allowedUsersAndGroups et acquireUsersAndGroups : Liste des utilisateurs et groupes autorises.

Exemples pratiques avec PowerShell

Vous pouvez egalement utiliser PowerShell pour interagir avec ces API, comme montre ci-dessous :

1# Obtenir les details d'un agent via Graph API
2$res = Invoke-MgGraphRequest -Method Get -Uri "https://graph.microsoft.com/beta/copilot/admin/catalog/packages/P_e3d64609-7a28-6de6-3093-402c20bb96ce?`$select=id,allowedUsersAndGroups,availableTo"
3 
4# Afficher les resultats
5$res | select id,displayName,allowedUsersAndGroups,availableTo

Fonctionnalites manquantes

Pour l'instant, les methodes telles que "block", "unblock" ou "reassign" mentionnees dans la documentation officielle ne sont pas operationnelles. Microsoft devra apporter des ameliorations afin d'offrir une gestion approfondie des agents via API.

Conclusion

La premiere iteration des API d'Agent 365 fournit une visibilite initiale des agents disponibles, mais leurs capacites demeurent limitees pour les actions de gestion. Il faudra attendre une future mise a jour pour que Microsoft ajoute les possibilites avancees promettant une gouvernance veritablement "at scale".

Liens utiles

• Documentation officielle Microsoft Graph
• Agent 365 UI Overview

Glossaire

• Microsoft Graph : Plateforme de developpement integrant les donnees Microsoft 365.
• CopilotPackages.Read.All : Scope necessaire pour lire les donnees des agents via l'API.
• Agent 365 : Solution d'administration des agents Copilot.

Tags

Copilot, Microsoft Graph, PowerShell, Agent 365, API, Microsoft 365