Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
API экспорта действий Copilot позволяет экспортировать данные взаимодействия Copilot, включая запрос пользователя к Copilot и ответ Copilot обратно пользователю. Этот API фиксирует намерение пользователя и ресурсы, к которым Copilot обращался, и ответ, возвращаемый пользователю в приложениях Microsoft Copilot, таких как Teams, Word и Outlook.
Как получить доступ к API экспорта действий Copilot
Пример 1 — это простой запрос для получения всех взаимодействий с Copilot без каких-либо фильтров:
GET https://graph.microsoft.com/v1.0/copilot/users/{id}/interactionHistory/getAllEnterpriseInteractionsПример 2 — это простой запрос для получения всех взаимодействий Copilot с фильтрами 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'
Предварительные требования для доступа к API экспорта действий Copilot
Разрешения приложений используются приложениями, которые работают без присутствия пользователя, вошедшего в систему. Только администратор может утвердить разрешения приложения. Необходимы следующие разрешения:
- AiEnterpriseInteraction.Read.All: обеспечивает доступ ко всем взаимодействиям Copilot в приложениях Microsoft 365 и Microsoft 365 Chat
- Для доступа к новому API экспорта действий Copilot требуется лицензия Microsoft Copilot.
Поддерживаемые фильтры appClass
Поддерживаются следующие фильтры appClass:
IPM.SkypeTeams.Message.Copilot.WordIPM.SkypeTeams.Message.Copilot.ExcelIPM.SkypeTeams.Message.Copilot.TeamsIPM.SkypeTeams.Message.Copilot.BizChatIPM.SkypeTeams.Message.Copilot.WebChatIPM.SkypeTeams.Message.Copilot.CoworkChat
Эти фильтры позволяют указать тип взаимодействий с Copilot, которые нужно извлечь, на основе класса приложения. Остальные взаимодействия не поддерживаются.
Дополнительные сведения об aiInteractionHistory: getAllEnterpriseInteractions , позволяющем экспортировать взаимодействия с Copilot.
Известные проблемы
Для некоторых взаимодействий в Teams Meeting Copilot эти параметры contexts[] могут отсутствовать во взаимодействиях aiResponse . Однако соответствующий запрос пользователя всегда включает для 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": []
}
]
Не входит в области API экспорта взаимодействий с Copilot:
- Вызов функции Delta не поддерживается.
- Некоторые метаданные презентации, созданные Copilot, не включаются в ответы API экспорта взаимодействий Copilot. Следующие метаданные не включены:
- Редактируемый Copilot Отображаемые имена в чате Microsoft 365.
- Строки темы сообщений Outlook, которые автоматически генерируются или предлагаются Copilot.
Примечание.
- Сведения об ограничениях регулирования для API экспорта взаимодействий Copilot см. в статье Ограничения регулирования API экспорта Teams.
- Для оптимальной производительности рекомендуемое значение $top — 100.
- Этот API можно использовать для получения поддерживаемых взаимодействий с Copilot для удаленных пользователей.
- Удаленные взаимодействия Copilot для поддерживаемых классов приложений можно получить с помощью этого API.
- При редактировании запроса пользователя это рассматривается как новое взаимодействие и может быть получено с помощью этого API.