Microsoft Copilot interacciones & Microsoft 365 Chat

  • Se aplica a: Microsoft Teams

La API de exportación de actividad de Copilot permite exportar datos de interacciones de Copilot, lo que incluye la indicación del usuario a Copilot y la respuesta de Copilot al usuario. Esta API captura la intención del usuario y los recursos accedidos de Copilot, así como la respuesta al usuario en las aplicaciones de Microsoft Copilot, como Teams, Word y Outlook.

Cómo acceder a las API de exportación de actividades de Copilot

  • El ejemplo 1 es una consulta sencilla para recuperar todas las interacciones de Copilot sin ningún filtro:

    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 los filtros de 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 actividades de Copilot

Los permisos de aplicación se usan en aplicaciones que se ejecutan sin la presencia de un usuario que haya iniciado sesión. Solo un administrador puede aprobar los permisos de aplicación. Se necesitan los siguientes permisos:

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

Filtros de appClass admitidos

Son compatibles 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 Teams Meeting Copilot, es contexts[] posible que falte en las aiResponse interacciones. Sin embargo, la solicitud 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 solución. En el ejemplo siguiente se muestra un par de mensajes de usuario y aiResponse que tienen contextos válidos[] en el símbolo del usuario y contextos que faltan[] en el aiResponse correspondiente.

[
    {
        "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 entra en el ámbito de las interacciones de Copilot API de exportación:

  • No se admite la llamada a la función delta.
  • Algunos metadatos de presentación generados por Copilot no se incluyen en las respuestas de la API de exportación de interacciones de Copilot. Los siguientes metadatos no están incluidos:
    1. Nombres para mostrar editables en el chat de Microsoft 365 de Copilot.
    2. Líneas de asunto de mensajes de Outlook que Copilot genera o sugiere automáticamente.

Nota

  • Para comprender los límites de la API de exportación de interacciones de Copilot, consulte Límites de limitación de las API de exportación de Teams.
  • Para obtener un rendimiento óptimo, el valor de $top recomendado es 100.
  • Esta API se puede usar para recuperar las interacciones de Copilot admitidas para los usuarios eliminados.
  • Las interacciones eliminadas de Copilot para las clases de aplicaciones admitidas se pueden recuperar mediante esta API.
  • Si se edita una indicación de usuario, se considera como una nueva interacción y se puede recuperar mediante esta API.
  • Last updated on