& Microsoft 365 Chat interacciones Microsoft 365 Copilot

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 Microsoft 365 Copilot aplicaciones 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 Copilot 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 Copilot 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 Copilot 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 Copilot.

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

No está en el ámbito de las API de exportación de interacciones de Copilot:

• No se admite la llamada de función diferencial.
• Algunos metadatos de presentación generados por Copilot no se incluyen en las respuestas de la API de exportación de interacciones de Copilot. No se incluyen los siguientes metadatos:
  1. Nombres para mostrar editables del chat de Copilot de Microsoft 365.
  2. Líneas de asunto de mensajes de Outlook generadas o sugeridas automáticamente por Copilot.