Microsoft Copilot interações & Microsoft 365 Chat

A API de Exportação de Atividades do Copilot permite exportar dados de interações do Copilot, que incluem o prompt do usuário para o Copilot e a resposta do Copilot de volta para o usuário. Essa API captura a intenção do usuário e os recursos acessados pelo Copilot e a resposta de volta ao usuário em aplicativos do Microsoft Copilot, como Teams, Word e Outlook.

Como acessar as APIs de exportação de atividades do Copilot

• O exemplo 1 é uma consulta simples para recuperar 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 recuperar todas as interações do Copilot com 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'
  

Pré-requisitos para acessar as APIs de exportação de atividades do Copilot

As permissões de aplicativo são usadas por aplicativos executados sem a presença de um usuário conectado. Somente um administrador pode aprovar permissões de aplicativo. As seguintes permissões são necessárias:

• AiEnterpriseInteraction.Read.All: permite o acesso a todas as interações do Copilot em aplicativos do Microsoft 365 e no Microsoft 365 Chat
• É necessária uma licença do Microsoft Copilot para acessar a nova API de exportação de atividades do Copilot.

Filtros appClass com suporte

Há suporte para 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

Esses filtros permitem que você especifique o tipo de interações do Copilot que deseja recuperar com base na classe do aplicativo. O restante das interações não tem suporte.

Saiba mais sobre o aiInteractionHistory: getAllEnterpriseInteractions que permite exportar interações do Copilot.

Problema conhecido

Para algumas interações no Copilot de Reunião do Teams, pode contexts[] estar ausente nas aiResponse interações. O prompt de usuário correspondente, no entanto, sempre inclui o para garantir a contexts[] recuperação de contexto precisa. A equipe de desenvolvimento está ciente do problema e está trabalhando em uma solução. O exemplo a seguir mostra um par userprompt, aiResponse que tem contextos[] válidos no userprompt e contextos[] ausentes 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": []
    }
]

Não está no escopo das APIs de exportação de interações do Copilot:

• Não há suporte para a chamada de função delta.
• Determinados metadados de apresentação gerados pelo Copilot não estão incluídos nas respostas da API de exportação de interações do Copilot. Os seguintes metadados não estão incluídos:
  1. Nomes de exibição editáveis do Copilot no chat do Microsoft 365.
  2. Linhas de assunto da mensagem do Outlook que são geradas ou sugeridas automaticamente pelo Copilot.