Microsoft Copilot interactions & Microsoft 365 Chat

S’applique à: Microsoft Teams

L’API d’exportation d’activité Copilot vous permet d’exporter les données d’interactions Copilot, qui incluent l’invite utilisateur à Copilot et la réponse Copilot à l’utilisateur. Cette API capture l’intention de l’utilisateur et les ressources accessibles par Copilot, ainsi que la réponse à l’utilisateur dans les applications Microsoft Copilot telles que Teams, Word et Outlook.

Comment accéder aux API d’exportation d’activité Copilot

L’exemple 1 est une requête simple permettant de récupérer toutes les interactions Copilot sans aucun filtre :
```
GET https://graph.microsoft.com/v1.0/copilot/users/{id}/interactionHistory/getAllEnterpriseInteractions 
```

L’exemple 2 est une requête simple permettant de récupérer toutes les interactions Copilot avec les filtres appclass :

GET https://graph.microsoft.com/v1.0/copilot/users/{id}/interactionHistory/getAllEnterpriseInteractions?$filter=appClass eq 'IPM.SkypeTeams.Message.Copilot.Teams or appClass eq 'IPM.SkypeTeams.Message.Copilot.BizChat'

Conditions préalables pour accéder aux API d’exportation d’activité Copilot

Les autorisations d’application sont utilisées par les applications qui s’exécutent sans la présence d’un utilisateur connecté. Seul un administrateur peut approuver les autorisations d’application. Les autorisations suivantes sont nécessaires :

AiEnterpriseInteraction.Read.All : permet d’accéder à toutes les interactions Copilot dans les applications Microsoft 365 et Microsoft 365 Chat
Une licence Microsoft Copilot est requise pour accéder à la nouvelle API d’exportation d’activité Copilot.

Filtres appClass pris en charge

Les filtres appClass suivants sont pris en charge :

IPM.SkypeTeams.Message.Copilot.Word
IPM.SkypeTeams.Message.Copilot.Excel
IPM.SkypeTeams.Message.Copilot.Teams
IPM.SkypeTeams.Message.Copilot.BizChat
IPM.SkypeTeams.Message.Copilot.WebChat

Ces filtres vous permettent de spécifier le type d’interactions Copilot que vous souhaitez récupérer en fonction de la classe de l’application. Les autres interactions ne sont pas prises en charge.

En savoir plus sur aiInteractionHistory : getAllEnterpriseInteractions qui permet d’exporter les interactions Copilot.

Problème connu

Pour certaines interactions dans Teams Meeting Copilot, il se peut qu’elles contexts[] soient manquantes dans les aiResponse interactions. Toutefois, l’invite utilisateur correspondante inclut toujours le pour garantir une récupération précise du contexts[] contexte. L’équipe de développement est consciente de ce problème et travaille à une résolution. L’exemple suivant montre une paire userprompt, aiResponse qui a des contextes valides[] dans l’userprompt et des contextes[] manquants dans l’aiResponse correspondant.

[
    {
        "id": "1746757256660",
        "sessionId": "19:-SMwOyVjy2H3_BnsIO6WGUTXwuN1_BIw4U2TP4UcCwo1@thread.v2",
        "requestId": "db42bee0-7cfb-451f-8eb6-f929762ee970",
        "appClass": "IPM.SkypeTeams.Message.Copilot.Teams",
        "interactionType": "userPrompt",
        "conversationType": "appchat",
        "etag": "1746757256660",
        "createdDateTime": "2025-05-09T02:20:56.66Z",
        "locale": "en-us",
        "contexts": [
            {
                "contextReference": "https://microsoft.teams.com/threads/19:meeting_MTQ4ZDdkMzktYjhkZC00ODdlLTkwN2UtYzcwYjVmOWIxYTNm@thread.v2",
                "displayName": "Teams Meeting Copilot",
                "contextType": "TeamsMeeting"
            }
        ],
        "from": {
            "@odata.type": "#microsoft.graph.chatMessageFromIdentitySet",
            "application": null,
            "device": null,
            "user": {
                "@odata.type": "#microsoft.graph.teamworkUserIdentity",
                "id": "886cb6c8-eb73-4f72-ad99-69ebf43f70ad",
                "displayName": "8:orgid:886cb6c8-eb73-4f72-ad99-69ebf43f70ad",
                "userIdentityType": "aadUser",
                "tenantId": "bcefad10-7e12-4123-8457-f3ac71b098db"
            }
        },
        "body": {
            "contentType": "text",
            "content": "what was this meeting about?&lt;attachment id=\"19:meeting_MTQ4ZDdkMzktYjhkZC00ODdlLTkwN2UtYzcwYjVmOWIxYTNm@thread.v2\"&gt;&lt;/attachment&gt;"
        },
        "attachments": [
            {
                "attachmentId": "19:meeting_MTQ4ZDdkMzktYjhkZC00ODdlLTkwN2UtYzcwYjVmOWIxYTNm@thread.v2",
                "contentType": "reference",
                "contentUrl": "https://microsoft.teams.com/threads/19:meeting_MTQ4ZDdkMzktYjhkZC00ODdlLTkwN2UtYzcwYjVmOWIxYTNm@thread.v2",
                "content": null,
                "name": "Teams Meeting Copilot"
            }
        ],
        "links": [],
        "mentions": []
    },
    {
        "id": "1746757257162",
        "sessionId": "19:-SMwOyVjy2H3_BnsIO6WGUTXwuN1_BIw4U2TP4UcCwo1@thread.v2",
        "requestId": "db42bee0-7cfb-451f-8eb6-f929762ee970",
        "appClass": "IPM.SkypeTeams.Message.Copilot.Teams",
        "interactionType": "aiResponse",
        "conversationType": "appchat",
        "etag": "1746757257162",
        "createdDateTime": "2025-05-09T02:20:57.162Z",
        "locale": "en-us",
        "contexts": [],
        "from": {
            "@odata.type": "#microsoft.graph.chatMessageFromIdentitySet",
            "device": null,
            "user": null,
            "application": {
                "@odata.type": "#microsoft.graph.teamworkApplicationIdentity",
                "id": "fb8d773d-7ef8-4ec0-a117-179f88add510",
                "displayName": "Copilot in Teams",
                "applicationIdentityType": "bot"
            }
        },
        "body": {
            "contentType": "text",
            "content": "I need to hear more discussion before I can get to work. Please try again in a few minutes."
        },
        "attachments": [],
        "links": [],
        "mentions": []
    }
]

Non concerné par les API d’exportation d’interactions Copilot :

L’appel de fonction delta n’est pas pris en charge.
Certaines métadonnées de présentation générées par Copilot ne sont pas incluses dans les réponses de l’API d’exportation des interactions Copilot. Les métadonnées suivantes ne sont pas incluses :
1. Noms d’affichage modifiables de Copilot Microsoft 365 chat.
2. Lignes d’objet de message Outlook générées ou suggérées automatiquement par Copilot.

Remarque

Pour comprendre les limites de l’API d’exportation des interactions Copilot, consultez Limites de limitation des API d’exportation de Teams.
Pour des performances optimales, la valeur de $top recommandée est de 100.
Cette API peut être utilisée pour récupérer les interactions Copilot prises en charge pour les utilisateurs supprimés.
Les interactions Copilot supprimées pour les classes d’application prises en charge peuvent être récupérées à l’aide de cette API.
Si une invite utilisateur est modifiée, elle est considérée comme une nouvelle interaction et peut être récupérée à l’aide de cette API.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-08-19