Microsoft Copilot 상호 작용 & Microsoft 365 Chat

  • 적용 대상: Microsoft Teams

Copilot 활동 내보내기 API를 사용하면 Copilot에 대한 사용자 프롬프트 및 사용자에 대한 Copilot 응답을 포함하는 Copilot 상호 작용 데이터를 내보낼 수 있습니다. 이 API는 사용자 의도 및 Copilot 액세스 리소스와 Teams, Word, Outlook과 같은 Microsoft 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 contexts[] 의 일부 상호 작용의 경우 상호 작용에서 aiResponse 누락될 수 있습니다. 그러나 정확한 컨텍스트 검색을 위해 해당 사용자 프롬프트에는 항상 포함됩니다 contexts[] . 개발 팀은 이 문제를 알고 있으며 해결을 위해 노력하고 있습니다. 다음 예제에서는 userprompt에 유효한 contexts[]가 있고 해당 aiResponse에 missing 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 상호 작용 내보내기 API scope에 포함되지 않음:

  • 델타 함수 호출은 지원되지 않습니다.
  • Copilot에서 생성된 특정 프레젠테이션 메타데이터는 Copilot 상호 작용 내보내기 API 응답에 포함되지 않습니다. 다음 메타데이터는 포함되지 않습니다.
    1. 편집 가능한 Copilot Microsoft 365 채팅 표시 이름입니다.
    2. Copilot에서 자동으로 생성하거나 제안하는 Outlook 메시지 제목 줄입니다.

참고

  • Copilot 상호 작용 내보내기 API에 대한 제한 제한을 이해하려면 Teams 내보내기 API 제한 한도를 참조하세요.
  • 최적의 성능을 위해 권장되는 $top 값은 100입니다.
  • 이 API는 삭제된 사용자에 대해 지원되는 Copilot 상호 작용을 검색하는 데 사용할 수 있습니다.
  • 지원되는 앱 클래스에 대해 삭제된 Copilot 상호 작용은 이 API를 사용하여 검색할 수 있습니다.
  • 사용자 프롬프트가 편집되면 새 상호 작용으로 간주되며 이 API를 사용하여 검색할 수 있습니다.
  • Last updated on