会議 AI 分析情報 API を使用して AI で生成された会議の概要を取得する

2025-05-17

重要

会議AI 分析情報 API は、Microsoft Graph のベータ版で利用できます。詳細については、「 Microsoft Graph のバージョン管理、サポート、および破壊的変更ポリシー」を参照してください。
会議AI 分析情報 API は、Microsoft 365 Copilot API 名前空間の一部です。 Insights は、Microsoft 365 Copilotライセンスを持つユーザーに代わってのみフェッチできます。詳細については、「 Meeting Insights API のライセンス要件」を参照してください。

Meeting AI 分析情報 API を使用すると、文字起こしされたMicrosoft Teams会議から構造化された AI によって生成された分析情報にプログラムでアクセスできます。これらの分析情報には、次のものが含まれます。

包括的な会話の概要
ディスカッションから抽出されたアクション項目
参加者が直接言及される発話

API を使用すると、独自の AI インフラストラクチャを構築または維持する必要なく、重要なポイントの表示やフォローアップの生成など、インテリジェントな会議エクスペリエンスを提供できます。分析情報は、会議が終了した後に生成され、Microsoft Graph API エンドポイントを介してアクセスできます。

注:

会議AI 分析情報 API は、プライベートスケジュールされた会議についてのみ分析情報を提供します。

ユースケース

会議 AI 分析情報 API を使用して AI によって生成された分析情報を取得するためのユースケースを次に示します。

ユースケース	シナリオ	統合	影響
CRM 更新プログラムの会議の概要を自動生成する	営業チームは、Teams を介して定期的な顧客会議を行います。通話のたびに、会議の概要とフォローアップを CRM に記録する必要があります。	各会議の後、バックエンドサービスで会議終了イベントをリッスンし、Microsoft Graph API を使用して会議後の分析情報を取得できます。このサービスでは、概要とアクション項目が抽出され、会社の CRM レコードの特定のフィールドにマップされます。必要に応じて、統合には、更新プログラムを確認カード Teams メッセージを含めることができます。	- 手動入力を不要にすることで、営業担当者の時間を節約できます。 - すべての顧客操作でキーの詳細を一貫してキャプチャします。
プロジェクト管理アプリで会議後の知識をキャプチャする	製品チームとエンジニアリングチームは、設計と機能の決定を行うために定期的な会議を開催します。チームメンバーは、多くの場合、議論され、合意された内容を文書化することを忘れます。	ボットまたはバックグラウンドジョブを使用して、製品リードが所有する会議が終了した場合にGraph APIに対してクエリを実行できます。 API は分析情報をフェッチし、自然言語処理 (NLP) を使用して、意思決定、タスク、リスク項目などの分類を行います。これらの分類は、Azure DevOps、Jira、または Notion のタスクまたはメモに変換され、Graph ユーザー ID を使用して正しい利害関係者に割り当てられます。	- 情報の損失を防ぎます。 - 会話とタスク追跡のギャップを自動的に埋めます。 - アラインメントとアビリティを促進します。
戦略会議のエグゼクティブブリーフィングを生成する	エグゼクティブは、財務、運用、取締役会のレビューなどの機能全体で、複数の高レベルの会議に参加します。最新の状態を維持し、アクションを実行するには、迅速で信頼性の高いサマリーが必要です。	デジタルアシスタントを作成して、指定されたエグゼクティブ会議が終了した後にGraph APIを呼び出して分析情報を取得し、主要な意思決定とブロッカーに優先順位を付け、簡潔な毎日のブリーフィングカードにフォーマットすることができます。このカードは、エグゼクティブの Teams チャットに投稿されるか、朝のメールの概要として送信されます。必要に応じて、統合では、会議間でキーワード (keyword)クラスタリングを使用して定期的なテーマを強調表示できます。	- エグゼクティブフォーカスと意思決定速度を向上させます。 - 手動によるメモとフォローアップへの依存を減らします。より迅速な機能間認識を実現します。

前提条件

