& Microsoft 365 Chat interactions Microsoft 365 Copilot

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

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

• L’exemple 1 est une requête simple permettant de récupérer toutes les interactions de copilote sans filtre :

  GET https://graph.microsoft.com/v1.0/copilot/users/{id}/interactionHistory/getAllEnterpriseInteractions 
  

• L’exemple 2 est une requête simple pour récupérer toutes les interactions de copilote 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'
  

Prérequis pour accéder aux API d’exportation d’activités Copilot

Les autorisations d’application sont utilisées par les applications qui s’exécutent sans utilisateur connecté présent. 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 copilotes entre les applications Microsoft 365 et les Microsoft 365 Chat
• Une licence Microsoft 365 Copilot est requise pour accéder à la nouvelle API d’exportation d’activités 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 d’application. Les autres interactions ne sont pas prises en charge.

Problème connu :

Pour certaines interactions dans Teams Meeting Copilot, le contexts[] peut être manquant 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 userprompt et des contextes manquants[] dans le 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?<attachment id=\"19:meeting_MTQ4ZDdkMzktYjhkZC00ODdlLTkwN2UtYzcwYjVmOWIxYTNm@thread.v2\"></attachment>"
        },
        "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": []
    }
]

Remarque

• Pour comprendre les limites de limitation pour l’API d’exportation d’interactions Copilot, consultez Limites de limitation des API d’exportation Teams.
• L’appel de fonction Delta n’est pas pris en charge.
• Pour des performances optimales, la valeur de $top recommandée est 100.
• Cette API peut être utilisée pour récupérer les interactions Copilot prises en charge pour les utilisateurs supprimés.
• Les interactions copilotes 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.