Freigeben über

aiInteractionHistory: getAllEnterpriseInteractions

Wichtig

APIs unter der /beta Version können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.

Rufen Sie alle Microsoft 365 Copilot Interaktionsdaten ab, einschließlich Benutzeraufforderungen zu Copilot- und Copilot-Antworten. Diese API erfasst die Benutzerabsicht, die Ressourcen, auf die Copilot zugreift, und die Antwort auf den Benutzer für Microsoft 365-Apps wie Teams, Word und Outlook.

Um mehr darüber zu erfahren, wie Sie die Export-APIs von Microsoft Teams für das Exportieren von Inhalten verwenden, lesen Sie Inhalte mit den Export-APIs von Microsoft Teams exportieren.

Hinweis

Für diese API ist eine gültige Microsoft 365 Copilot-Lizenz erforderlich.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application AiEnterpriseInteraction.Read.All Nicht verfügbar.

Wichtig

Die zurückgegebenen Interaktionen variieren je nach Copilot-Lizenzierung und den KI-Erfahrungen in Ihrem Mandanten, die in den Interaktionsverlaufsdienst schreiben.

HTTP-Anforderung

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

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

Hinweis

  • Delta-Funktionsaufrufe werden nicht unterstützt.
  • Diese API ruft keine Interaktionen in Agents ab, die von Copilot Studio erstellt wurden.

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter und den $top Datenbereich, um die Antwort anzupassen. Für eine optimale Leistung wird 100empfohlen$top.

Diese Methode unterstützt auch den $filterOData-Abfrageparameter , um die Antwort anzupassen, wie in Beispiel 2: Abrufen aller Copilot-Interaktionen für einen Benutzer mit App-Klassenfiltern gezeigt.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und eine Sammlung von aiInteraction-Objekten im Antworttext zurückgegeben.

Beispiele

Beispiel 1: Abrufen aller Copilot-Interaktionen ohne Filter

Das folgende Beispiel zeigt eine Anforderung, die alle Copilot-Interaktionen für einen Benutzer abruft.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/copilot/users/9fcefe95-9677-483e-a3c1-22c5d501d737/interactionHistory/getAllEnterpriseInteractions

GET https://graph.microsoft.com/beta/copilot/users/9fcefe95-9677-483e-a3c1-22c5d501d737/interactionHistory/getAllEnterpriseInteractions

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "id": "1731701801008",
      "sessionId": "19:icg2t_AWPYJyJ2oDLB_CZyh29QXpZvbdpljKf7qKotk1@thread.v2",
      "requestId": "7336770c-fb25-48ac-8303-4493ad11ed71",
      "appClass": "IPM.SkypeTeams.Message.Copilot.Teams",
      "interactionType": "aiResponse",
      "conversationType": "appchat",
      "etag": "1731701801008",
      "createdDateTime": "2024-11-15T20:16:41.008Z",
      "locale": "en-us",
      "contexts": [
        {
          "contextReference": "https://microsoft.teams.com/threads/19:meeting_YjQ4NThlNzUtMjEyNC00MjFlLTk0ODMtZTc2M2Q5MDVlNTE4@thread.v2",
          "displayName": "Teams Meeting Copilot",
          "contextType": "TeamsMeeting"
        }
      ],
      "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 use the transcript to generate insights, and need to hear more discussion before I can get to work. Please try again in a few minutes.<attachment id=\"19:meeting_YjQ4NThlNzUtMjEyNC00MjFlLTk0ODMtZTc2M2Q5MDVlNTE4@thread.v2\"></attachment>"
      },
      "attachments": [
        {
          "attachmentId": "19:meeting_YjQ4NThlNzUtMjEyNC00MjFlLTk0ODMtZTc2M2Q5MDVlNTE4@thread.v2",
          "contentType": "reference",
          "contentUrl": "https://microsoft.teams.com/threads/19:meeting_YjQ4NThlNzUtMjEyNC00MjFlLTk0ODMtZTc2M2Q5MDVlNTE4@thread.v2",
          "content": null,
          "name": "Teams Meeting Copilot"
        }
      ],
      "links": [],
      "mentions": []
    }
  ]
}