分析情報を生成する会議の文字起こしまたは記録を有効にする必要があります。または、 update onlineMeeting API を使用するか、会議オプションを直接使用して、プログラムで自動書き起こしまたは自動記録するように会議を設定することもできます。
Meeting AI 分析情報 API は委任されたアクセス許可でのみ機能するため、サインインしているユーザーからのトークンを呼び出しで渡す必要があります。サインインしているユーザーは、Microsoft 365 Copilot ライセンスを持ち、会議のトランスクリプトファイルにアクセスできる必要があります。

会議の分析情報を取得する

特定の会議の分析情報を取得するには、次の手順に従います。

会議識別子 (id) がない場合は、 JoinWebUrl プロパティを使用してオンライン会議 API を呼び出して、 idを取得します。詳細については、「 JoinWebUrl でオンライン会議を取得する」を参照してください。

会議の各トランスクリプトイベントは、関連付けられた AI 分析情報オブジェクトを作成します。 List AI 分析情報 API を使用して、会議に関連するすべての AI 分析情報オブジェクトをフェッチし、応答に含まれているメタデータを使用して、シナリオに関連する AI 分析情報オブジェクトを選択します。要求と応答の例を次に示します。

要求

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

Response

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#copilot/users('000000000-0000-0000-0000-000000000000')/onlineMeetings('00000...')/aiInsights",
  "@odata.count": 1,
  "value": [
    {
      "id": "VjEj...",
      "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
      "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
      "createdDateTime": "2025-05-09T08:17:10.7261294Z",
      "endDateTime": "2025-05-09T08:17:10.7261294Z"
    }
  ]
}

プロパティ	説明
`id`	生成された AI 分析情報オブジェクトの一意の識別子。
`callId`	この分析情報が生成される呼び出しの一意識別子。
`contentCorrelationId`	AI 分析情報オブジェクトの生成元となる会議のトランスクリプトを関連付ける一意の識別子。
`createdDateTime`	対応するトランスクリプトが作成された日時。タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に協定世界時 (UTC) です。
`endDateTime`	対応するトランスクリプトが終了する日時。タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。

各 AI 分析情報オブジェクトには、詳細な会議メモ、アクションアイテム、参加者固有のメンションが用意されています。これは、特定の分析情報オブジェクト ID に対して GET AI 分析情報 API を呼び出すことによってアクセスできます。要求と応答の例を次に示します。

要求

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

Response

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#copilot/users('00000000-0000-0000-0000-000000000000')/onlineMeetings('000000...')/aiInsights/$entity",
  "id": "Z2HWbT...",
  "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
  "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
  "createdDateTime": "2025-05-15T08:17:10.7261294Z",
  "endDateTime": "2025-05-15T08: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",
    },
  ],
  "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."
      },
    ]
  }
}

プロパティ	説明
`meetingNotes`	Copilot によって生成された会議ディスカッションの詳細なメモMicrosoft Teams含まれています。ノートには、ディスカッションのタイトル、概要、詳細なサブポイントが含まれます。
`actionItems`	会議の会話から生成されたアクションアイテムを含みます。アクション項目には、アクションアイテムと割り当てられた所有者の概要が含まれます。
`viewpoint.mentionEvents`	会話の参加者固有の情報が含まれます。これには、ユーザーがメンションされたときの会議のタイムスタンプを含むメンション、話者、発話の詳細が含まれます。

制限事項

AI によって生成された分析情報は、会議が終了した後にのみ使用できます。 API では、会議中のライブノートへのアクセスはサポートされていません。
AI によって生成された分析情報は、呼び出しの終了後に使用可能になるまでに最大 4 時間かかる場合があります。
アプリケーションレベルのアクセス許可はサポートされていません。

コードサンプル

サンプルの名前	説明	Node.js
会議 AI 分析情報ボット	このサンプルアプリでは、会議AI 分析情報 API を使用して会議の概要、アクションアイテム、メンションを取得し、ダイアログに表示します。	表示

次の方法で共有

会議 AI 分析情報 API を使用して AI で生成された会議の概要を取得する

ユース ケース

前提条件

会議の分析情報を取得する

制限事項

コード サンプル

関連項目

フィードバック

その他のリソース

ユースケース

コードサンプル