API Graph Copilot : Microsoft 365 Copilot
Idun Cockpit lit les échanges Microsoft 365 Copilot de vos utilisateurs sous licence par l’API Microsoft Graph, avec une application que votre administrateur inscrit dans Microsoft Entra. Il s’agit de Microsoft 365 Copilot, l’assistant de la suite bureautique, pas de GitHub Copilot. Pour la question des sièges et du renouvellement, voir Microsoft 365 Copilot en entreprise ; pour ce que le rapport d’usage ne dit pas, l’article dédié.
Deux API, deux usages
Section intitulée « Deux API, deux usages »| API Microsoft Graph | Ce qu’elle donne | Permission |
|---|---|---|
Historique des interactions (getAllEnterpriseInteractions) |
Les demandes et les réponses de chaque utilisateur, dans Teams, Word, Outlook et Copilot Chat. | AiEnterpriseInteraction.Read.All, application |
Rapport d’usage (getMicrosoft365CopilotUsageUserDetail) |
Des compteurs par utilisateur : dernière activité par application, nombre de demandes. Aucun contenu. | Reports.Read.All |
Le Cockpit lit l’historique des interactions : c’est le contenu des échanges qui révèle les cas d’usage. Le rapport d’usage compte l’activité ; il dit qu’une licence est active, pas à quoi elle sert.
Ce qu’il faut
Section intitulée « Ce qu’il faut »- Un tenant Microsoft 365 avec des licences Microsoft 365 Copilot.
- Un administrateur Microsoft Entra habilité à donner un consentement pour toute l’organisation.
Les étapes
Section intitulée « Les étapes »-
Inscrire une application
Dans le centre d’administration Microsoft Entra, ouvrez « Inscriptions d’applications », puis « Nouvelle inscription ». Nommez l’application et choisissez un seul locataire.
-
Ajouter la permission
Dans « Autorisations des API », ajoutez une permission Microsoft Graph de type application :
AiEnterpriseInteraction.Read.All. Le mode délégué n’existe pas pour cette permission. -
Donner le consentement
Cliquez sur « Accorder le consentement administrateur » pour votre organisation, puis vérifiez que l’état de la permission indique qu’elle est accordée.
-
Créer un secret et nous le transmettre
Dans « Certificats et secrets », créez un secret client. Transmettez l’ID du locataire, l’ID de l’application et le secret par le canal convenu au lancement de l’audit, jamais par e-mail.
Ce qui est mesuré, et ce qui ne l’est pas
Section intitulée « Ce qui est mesuré, et ce qui ne l’est pas »- Mesuré : les demandes et les réponses de chaque utilisateur sous licence, l’application où elles ont eu lieu, la date.
- Pas couvert par cette API : les agents construits avec Copilot Studio, et Copilot Chat sans licence Microsoft 365 Copilot.
- Pas disponible : le modèle utilisé et le coût par échange ; Microsoft ne les donne pas.
Questions fréquentes
Section intitulée « Questions fréquentes »Le rapport d’usage du centre d’administration ne suffit-il pas ?
Section intitulée « Le rapport d’usage du centre d’administration ne suffit-il pas ? »Il compte les licences actives : une licence devient active dès la première sollicitation. Il ne dit ni pour quelles tâches, ni avec quel rendement. Le Cockpit part des échanges pour répondre à ces deux questions.
Faut-il une permission par utilisateur ?
Section intitulée « Faut-il une permission par utilisateur ? »Non. La permission d’application vaut pour tout le locataire, une fois le consentement donné.
Pour voir ce que l'outil montre sur vos propres outils, prenez rendez-vous.