重要
版本下的 /beta API 可能会更改。 不支持在生产应用程序中使用这些 API。
获取与 onlineMeeting 关联的 callAiInsight 对象。
此 API 返回与联机会议关联的单个 AI 见解集的元数据和内容。
注意
- 此 API 具有许可证要求。 有关详细信息，请参阅 Teams 会议 AI 见解 API 的许可证要求。
- 此 API 在一个或多个国家/地区云中的工作方式不同。 有关详细信息，请参阅 Microsoft国家云中的 Teams API 实现差异。
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。
| 权限类型 | 最低特权权限 | 更高特权权限 |
|---|---|---|
| 委派（工作或学校帐户） | OnlineMeetingAiInsight.Read.All | 不可用。 |
| 委派（个人 Microsoft 帐户） | 不支持。 | 不支持。 |
| 应用程序 | OnlineMeetingAiInsight.Read.All | 不支持。 |
若要对此 API 使用应用程序权限，租户管理员必须创建应用程序访问策略并将其授予用户。 它授权策略中配置的应用使用请求路径) 中指定的用户 ID 代表该用户 (提取联机会议或联机会议项目。 有关详细信息，请参阅 允许应用程序代表用户访问联机会议。
注意
此 API 仅适用于尚未过期的会议。 有关详细信息，请参阅 Microsoft Teams 的限制和规范。
HTTP 请求
获取联机会议的一组 AI 见解。
GET https://graph.microsoft.com/v1.0/copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights/{aiInsightId}
GET https://graph.microsoft.com/beta/copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights/{aiInsightId}
可选的查询参数
此方法支持 $selectOData 查询参数 来帮助自定义响应。
请求标头
| 名称 | 说明 |
|---|---|
Authorization |
Bearer {token}. 必填。 详细了解 身份验证和授权。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功，此方法在 200 OK 响应正文中返回响应代码和 callAiInsight 对象。
示例
示例：获取呼叫 AI 见解
以下示例演示如何为联机会议获取一组 AI 见解。
请求
以下示例显示了一个请求。 为了提高可读性，示例中的 ID 已缩短。
GET https://graph.microsoft.com/v1.0/copilot/users/b935e675-5e67-48b9-8d45-249d5f88e964/onlineMeetings/YTc3OT.../aiInsights/Z2HWbT...
GET https://graph.microsoft.com/beta/copilot/users/b935e675-5e67-48b9-8d45-249d5f88e964/onlineMeetings/YTc3OT.../aiInsights/Z2HWbT...
响应
以下示例显示了相应的响应。 为了提高可读性，可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#copilot/users('b935e675-5e67-48b9-8d45-249d5f88e964')/onlineMeetings('YTc3OT...')/aiInsights/$entity",
"id": "Z2HWbT...",
"callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
"contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
"createdDateTime": "2024-05-27T08:17:10.7261294Z",
"endDateTime": "2024-05-27T08:32:10.7261294Z",
"meetingNotes": [
{
"title": "Introducing Project Objectives and Key Stakeholders",
"text": "The stakeholders present included representatives from each department involved in the project, ensuring alignment and clear communication channels from the start.",
"subpoints": [
{
"title": "Discussion on action items",
"text": "Action items were assigned to team members, and a follow-up meeting schedule was established."
}
]
}
],
"actionItems": [
{
"title": "Finalize Project Timeline",
"text": "Review and finalize the project timeline to ensure alignment with stakeholder expectations and resource availability.",
"ownerDisplayName": "Bella Smith"
},
{
"title": "Prepare Presentation Draft",
"text": "Draft a presentation outlining project goals, objectives, and progress updates for review by the project stakeholders.",
"ownerDisplayName": "Bella Smith"
},
],
"viewpoint": {
"mentionEvents": [
{
"speaker": {
"application": null,
"device": null,
"user": {
"@odata.type": "#Microsoft.Teams.GraphSvc.teamworkUserIdentity",
"id": "9a7608d3-53e4-4a92-804f-ef43f1e5f5b5",
"displayName": "John Smith",
"userIdentityType": "aadUser",
"tenantId": "d1aeb56e-5a25-4d91-a4f6-0f5e6a50d887"
}
},
"eventDateTime": "2024-05-21T09:00:00",
"transcriptUtterance": "We need to get approval from Sarah Johnson before proceeding with the budget allocation."
},
{
"speaker": {
"application": null,
"device": null,
"user": {
"@odata.type": "#Microsoft.Teams.GraphSvc.teamworkUserIdentity",
"id": "6aeb9f22-c986-4835-9617-9e5932bc8250",
"displayName": "Emily Davis",
"userIdentityType": "aadUser",
"tenantId": "d1aeb56e-5a25-4d91-a4f6-0f5e6a50d887"
}
},
"eventDateTime": "2024-05-21T09:15:00",
"transcriptUtterance": "Sarah Johnson suggested reaching out to potential vendors for the upcoming project."
}
]
}
}
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#copilot/users('b935e675-5e67-48b9-8d45-249d5f88e964')/onlineMeetings('YTc3OT...')/aiInsights/$entity",
"id": "Z2HWbT...",
"callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
"contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
"createdDateTime": "2024-05-27T08:17:10.7261294Z",
"endDateTime": "2024-05-27T08:32:10.7261294Z",
"meetingNotes": [
{
"title": "Introducing Project Objectives and Key Stakeholders",
"text": "The stakeholders present included representatives from each department involved in the project, ensuring alignment and clear communication channels from the start.",
"subpoints": [
{
"title": "Discussion on action items",
"text": "Action items were assigned to team members, and a follow-up meeting schedule was established."
}
]
}
],
"actionItems": [
{
"title": "Finalize Project Timeline",
"text": "Review and finalize the project timeline to ensure alignment with stakeholder expectations and resource availability.",
"ownerDisplayName": "Bella Smith"
},
{
"title": "Prepare Presentation Draft",
"text": "Draft a presentation outlining project goals, objectives, and progress updates for review by the project stakeholders.",
"ownerDisplayName": "Bella Smith"
},
],
"viewpoint": {
"mentionEvents": [
{
"speaker": {
"application": null,
"device": null,
"user": {
"@odata.type": "#Microsoft.Teams.GraphSvc.teamworkUserIdentity",
"id": "9a7608d3-53e4-4a92-804f-ef43f1e5f5b5",
"displayName": "John Smith",
"userIdentityType": "aadUser",
"tenantId": "d1aeb56e-5a25-4d91-a4f6-0f5e6a50d887"
}
},
"eventDateTime": "2024-05-21T09:00:00",
"transcriptUtterance": "We need to get approval from Sarah Johnson before proceeding with the budget allocation."
},
{
"speaker": {
"application": null,
"device": null,
"user": {
"@odata.type": "#Microsoft.Teams.GraphSvc.teamworkUserIdentity",
"id": "6aeb9f22-c986-4835-9617-9e5932bc8250",
"displayName": "Emily Davis",
"userIdentityType": "aadUser",
"tenantId": "d1aeb56e-5a25-4d91-a4f6-0f5e6a50d887"
}
},
"eventDateTime": "2024-05-21T09:15:00",
"transcriptUtterance": "Sarah Johnson suggested reaching out to potential vendors for the upcoming project."
}
]
}
}