使用会议AI 见解 API 获取 AI 生成的会议摘要

会议AI 见解 API 允许你以编程方式从听录Microsoft Teams 会议访问结构化 AI 生成的见解。 这些见解包括：

• 综合对话摘要
• 从讨论中提取的作项
• 直接提及参与者的话语

该 API 使你能够提供智能会议体验，例如显示关键要点或生成后续内容，而无需构建或维护自己的 AI 基础结构。 见解在会议结束后生成，可通过Microsoft图形 API终结点访问。

用例

下面是使用会议AI 见解 API 提取 AI 生成的见解的一些用例：

先决条件

• 必须 打开会议的听录或录制 才能生成见解。 或者，可以使用 更新 onlineMeeting API 或直接通过 会议选项以编程方式将会议设置为自动转录或自动录制。

提取会议见解

若要获取特定会议的见解，请执行以下步骤：

1. 如果没有会议标识符 () id ，请使用 属性调用联机会议 API JoinWebUrl 以检索 id。 有关详细信息，请参阅 通过 JoinWebUrl 检索联机会议。

2. 会议的每个脚本事件都会创建一个关联的 AI 见解对象。 使用列表AI 见解 API 提取与会议相关的所有 AI 见解对象，并在响应中使用包含的元数据为方案选择相关的 AI 见解对象。 下面是示例请求和响应：

示例

请求

以下示例检索特定联机会议的所有 AI 见解对象。

GET /copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights

响应

以下示例显示了一个包含 AI 见解对象列表的响应。 为了提高可读性，示例中的 ID 已缩短。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#copilot/users('22431...')/onlineMeetings('MSoyM...')/aiInsights",
  "@odata.count": 1,
  "value": [
    {
      "id": "VjEjI...",
      "callId": "97d0b...",
      "contentCorrelationId": "fb7aa...",
      "createdDateTime": "2025-12-08T05:41:31Z",
      "endDateTime": "2025-12-08T05:41:31Z"
    },
  ],
}

1. 每个 AI 见解对象都提供详细的会议说明、作项和特定于参与者的提及，可通过调用 GET AI 见解 API 获取特定见解对象 ID 来访问这些说明。 下面是示例请求和响应：

示例

请求

下面的示例演示如何检索 AI 见解对象。

GET /copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights/{aiInsightId}

响应

以下示例显示了包含详细会议摘要的响应。 为了提高可读性，示例中的 ID 已缩短。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#copilot/users('22431...')/onlineMeetings('MSoyM...')/aiInsights/$entity",
  "id": "VjEjI...",
  "callId": "97d0b...",
  "contentCorrelationId": "fb7aa...",
  "createdDateTime": "2025-12-08T05:41:31Z",
  "endDateTime": "2025-12-08T05:41:31Z",
  "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": "Project Timeline Finalization",
      "text": "Review and finalize the project timeline to ensure alignment with stakeholder expectations and resource availability.",
      "ownerDisplayName": "Bella Smith"
    },
  ],
  "viewpoint": {
    "mentionEvents": [
      {
        "eventDateTime": "2025-12-08T05:30:00Z",
        "transcriptUtterance": "We need to get approval from Sarah Johnson before proceeding with the budget allocation.",
        "speaker": {
            "application": null,
            "device": null,
            "user": {
                "@odata.type": "#microsoft.graph.teamworkUserIdentity",
                "id": "9a760...",
                "displayName": "John Smith",
                "userIdentityType": "aadUser",
                "tenantId": "d1aeb..."
            }
        },
      },
    ]
  }
}

限制

• AI 生成的见解仅在会议结束后可用。 API 不支持在会议期间访问实时笔记。
• AI 生成的见解可能需要长达 4 小时才能在通话结束后可用。

代码示例

另请参阅

• callAiInsight 资源类型
• 使用 Microsoft Graph 中的云通信 API