interazioni Microsoft 365 Copilot & Microsoft 365 Chat

L'API di esportazione delle attività Copilot consente di esportare i dati delle interazioni Copilot, che includono la richiesta dell'utente a Copilot e la risposta Copilot all'utente. Questa API acquisisce l'intento dell'utente e le risorse accessibili da Copilot e la risposta all'utente in app Microsoft 365 Copilot come Teams, Word e Outlook.

Come accedere alle API di esportazione attività Copilot

• L'esempio 1 è una query semplice per recuperare tutte le interazioni Copilot senza alcun filtro:

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

• L'esempio 2 è una query semplice per recuperare tutte le interazioni copilot con i filtri di 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'
  

Prerequisiti per accedere alle API di esportazione attività Copilot

Le autorizzazioni per le applicazioni vengono usate dalle app eseguite senza una presentazione utente connessa. Solo un amministratore può approvare le autorizzazioni dell'applicazione. Sono necessarie le autorizzazioni seguenti:

• AiEnterpriseInteraction.Read.All: consente l'accesso a tutte le interazioni Copilot tra le app di Microsoft 365 e Microsoft 365 Chat
• Per accedere alla nuova API di esportazione attività Copilot è necessaria una licenza di Microsoft 365 Copilot.

Filtri appClass supportati

Sono supportati i filtri appClass seguenti:

• 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

Questi filtri consentono di specificare il tipo di interazioni Copilot da recuperare in base alla classe di app. Le altre interazioni non sono supportate.

Altre informazioni su aiInteractionHistory: getAllEnterpriseInteractions che consente l'esportazione di interazioni Copilot.

Problema noto

Per alcune interazioni in Teams Meeting Copilot, potrebbe contexts[] non essere presente nelle aiResponse interazioni. Il prompt dell'utente corrispondente, tuttavia, include sempre per contexts[] garantire un recupero accurato del contesto. Il team di sviluppo è consapevole di questo problema e sta lavorando per risolverlo. Nell'esempio seguente viene illustrata una coppia userprompt, aiResponse con contesti validi[] in contesto userprompt e mancante[] nella corrispondente 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": []
    }
]

Non rientra nell'ambito delle API di esportazione di Copilot Interactions:

• La chiamata alla funzione Delta non è supportata.
• Alcuni metadati della presentazione generati da Copilot non sono inclusi nelle risposte API di esportazione di Copilot Interactions. I metadati seguenti non sono inclusi:
  1. Nomi visualizzati della chat copilot modificabile di Microsoft 365.
  2. Righe dell'oggetto del messaggio di Outlook generate automaticamente o suggerite da Copilot.