Microsoft Copilot対話式操作 & Microsoft 365 Chat

Copilot アクティビティのエクスポート API を使用すると、ユーザー プロンプトを Copilot に、Copilot からユーザーに返す応答を含む Copilot 対話データをエクスポートできます。 この API は、Teams、Word、Outlook などの Microsoft Copilot アプリ全体で、ユーザーの意図と Copilot がアクセスしたリソース、およびユーザーへの応答をキャプチャします。

Copilot アクティビティ エクスポート API にアクセスする方法

• 例 1 は、フィルターを使用せずにすべての Copilot 操作を取得する単純なクエリです。

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

• 例 2 は、AppClass フィルターを使用したすべての Copilot 操作を取得する単純なクエリです。

  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'
  

Copilot アクティビティ エクスポート API にアクセスするための前提条件

アプリケーションのアクセス許可は、サインインしているユーザーなしで実行されるアプリによって使用されます。 管理者のみがアプリケーションのアクセス許可を承認できます。 以下のアクセス許可が必要です。

• AiEnterpriseInteraction.Read.All: Microsoft 365 アプリと Microsoft 365 Chat 間のすべての Copilot 操作にアクセスできるようにします
• 新しい Copilot アクティビティ エクスポート API にアクセスするには、Microsoft Copilot ライセンスが必要です。

サポートされている appClass フィルター

次の 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

これらのフィルターを使用すると、アプリ クラスに基づいて取得する Copilot 対話の種類を指定できます。 それ以外の操作はサポートされていません。

Copilot の対話のエクスポートを可能にする aiInteractionHistory: getAllEnterpriseInteractions の詳細について説明します。

既知の問題

Teams 会議 Copilot の一部のやりとりでは、aiResponseやり取りにcontexts[]が欠落している可能性があります。 ただし、正確なコンテキスト取得を確実に行えるように、対応するユーザー プロンプトには常に contexts[] が含まれています。 開発チームはこの問題を認識しており、解決に取り組んでいます。 次の例は、userPrompt に有効な context[] を持ち、対応する aiResponse に contexts[] が欠落している userPrompt と 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": []
    }
]

Copilot Interactions のエクスポート API のスコープ外:

• デルタ関数の呼び出しはサポートされていません。
• 特定の Copilot で生成されたプレゼンテーション メタデータは、Copilot Interactions Export API 応答に含まれません。 次のメタデータは含まれません。
  1. 編集可能な Copilot Microsoft 365 チャットの表示名。
  2. Copilot によって自動的に生成または提案される Outlook メッセージの件名。