Interacciones de Copiloto de Microsoft 365 & Microsoft 365 Chat

La API de exportación de actividad de Copilot le permite exportar datos de interacciones de Copilot, que incluye la solicitud de usuario a Copilot y la respuesta de Copilot al usuario. Esta API captura la intención del usuario y los recursos a los que se accedió a Copilot y la respuesta al usuario en todas las aplicaciones de Microsoft 365 Copilot, como Teams, Word y Outlook.

Cómo obtener acceso a las API de exportación de actividad de Copilot

• El ejemplo 1 es una consulta sencilla para recuperar todas las interacciones de copiloto sin filtros:

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

• El ejemplo 2 es una consulta sencilla para recuperar todas las interacciones de copiloto con filtros 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'
  

Requisitos previos para acceder a las API de exportación de actividad de Copilot

Los permisos de aplicación los usan las aplicaciones que se ejecutan sin un usuario con sesión iniciada presente. Solo un administrador puede aprobar los permisos de la aplicación. Son necesarios los siguientes permisos:

• AiEnterpriseInteraction.Read.All: permite el acceso a todas las interacciones de copiloto en las aplicaciones de Microsoft 365 y Microsoft 365 Chat
• Se requiere una licencia de Microsoft 365 Copilot para obtener acceso a la nueva API de exportación de actividad de Copilot.

Filtros appClass compatibles:

Se admiten los siguientes filtros appClass:

• 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

Estos filtros le permiten especificar el tipo de interacciones de Copilot que desea recuperar en función de la clase de aplicación. El resto de las interacciones no son compatibles.

Obtenga más información sobre aiInteractionHistory: getAllEnterpriseInteractions , que permite exportar interacciones de copiloto.

Problema conocido:

Para algunas interacciones en Copiloto de reuniones de Teams, contexts[] es posible que falten interacciones aiResponse . Sin embargo, el mensaje de usuario correspondiente siempre incluye el para garantizar una recuperación precisa del contexts[] contexto. El equipo de desarrollo es consciente de este problema y está trabajando en una resolución. En el ejemplo siguiente se muestra un userprompt, ai Re pair que tiene contextos válidos[] en el userprompt y falta contextos[] en la correspondiente aiResponse.

[
    {
        "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": []
    }
]