Aller au contenu

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é.

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.

  • Un tenant Microsoft 365 avec des licences Microsoft 365 Copilot.
  • Un administrateur Microsoft Entra habilité à donner un consentement pour toute l’organisation.
  1. 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.

  2. 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.

  3. 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.

  4. 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.

  • 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.

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.

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.