Beispiel 2: Abrufen aller Copilot-Interaktionen für einen Benutzer mit App-Klassenfiltern

Das folgende Beispiel zeigt eine Anforderung, die alle Copilot-Interaktionen für einen Benutzer mit App-Klassenfiltern abruft.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/copilot/users/4db02e4b-d144-400e-b194-53253a34c5be/interactionHistory/getAllEnterpriseInteractions?$filter=appClass eq 'IPM.SkypeTeams.Message.Copilot.BizChat'

GET https://graph.microsoft.com/beta/copilot/users/4db02e4b-d144-400e-b194-53253a34c5be/interactionHistory/getAllEnterpriseInteractions?$filter=appClass eq 'IPM.SkypeTeams.Message.Copilot.BizChat'

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "id": "1732148357313",
      "sessionId": "19:YzBP1kUdkNjFtJnketPYT8kQdQ3A08Y51rDTxE_ENIk1@thread.v2",
      "requestId": "f128b7a9-657e-b420-201e-5602114a29f4",
      "appClass": "IPM.SkypeTeams.Message.Copilot.BizChat",
      "interactionType": "aiResponse",
      "conversationType": "bizchat",
      "etag": "1732148357313",
      "createdDateTime": "2024-11-21T00:19:17.313Z",
      "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": "Microsoft 365 Chat",
          "applicationIdentityType": "bot"
        }
      },
      "body": {
        "contentType": "html",
        "content": "<attachment id=\"4062fb240a03490b98ccd7c86bb2bcbf\"></attachment>"
      },
      "attachments": [
        {
          "attachmentId": "4062fb240a03490b98ccd7c86bb2bcbf",
          "contentType": "application/vnd.microsoft.card.adaptive",
          "contentUrl": null,
          "content": "{\r\n  \"type\": \"AdaptiveCard\",\r\n  \"version\": \"1.0\",\r\n  \"body\": [\r\n    {\r\n      \"type\": \"TextBlock\",\r\n      \"text\": \"It looks like there were no important emails from last week. However, I found some relevant meetings and files that might be of interest to you.\\n\\nFrom your meetings last week:\\n- **[test meeting2 - export api](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABCrxI6AAA%3d)**: You discussed the need to send a reminder about an upcoming event, possibly Ignite, scheduled for next week. You emphasized the importance of the event and the reminder[1](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABCrxI6AAA%3d).\\n- **[new meeting to test copilot interaction in meetings](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABCrxI5AAA%3d)**: This meeting was held last Friday from 12:30 PM to 1 PM[2](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABCrxI5AAA%3d).\\n- **[test meeting](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABAvsP6AAA%3d)**: You explained the significance of the Nobel Prize in Economics and announced the 2024 Nobel Prize winners, Darren Simon Johnson and James A. Robinson[3](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABAvsP6AAA%3d).\\n\\nAdditionally, there is a file titled **[OnCall DRI Handbook-v3](https://m365cpi17278319-my.sharepoint.com/personal/corat_m365cpi17278319_onmicrosoft_com/Documents/Microsoft%20Copilot%20Chat%20Files/OnCall%20DRI%20Handbook-v3.pdf?web=1)** that you last modified on February 4th, 2021. This document provides guidelines on handling incidents and includes important terminology and procedures[4](https://m365cpi17278319-my.sharepoint.com/personal/corat_m365cpi17278319_onmicrosoft_com/Documents/Microsoft%20Copilot%20Chat%20Files/OnCall%20DRI%20Handbook-v3.pdf?web=1).\\n\\nIs there anything specific you would like to know more about?\",\r\n      \"wrap\": true\r\n    },\r\n    {\r\n      \"type\": \"TextBlock\",\r\n      \"id\": \"MessageTextField\",\r\n      \"text\": \"It looks like there were no important emails from last week. However, I found some relevant meetings and files that might be of interest to you.\\n\\nFrom your meetings last week:\\n- **test meeting2 - export api[3]**: You discussed the need to send a reminder about an upcoming event, possibly Ignite, scheduled for next week. You emphasized the importance of the event and the reminder[^2^].\\n- **new meeting to test copilot interaction in meetings[3]**: This meeting was held last Friday from 12:30 PM to 1 PM[^3^].\\n- **test meeting[3]**: You explained the significance of the Nobel Prize in Economics and announced the 2024 Nobel Prize winners, Darren Simon Johnson and James A. Robinson[^4^].\\n\\nAdditionally, there is a file titled **OnCall DRI Handbook-v3[2]** that you last modified on February 4th, 2021. This document provides guidelines on handling incidents and includes important terminology and procedures[^1^].\\n\\nIs there anything specific you would like to know more about?\",\r\n      \"wrap\": true\r\n    }\r\n  ]\r\n}",
          "name": null
        }
      ],
      "links": [
        {
          "linkUrl": "https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABCrxI6AAA%3d&EntityRepresentationId=eed881a3-3121-4c71-8667-942284009b65",
          "displayName": "test meeting2 - export api",
          "linkType": "Event"
        },
        {
          "linkUrl": "https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABCrxI6AAA%3d",
          "displayName": "test meeting2 - export api",
          "linkType": "Meeting"
        },
        {
          "linkUrl": "https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABCrxI5AAA%3d&EntityRepresentationId=f0ccfd8e-4503-4a1d-b843-b61d63bc0cc0",
          "displayName": "new meeting to test copilot interaction in meetings",
          "linkType": "Event"
        },
        {
          "linkUrl": "https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABCrxI5AAA%3d",
          "displayName": "new meeting to test copilot interaction in meetings",
          "linkType": "Meeting"
        },
        {
          "linkUrl": "https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABAvsP6AAA%3d&EntityRepresentationId=c619b244-8016-45ca-a0fb-e6a55d28d252",
          "displayName": "test meeting",
          "linkType": "Event"
        },
        {
          "linkUrl": "https://teams.microsoft.com/l/meeting/details?eventId=AAMkADcyZTMzNWZhLWE1YjAtNDc3Mi04MzBlLTc2NzEzOTE0MmU1ZQBGAAAAAAC5e4DRHIMCQJ-tS6nB82CZBwCMIOyf3WTwTIsBMwZamp77AAAAAAENAACMIOyf3WTwTIsBMwZamp77AABAvsP6AAA%3d",
          "displayName": "test meeting",
          "linkType": "Meeting"
        },
        {
          "linkUrl": "https://m365cpi17278319-my.sharepoint.com/personal/corat_m365cpi17278319_onmicrosoft_com/Documents/Microsoft%20Copilot%20Chat%20Files/OnCall%20DRI%20Handbook-v3.pdf?web=1&EntityRepresentationId=025f05ac-5d7e-4ee1-b616-a786cd13d8c2",
          "displayName": "OnCall DRI Handbook-v3.pdf",
          "linkType": "File"
        }
      ],
      "mentions": []
    },
    {
      "id": "1732148356886",
      "sessionId": "19:YzBP1kUdkNjFtJnketPYT8kQdQ3A08Y51rDTxE_ENIk1@thread.v2",
      "requestId": "f128b7a9-657e-b420-201e-5602114a29f4",
      "appClass": "IPM.SkypeTeams.Message.Copilot.BizChat",
      "interactionType": "userPrompt",
      "conversationType": "bizchat",
      "etag": "1732148356886",
      "createdDateTime": "2024-11-21T00:19:16.886Z",
      "locale": "en-us",
      "contexts": [],
      "from": {
        "@odata.type": "#microsoft.graph.chatMessageFromIdentitySet",
        "application": null,
        "device": null,
        "user": {
          "@odata.type": "#microsoft.graph.teamworkUserIdentity",
          "id": "4db02e4b-d144-400e-b194-53253a34c5be",
          "displayName": "8:orgid:4db02e4b-d144-400e-b194-53253a34c5be",
          "userIdentityType": "aadUser",
          "tenantId": "061ea7c2-cc15-418b-bfc0-9f6a7d98011c"
        }
      },
      "body": {
        "contentType": "text",
        "content": "What should be on my radar from emails last week?"
      },
      "attachments": [],
      "links": [],
      "mentions": []
    }
  ]
}

Verwandte Inhalte

Microsoft Graph – dienstspezifische Drosselungslimiten

  • Last updated on