Microsoft 365 Copilot API を試してみる / Trying out Microsoft 365 Copilot APIs

Transcript

1. Microsoft 365 Copilot API を試してみる 2026/02/05 第 13 回 JPM365DEV 勉強会
2. 篠原 敬志 (Takashi Shinohara) アバナード株式会社 マネージャー, アジャイル コーチ Microsoft MVP for M365 (2018-2026) Microsoft Top Partner Engineer Award (2023) JPM365DEV 運営
3. 免責事項 本資料は 2026/2/5 時点の情報です。最新の情報については必ず公式情報を参照するように してください。
4. Microsoft 365 Copilot エージェントの開発手法 宣言型エージェント • ノーコード型のエージェント • Copilot Studio エージェント ビルダーや Visual Studio Code を使って開発 • 小規模のチーム Copilot Studio エージェント • ローコード型のエージェント • Copilot Studio を使って開 発 • 小～中規模のチーム カスタム エージェント • プロコード型のエージェント • Visual Studio や Visual Studio Code を使って開発 • 大規模のチーム
6. 一般的なカスタム エージェントのアーキテクチャ Microsoft 365 Copilot Azure AI Bot Service Azure Web App Azure OpenAI Service Azure AI Search SharePoint Online
7. Azure AI Search を使ったカスタム エージェントの問題点 サイズ Azure AI Search のインデックス サイズは Microsoft 365 に比べて小さく高額 レイテンシ Microsoft 365 のデータが多ければ多いほどクロールに時間がかかる セキュリティ Azure AI Search に Microsoft 365 のアクセス制限リスト (ACL) を取り込む必要がある 共有リンク、情報管理ポリシー、秘密度ラベルには対応できない
8. Microsoft Search を使ったカスタム エージェントの問題点 検索精度 Microsoft Search は検索精度が悪い (と思われている) アーキテクチャ ドキュメント検索であるため LLM に適切なデータを渡せない
10. Microsoft 365 Copilot API の登場 Microsoft 365 Copilot が使用しているインデックスを使用したカスタム エージェント Microsoft 365 Copilot を統合したカスタム アプリ ユーザーと Microsoft 365 Copilot の会話の収集・通知・分析
11. Microsoft 365 Copilot セマンティック インデックス これまでの全文検索とは異なり文の意味を数値化してインデックス化する 多次元のベクター空間の類似度によって検索結果を得る Microsoft 365 Copilot ライセンスのあるテナントには自動的にインデックスが作成される 既存の Microsoft Search の検索結果には影響しない セマンティック インデックスをオプトアウトすることはできない サイトやドキュメント ライブラリを除外することはできるが Microsoft Search の検索結果からも除 外される
12. セマンティック インデックスの種類と保存場所 テナント レベル インデックス SharePoint Online ファイルから生成された組織全体のインデックス SharePoint サイトが配置されているリージョンの分離されたコンテナーに格納 ユーザー レベル インデックス 日常のタスクを実行するユーザーがアクセスできる作業セットの個人用インデックス ユーザーのメールボックスがある場所に格納
13. サポートされているコンテンツ タイプ コンテンツ/ファイルの種類 ユーザー レベル テナントのレベル ユーザー メールボックス サポート 該当なし 委任されたメールボックス サポート対象外 該当なし 共有メールボックス サポート対象外 該当なし アーカイブされたメールボックス データ サポート対象外 該当なし アーカイブされた SharePoint データ サポート対象外 サポート対象外 Word ドキュメント (doc/docx) サポート サポート PowerPoint プレゼンテーション (pptx) サポート サポート PDF ファイル サポート サポート Web ページ (aspx) サポート サポート OneNote ファイル (one) サポート サポート Microsoft 365 Copilot コネクタのデータ 該当なし サポート
14. データのチャンク化 セマンティック インデックスを作成するときにはドキュメントを一定のサイズに分割する • 埋め込みモデルのトークン サイズの問題 (最大 8,191 トークン) • 検索精度の向上 (分割されていたほうが特徴が出やすい) • パフォーマンスの向上 (必要な部分だけを参照できる) Microsoft 365 Copilot セマンティック インデックスでもチャンク化は行われているがパラメーターを 調整することはできない
15. Microsoft 365 Copilot API の種類 API の種類 一般提供 説明 取得 API Y Microsoft 365 Copilot の検索インデックスからチャンクを取得する API 検索 API N Microsoft 365 Copilot のハイブリッド検索を使用してコンテンツを検索する API 対話エクスポート API Y Microsoft 365 Copilot との会話履歴をエクスポートする API 変更通知 API N Microsoft 365 Copilot との会話の通知を受け取る API 会議の分析情報 API Y Teams 会議の AI で生成されたコンテンツを抽出する API チャット API N Microsoft 365 Copilot との会話を作成する API 使用状況レポート API Y Microsoft 365 Copilot の使用状況を取得する API パッケージ管理 API Y 組織内のすべてのエージェントとアプリを管理する API
16. 取得 API エンドポイント POST /v1.0/copilot/retrieval アクセス許可 委任されたアクセス許可: Files.Read.All、Sites.Read.All アプリケーションのアクセス許可: サポートなし Microsoft 365 Copilot セマンティック インデックスのチャンク化された結果を取得する resourceMetadata を指定することで SharePoint の管理プロパティを取得できる RAG で使用することを想定しているためページングはできない
17. 検索 API エンドポイント POST /beta/copilot/search アクセス許可 委任されたアクセス許可: Files.Read.All、Sites.Read.All アプリケーションのアクセス許可: サポートなし 自然言語クエリに加えてこれまでの KQL (キーワード クエリ言語) によるフィルターをサポートする Microsoft Search とセマンティック インデックスのハイブリッド検索を実行できる
18. 対話エクスポート API エンドポイント GET /v1.0/copilot/users/{userId}/interactionHistory/getAllEnterpriseInteractions アクセス許可 委任されたアクセス許可: サポートなし アプリケーションのアクセス許可: AiEnterpriseInteraction.Read.All Teams エクスポート API は従量課金制だが Copilot 対話エクスポート API は Microsoft 365 Copilot ライセンスがあれば呼び出せる
19. 変更通知 API エンドポイント POST /v1.0/subscriptions アクセス許可 委任されたアクセス許可: AiEnterpriseInteraction.Read アプリケーションのアクセス許可: AiEnterpriseInteraction.Read.All サブスクリプションのリソースに以下のいずれかを設定する /copilot/users/{user-id}/interactionHistory/getAllEnterpriseInteractions /copilot/interactionHistory/getAllEnterpriseInteractions サブスクリプションの有効期間は最長 3 日間 (4,320 分) を設定できる 変更通知でリソース データを受け取る場合は暗号化されたデータを復号する必要がある
20. 会議の分析情報 API エンドポイント GET /v1.0/copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights アクセス許可 委任されたアクセス許可: OnlineMeetingAiInsight.Read.All アプリケーションのアクセス許可: OnlineMeetingAiInsight.Read.All 事前に会議の文字起こしまたはレコーディングを有効にする必要がある 会議終了後でないと取得できない
21. チャット API エンドポイント POST /beta/copilot/conversations/{conversationId}/chat アクセス許可 委任されたアクセス許可: Sites.Read.All、Mail.Read、People.Read.All、 OnlineMeetingTranscript.Read.All、Chat.Read、ChannelMessage.Read.All、 ExternalItem.Read.All アプリケーションのアクセス許可: サポートなし タイム ゾーンをを必ず設定する必要がある additionalContext を指定することで追加のコンテキストを設定できる
22. 使用状況レポート API エンドポイント GET /v1.0/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period={period}) アクセス許可 委任されたアクセス許可: Reports.Read.All アプリケーションのアクセス許可: Reports.Read.All period は D7、D30、D90、D180、ALL のいずれかを設定する レポートは CSV 形式でダウンロードできる
23. パッケージ管理 API エンドポイント GET /beta/copilot/admin/catalog/packages アクセス許可 委任されたアクセス許可: CopilotPackages.Read.All アプリケーションのアクセス許可: CopilotPackages.Read.All
24. DEMO Graph Explorer を使用した API の呼び出し
25. まとめ Microsoft 365 Copilot API を使うことでカスタム エージェントがもっと便利に まだベータ機能も多いため今後に期待
26. ご清聴ありがとうございました！