Microsoft 365 Copilot 상호 작용 & Microsoft 365 Chat

Copilot 활동 내보내기 API를 사용하면 Copilot에 대한 사용자 프롬프트 및 Copilot 응답을 사용자에게 다시 포함하는 Copilot 상호 작용 데이터를 내보낼 수 있습니다. 이 API는 Teams, Word 및 Outlook과 같은 Microsoft 365 Copilot 앱에서 사용자 의도 및 Copilot 액세스 리소스 및 사용자에 대한 응답을 캡처합니다.

Copilot 활동 내보내기 API에 액세스하는 방법

• 예제 1 은 필터 없이 모든 부조종사 상호 작용을 검색하는 간단한 쿼리입니다.

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

• 예제 2 는 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'
  

Copilot 활동 내보내기 API에 액세스하기 위한 필수 구성 요소

애플리케이션 권한은 로그인한 사용자 없이 실행되는 앱에서 사용됩니다. 관리자만 애플리케이션 권한을 승인할 수 있습니다. 다음 권한이 필요합니다.

• AiEnterpriseInteraction.Read.All: Microsoft 365 앱 및 Microsoft 365 Chat 전체의 모든 부조종사 상호 작용에 액세스할 수 있습니다.
• 새 Copilot 활동 내보내기 API에 액세스하려면 Microsoft 365 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에 유효한 컨텍스트[]가 있고 해당 aiResponse에서 누락된 컨텍스트[]가 있는 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": []
    }
]