interações Microsoft 365 Copilot & Microsoft 365 Chat

A API de Exportação de Atividade copilot permite-lhe exportar dados de interações copilot, que incluem o pedido do utilizador para Copilot e a resposta copilot de volta para o utilizador. Esta API captura a intenção do utilizador e os recursos acedidos pela Copilot e a resposta ao utilizador em aplicações Microsoft 365 Copilot, como o Teams, o Word e o Outlook.

Como aceder às APIs de Exportação de Atividade copilot

• O exemplo 1 é uma consulta simples para obter todas as interações do copilot sem filtros:

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

• O exemplo 2 é uma consulta simples para obter todas as interações de copilot com 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'
  

Pré-requisitos para aceder às APIs de Exportação de Atividade copilot

As permissões de aplicação são utilizadas por aplicações que são executadas sem um utilizador com sessão iniciada presente. Apenas um administrador pode aprovar permissões de aplicação. São necessárias as seguintes permissões:

• AiEnterpriseInteraction.Read.All: permite o acesso a todas as interações de copilot em aplicações e Microsoft 365 Chat do Microsoft 365
• É necessária uma licença de Microsoft 365 Copilot para aceder à nova API de Exportação de Atividade copilot.

Filtros appClass suportados:

São suportados os seguintes 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

Estes filtros permitem-lhe especificar o tipo de interações copilot que pretende obter com base na classe da aplicação. As restantes interações não são suportadas.

Problema conhecido:

Para algumas interações no Teams Meeting Copilot, o contexts[] pode estar em falta nas aiResponse interações. No entanto, o pedido de utilizador correspondente inclui sempre o contexts[] para garantir uma obtenção precisa do contexto. A equipa de desenvolvimento está ciente deste problema e está a trabalhar numa resolução. O exemplo seguinte mostra um par userprompt, aiResponse que tem contextos válidos[] nos contextos userprompt e em falta[] no aiResponse correspondente.

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

Nota

• Para compreender os limites de Limitação da API de Exportação de Interações do Copilot, veja Limites de limitação das APIs de Exportação do Teams.
• A chamada da função Delta não é suportada.
• Para um desempenho ideal, o valor de $top recomendado é 100.
• Esta API pode ser utilizada para obter as Interações Copilot suportadas para utilizadores eliminados.
• As interações copilot eliminadas para as classes de aplicações suportadas podem ser obtidas com esta API.
• Se um pedido de utilizador for editado, é considerado uma nova interação e pode ser obtido com esta API.