Microsoft Copilot interazioni & Microsoft 365 Chat

  • Si applica a: Microsoft Teams

L'API Copilot Activity Export consente di esportare i dati delle interazioni di Copilot, tra cui la richiesta dell'utente a Copilot e la risposta di Copilot all'utente. Questa API acquisisce l'intento dell'utente e le risorse a cui Copilot ha eseguito l'accesso e la risposta all'utente attraverso app di Microsoft Copilot come Teams, Word e Outlook.

Come accedere alle API di esportazione delle attività di Copilot

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

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

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

Le autorizzazioni delle applicazioni vengono usate dalle app eseguite senza la presenza di un utente connesso. Solo un amministratore può approvare le autorizzazioni dell'applicazione. Sono necessarie le autorizzazioni seguenti:

  • AiEnterpriseInteraction.Read.All: abilita l'accesso a tutte le interazioni di Copilot tra Microsoft 365 Apps e Microsoft 365 Chat
  • Per accedere alla nuova API Copilot Activity Export è necessaria una licenza di Microsoft 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 che si desidera recuperare in base alla classe di app. Il resto delle interazioni non è supportato.

Altre informazioni su aiInteractionHistory: getAllEnterpriseInteractions che consente di esportare le interazioni di Copilot.

Problema noto

Per alcune interazioni in Teams Meeting Copilot, l'elemento contexts[]aiResponse potrebbe non essere presente nelle interazioni. Il prompt utente corrispondente, tuttavia, include sempre il contexts[] per garantire un recupero accurato del contesto. Il team di sviluppo è a conoscenza del problema e sta lavorando per risolverlo. L'esempio seguente mostra una coppia userprompt, aiResponse con contexts[] validi nel prompt utente e contexts[] mancanti nell'aiResponse corrispondente.

[
    {
        "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 delle interazioni Copilot:

  • La chiamata della funzione Delta non è supportata.
  • Alcuni metadati delle presentazioni generati da Copilot non sono inclusi nelle risposte dell'API Copilot Interactions Export. I metadati seguenti non sono inclusi:
    1. Nomi visualizzati modificabili delle chat di Microsoft 365 Copilot.
    2. Righe dell'oggetto dei messaggi di Outlook generate o suggerite automaticamente da Copilot.

Nota

  • Per informazioni sui limiti di limitazione per l'API di esportazione delle interazioni di Copilot, fare riferimento a Limiti di limitazione delle API di esportazione di Teams.
  • Per prestazioni ottimali, il valore $top consigliato è 100.
  • Questa API può essere usata per recuperare le interazioni Copilot supportate per gli utenti eliminati.
  • Le interazioni di Copilot eliminate per le classi di app supportate possono essere recuperate usando questa API.
  • Se un prompt dell'utente viene modificato, viene considerato come una nuova interazione e può essere recuperato tramite questa API.
  • Last updated on