東京エレクトロンデバイス株式会社

Microsoft Azureコラム

2026/10/30

Writer: 手戸 蒼唯(てど あおい)

Microsoft 365 Copilot APIsで自社アプリにCopilotの機能を組み込む|主な機能・活用シーンを解説

Microsoft 365 Copilot APIsは、Microsoft Copilot(旧称:Microsoft 365 Copilot)を支える機能やコンポーネントを、独自の業務アプリケーションやカスタムエンジンエージェントから安全に利用するためのREST API群です。たとえばRetrieval APIを使えば、データを別の検索基盤へ複製しなくても、既存のアクセス制御を保ったまま社内データを回答生成の根拠に利用できます。

本記事では、Microsoft Graph APIとの違い、提供される9つのAPIと主な機能、セキュリティ・認証モデル、料金、利用手順、活用シーン、注意点を解説します。


東京エレクトロンデバイスは、Microsoft Copilotの導入から、Microsoft 365 Copilot APIsを活用した生成AIアプリケーションの設計・実装までを支援しています。

ご興味のある方はお気軽にご相談ください。

お問い合わせはこちら


Microsoft 365 Copilot・Copilot Studio 完全ガイドを無料ダウンロード

Microsoft 365 Copilot APIsとは?

Microsoft 365 Copilot APIsとは、Microsoft Copilot(旧称:Microsoft 365 Copilot)を支える機能やコンポーネントを、独自の業務アプリケーションやカスタムエンジンエージェントから安全に利用するためのREST API群です。

各APIは、Microsoft Graph名前空間の下(https://graph.microsoft.com/v1.0/copilotおよびhttps://graph.microsoft.com/beta/copilot)で提供されています。


従来、Microsoft 365内のデータをRAGに利用する場合、SharePointやOneDriveのコンテンツを別の検索基盤へ複製し、インデックス化やチャンク化、権限管理などを独自に構築・運用する構成が採られることがありました。そのため、検索基盤の更新やアクセス制御の維持が運用負担になる場合があります。Microsoft 365 Copilot APIsを利用すると、Microsoft 365のデータやCopilotを支えるAI機能を、独自アプリケーションから活用できます。たとえばRetrieval APIを使えば、データを別の検索基盤へ複製しなくても、Microsoft Copilotを支えるインデックスから回答生成の根拠となる関連テキストを取得できます。


なお、製品名はMicrosoft Copilotに変わりましたが、API群の名称は2026年10月時点においては「Microsoft 365 Copilot APIs」となっています。

Microsoft Copilotの概要Microsoft CopilotにおけるMicrosoft Graph、組織データ、LLMを利用した処理の流れ(出典:Microsoft Learn)


Microsoft 365 Copilot APIsとMicrosoft Graph APIの違い

Microsoft 365 Copilot APIsとMicrosoft Graph APIは、どちらもMicrosoft Graphの共通基盤を利用していますが、主な役割やライセンス体系が異なります。

以下の表で、両者の位置づけを対比しました。

観点

Microsoft Graph API

Microsoft 365 Copilot APIs

主な役割

Microsoft 365データの取得・操作

AIによる検索・会話・分析・管理

ライセンス

対象サービスのライセンスが基本

Microsoft Copilotライセンスが基本

データの扱い

データへ直接アクセス・操作

データを活用したAI処理やCopilot情報の取得

主な用途

データ連携・業務自動化

AIアプリ・エージェント・監査・管理

Microsoft Graphを構成する主なMicrosoft 365リソースMicrosoft Graphを構成する主なMicrosoft 365リソース(出典:Microsoft Learn)


基本的な使い分けとして、Microsoft 365のデータやリソースへ直接アクセス・操作したい場合はMicrosoft Graph API、Microsoft 365データを活用したAI機能を組み込みたい場合はMicrosoft 365 Copilot APIsを選びます。たとえばファイルの一覧を取得するだけならMicrosoft Graph API、社内文書を根拠に自然言語で回答する仕組みを作るならRetrieval APIが適しています。


Microsoft 365 Copilot APIsで提供される9つのAPI

2026年10月時点で、Microsoft 365 Copilot APIsの公式の概要ページには9種類のAPIが掲載されています。


以下の表で、各APIの役割と提供ステータスを整理しました。

API

役割

提供ステータス

Retrieval API

RAG用の関連テキストを取得

一般提供(Pay-as-you-goはプレビュー)

Search API

OneDriveをハイブリッド検索

プレビュー

Chat API

Copilotとのマルチターン会話を組み込み

プレビュー

Interaction Export API

Copilotのプロンプトや応答などを取得

一般提供

AI Interactions Change Notifications API

CopilotのAI interaction発生を通知

プレビュー

Meeting Insights API

Teams会議のAI生成メモ・アクションアイテムなどを取得

一般提供

AI Insights Change Notifications API

Teams会議のAI Insights生成を通知

プレビュー

Copilot usage reports API

Copilotのユーザー数・利用状況を取得

v1.0で提供

Package Management API

組織内のエージェントを棚卸し・管理

List/Getは一般提供、管理操作はプレビュー


9つのAPIは、役割によって4つに分けられます。検索・グラウンディング系(Retrieval/Search)、会話系(Chat)、インサイト・通知・監査系(Interaction Export、Meeting Insights、2種類のChange Notifications)、管理・レポート系(Copilot usage reports、Package Management)です。


Microsoft 365 Copilot APIsの主な機能

ここでは、5つの主要API(Retrieval/Search/Chat/Interaction Export/Meeting Insights)について、扱えるデータの範囲と主な制約をご説明します。


Retrieval API

Retrieval APIは、Microsoft Copilotを支えるハイブリッドインデックスを利用し、質問に関連するテキストチャンク(パッセージ)を取得元URLやメタデータとともに取得するためのAPIです。対応データソースはSharePoint、OneDrive、Copilot connectorsで接続された外部データです。データを別の検索インデックスへ複製する必要がないため、独自のベクトルインデックスやチャンク化の基盤を構築・運用する負担を軽減できます。検索結果は、Microsoft 365のアクセス許可や秘密度ラベル、情報バリアなど、既存のアクセス制御・ガバナンス設定を尊重して返されます。


主な制限は、queryStringが1,500文字まで、maximumNumberOfResultsが最大25件です。1回のリクエストでdataSourceパラメータに指定できるデータソースは1種類のため、複数のデータソースを使う場合は、ソースごとに呼び出して結果をアプリケーション側で統合します。必要な権限は、SharePointとOneDriveのコンテンツがFiles.Read.AllとSites.Read.All、Copilot connectorsのコンテンツがExternalItem.Read.Allです。


ファイル形式によって取得方式も異なります。SharePoint/OneDriveでセマンティック取得・ハイブリッド取得に対応するのは.doc、.docx、.pptx、.pdf、.aspx、.oneのみで、それ以外の拡張子ではレキシカル取得のみが利用されます。制限の一覧はRetrieval API公式ドキュメントをご確認ください。


Search API

Search APIは、OneDrive for work or schoolのコンテンツに対して、セマンティック検索とレキシカル検索を組み合わせたハイブリッド検索を実行する、プレビュー段階のAPIです。自然言語によるクエリを受け取り、意図や文脈を考慮して、関連度の高いファイルやプレビュー、メタデータを返します。Retrieval APIとの主な違いは、Retrieval APIが回答生成のグラウンディングに利用するテキストを返すのに対し、Search APIは関連する文書やファイルを検索結果として返す点です。ナレッジポータルの検索機能や、ドキュメントディスカバリー機能を独自アプリケーションに実装する用途に適しています。


SharePointやCopilot connectorsには、現時点で対応していません。また、セマンティック検索の対象はOneDrive上の「パーソナライズされたワーキングセット」に限られ、ユーザーのOneDrive内のすべてのコンテンツが対象になるわけではありません。


Chat API

Chat APIは、エンタープライズ検索とWeb検索によるグラウンディングを利用したMicrosoft Copilotとの会話機能を、独自アプリケーションに組み込むためのプレビュー段階のAPIです。プロンプトを送信すると、Microsoft 365内の業務データやWeb情報をグラウンディングに利用して生成された回答が返されます。呼び出しには2種類のエンドポイントが用意されています。単一の完成した応答を一度に受け取る同期エンドポイントと、Server-Sent Events(SSE)で応答を段階的に受信するストリーミングエンドポイントです。応答を生成途中から逐次表示したい場合は、ストリーミングエンドポイントを利用します。


一方で、Chat APIにはファイル作成やメール送信、会議のスケジュール設定といったアクション実行は含まれないという明確な制限があります。コードインタープリターやグラフィック生成系のツールにも対応していません。メール送信やファイル作成などのタスク実行まで必要な場合は、ツールを組み込んだMicrosoft Foundry Agent Serviceなど、アクション実行に対応した仕組みを検討する必要があります。


また、Web検索によるグラウンディングを無効にする設定はメッセージ単位で適用されるため、不要なメッセージごとに無効化する必要があります。詳細はMicrosoft 365 Copilot Chat APIの概要(プレビュー)をご確認ください。なお、Microsoftは2026年8月に、従来のCopilot Chatのエンドポイントに代わる統合エンドポイントとしてWork IQ REST APIを案内しており、新しく開発するアプリケーションにはWork IQ APIを推奨しています。


Work IQ REST APIも、エンタープライズ検索とWeb検索でグラウンディングする会話のAPIです。ただし、Copilotライセンスがあれば追加料金なしで使えるChat APIと異なり、Work IQ APIの利用料はCopilot Creditsによる使用量ベースで発生します。Work IQ APIの詳細は、Work IQ APIの概要をご確認ください。


Interaction Export API

Interaction Export APIは、Interaction History Serviceに記録された、対応するCopilot interactionを取得するAPIです。Microsoft Teamsのエクスポート関連の資料では、Copilot Activity Export APIとも表記されます。ユーザーのプロンプトやCopilotの応答などを取得でき、コンプライアンスやデータガバナンス、利用状況の分析に活用できます。


サポートされるappClassフィルターには、Word、Excel、Teams、BizChat(Microsoft 365 Chat)、WebChat、CoworkChatがあります。コネクタやプラグインなどを通じて統合されたパートナーやLine-of-Business AIエクスペリエンスのinteractionも、組織でエクスポートが有効な場合は取得結果に含まれることがあります。一方、Copilot Studioで作成したエージェントのinteractionは取得できません。


エンドポイントはユーザー単位で、GET https://graph.microsoft.com/v1.0/copilot/users/{id}/interactionHistory/getAllEnterpriseInteractionsの形式で呼び出します。$filterパラメータでappClass(例:IPM.SkypeTeams.Message.Copilot.Teams)を指定すれば、アプリ種別で絞り込めます。


認証はApplication permissions(アプリ専用)のみで、AiEnterpriseInteraction.Read.Allと管理者同意が必要です。


Meeting Insights API

Meeting Insights APIは、Teams会議の書き起こしを基にAIが生成した会議メモ、アクションアイテム、参加者へのメンションを構造化データとして取得する、一般提供済みのAPIです。

まずGET /copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsightsで対象会議のAI Insight IDを取得し、そのIDを指定してGET /copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights/{aiInsightId}を呼び出します。


詳細レスポンスにはmeetingNotes、actionItems(担当者情報ownerDisplayNameを含む)、viewpoint.mentionEvents(発話・時刻・話者を含む)などが含まれます。アクセスにはMicrosoft Copilotライセンスが必要で、従量課金モデルや評価モードは利用できません。また、対象の会議で書き起こしまたはレコーディングが有効になっている必要があります。自動書き起こしや自動録画は、update onlineMeeting APIで設定できます。


対応する会議種別は、プライベートスケジュール会議、タウンホール、ウェビナー、Meet Nowセッションで、チャネル会議には現時点で対応していません。また、AI Insightsは会議終了後に生成され、利用可能になるまで最大4時間かかる場合があります。

Microsoft Teamsの会議要約画面Microsoft Teamsの会議要約画面(出典:Microsoft Support)


Microsoft 365 Copilot APIsのセキュリティ・認証モデル

Microsoft 365 Copilot APIsは、既存のMicrosoft Graphプラットフォームと同一の認証・認可モデルを採用しています。そのため、独自にコンプライアンス層やアクセス制御レイヤーを構築する必要はありません。

認証はMicrosoft Entra ID経由で行われ、REST呼び出し時にBearerトークンを付与する標準的なOAuth 2.0フローを利用します。


ただし、使えるアクセス許可の種類はAPIによって異なります。たとえばRetrieval APIはDelegated permissionsのみをサポートし、Interaction Export APIはApplication permissionsを利用します。複数のAPIを1つのアプリケーションから利用する場合は、必要なアクセス許可と管理者同意をAPIごとに整理しておきます。


Delegated permissionsでサインインユーザーとしてCopilot APIsを呼び出す場合、組織で設定済みの以下のポリシーが既定で適用されます。

  • 条件付きアクセス(Conditional Access):多要素認証、デバイスコンプライアンス、位置ベース制限といった既存のCAポリシーは、Copilot APIsの呼び出しにもそのまま適用されます。
  • 秘密度ラベル(Sensitivity Labels):秘密度ラベルによる保護設定(暗号化・アクセス制限)は、Copilot APIs経由でコンテンツを取得する際にも尊重されます。ラベルで守られたコンテンツは、権限のないユーザーのAPI応答には含まれません。
  • アクセス許可のトリミング(Permission trimming):応答結果はサインインユーザーがアクセス可能なコンテンツのみに絞り込まれます。関連度が高いコンテンツであっても、ユーザーに閲覧権限がなければ返されない仕組みです。


さらに、Copilot APIsの利用に関する監査ログはMicrosoft Purview経由で確認でき、規制対応や利用状況の可視化に組み込めます。もっとも、Interaction Export APIのようにApplication permissionsで呼び出すAPIには、サインインユーザーが存在しません。

そのため、多要素認証などユーザーを対象とした条件付きアクセスは適用されず、アクセス許可のトリミングもユーザー単位では行われません。アクセスできる範囲は付与したアクセス許可と管理者同意(admin consent)で決まるため、最小権限の原則に基づいてアクセス許可を設計し、社内のアプリ承認フローも整えておくと良いでしょう。


Microsoft 365 Copilot APIsの料金

Microsoft 365 Copilot APIsの料金は、利用者がMicrosoft Copilotライセンスを既に利用しているかどうかで扱いが分かれます。


Copilotライセンス保有ユーザーの料金

Package Management APIを除き、Microsoft 365 Copilot APIsは、Microsoft Copilotライセンスを持つユーザーに追加料金なしで提供されます。API呼び出し回数に応じた従量課金を個別に見積もる必要はありません。なお、Package Management APIの利用には、Microsoft Agent 365ライセンスが必要です。


ただし、Retrieval APIを独自のLLMやオーケストレーターと組み合わせる場合などは、モデルの推論費用やアプリケーションのホスティング費用が別途発生する可能性があります。これらは、Microsoft Copilotライセンスとは分けて見積もります。


Retrieval APIの従量課金モデル(プレビュー)

Retrieval APIでは、Microsoft Copilotライセンスを持たないユーザー向けにPay-as-you-go(従量課金)モデルがプレビューとして提供されています。


以下の表で、料金構造を整理しました。

項目

内容

単価

API呼び出し1回あたり$0.10(USD)

対象データソース

SharePoint、Copilot connectorsなど

対象外データソース

OneDrive(ユーザーレベルデータのため)

課金メーター

Pay as you go Copilot Credit(メーターカテゴリ:Microsoft Copilot Studio、Feature tag:

m365copilotretrievalapi

)

請求経路

Azureサブスクリプション経由

有効化場所

Microsoft 365管理センターの「Copilot」>「Billing & usage」>「Pay-as-you-go」>「Microsoft 365 Copilot Retrieval API」

前提条件

テナント内にMicrosoft Copilotライセンスが1つ以上/Azureサブスクリプション・リソースグループのOwnerまたはContributor権限/Microsoft 365管理者アクセス


この料金モデルを使えば、Copilotライセンスを持たないユーザー向けの社内ポータルから、SharePointを対象にRetrieval APIを呼び出せます。利用量によっては、ユーザーごとにCopilotライセンスを割り当てる場合とコストを比べて導入方式を選べます。

なお、Retrieval APIのPay-as-you-goが有効なライセンス非保有ユーザーは、Microsoft FoundryのSharePoint toolもPay-as-you-goで利用できます。

Pay-as-you-goの有効化・無効化は、反映まで約2時間かかる場合があります。本番利用時は反映時間を考慮し、余裕を持って設定します。詳細はMicrosoft LearnのRetrieval APIの従量課金(プレビュー)をご確認ください。


Copilot Creditsによる課金との違い

Copilot CoworkやWork IQ APIは、Copilot Creditsによる使用量ベース課金を採用しており、使用量をMicrosoft 365管理センターのCost Managementで管理します。一方、Retrieval APIのPay-as-you-goはAzureサブスクリプションに紐付けて課金され、Microsoft 365管理センターやAzure portalから利用状況・コストを確認できます。


Copilotエコシステム全体でコストを設計する場合は、サービスごとの課金・管理方式の違いを整理しておきます。Copilot Creditsの仕組みは、Microsoft LearnのCopilot Creditsの使用量ベース課金とコスト管理をご確認ください。


Microsoft 365 Copilot APIsの利用手順

ここでは、Microsoft 365 Copilot APIsを自社アプリに組み込むまでの基本的な流れを、Microsoft Entra IDへのアプリ登録からAPI呼び出しまでの順にご説明します。


ステップ1:必要に応じてアプリケーションパッケージを準備する

Microsoft 365上でエージェントとして配布する場合は、Microsoft 365アプリモデルに従って、マニフェスト・アイコン・メタデータを含むアプリパッケージを準備します。一方、独自のWebアプリケーションなどからCopilot APIsを直接呼び出す場合は、Microsoft Entra IDへのアプリ登録を中心に構成できます。

Microsoft 365 Agents Toolkitで作成したTeamsアプリのパッケージ構成例Microsoft 365 Agents Toolkitで作成したTeamsアプリのパッケージ構成例


ステップ2:Microsoft Entra IDにアプリを登録する

続いて、Entra ID管理センターからアプリ登録を行い、Application (client) IDを取得します。

Microsoft Entra IDに登録したアプリケーションの概要画面Microsoft Entra IDに登録したアプリケーションの概要画面


この段階で、対象APIに応じた権限(Retrieval APIならFiles.Read.All/Sites.Read.All、Interaction Export APIならAiEnterpriseInteraction.Read.Allなど)を要求し、管理者同意を取得します。

Microsoft Entra IDでMicrosoft Graphのアクセス許可を設定した画面Microsoft Entra IDでMicrosoft Graphのアクセス許可を設定した画面


Application (client) IDは、REST呼び出し時にリクエスト元のアプリケーションを識別するIDです。アプリマニフェストのidフィールドはMicrosoft 365のパッケージング・配布用の識別子で、Entra IDのApplication (client) IDとは別物のため、混同しないように注意します。


ステップ3:認証トークンを取得する

ランタイムでは、MSAL(Microsoft Authentication Library)などの認証ライブラリでApplication (client) IDと必要なスコープを指定し、アクセストークンを取得します。Delegated permissionsのAPIはサインインユーザーのトークン、Application permissionsのAPIはアプリ専用トークンで呼び出します。


ステップ4:Microsoft 365 Copilot APIsを呼び出す

取得したトークンをBearerトークンとしてHTTPヘッダーに付与し、各APIの正式なエンドポイントへRESTリクエストを送信します。

Graph ExplorerでMicrosoft 365 Copilot Retrieval APIのリクエストを設定した画面Graph ExplorerでMicrosoft 365 Copilot Retrieval APIのリクエストを設定した画面


実装を簡素化する手段として、Microsoft 365 Copilot APIs client librariesが提供されています。C#、TypeScript、Pythonに対応し、型付きのリクエストビルダーに加えて、再試行処理や認証、ペイロード圧縮などを支援します。ただし、プレビュー版のクライアントライブラリについては、本番環境での利用を避けるようMicrosoftから案内されています。


コードを書く前にInteractive DemoでAPIのリクエストとレスポンスを確認しておくと、PoCや実装範囲の検討に役立ちます。


Microsoft 365 Copilot APIsの活用シーン

ここでは、Microsoft 365 Copilot APIsを活用した代表的な業務システム連携のパターンをご紹介します。


社内ナレッジRAGアプリケーションの内製

社内Q&Aボットや部署専用のFAQアプリを構築する場合は、Retrieval APIを使って、SharePointやOneDrive、Copilot connectorsで接続された外部データから質問に関連する情報を取得し、回答生成の根拠として利用できます。

取得結果は利用者のアクセス許可に沿って絞り込まれるため、部署ごとに閲覧範囲が異なるナレッジを扱う用途にも適しています。Microsoft FoundryやCopilot Studioなどで構築するカスタムエンジンエージェントと組み合わせることもできます。


独自ポータル・モバイルアプリへのCopilot体験の埋め込み

社内ポータルサイトや現場業務用モバイルアプリに、Microsoft Copilotを利用した会話機能を組み込みたい場合は、Chat APIか、Microsoftが新規開発に推奨しているWork IQ REST APIを利用できます。

たとえば、営業担当者が訪問前に関連情報を確認したり、現場担当者が過去の資料を検索したりする用途では、Microsoft 365の業務データやWeb情報をグラウンディングに利用した回答を独自アプリケーション内で取得できます。なお、メール送信などのアクション実行が必要な場合は、別の実行基盤との組み合わせが必要です。


コンプライアンス・監査ソリューションの内製

金融・製薬・公共分野など、AI利用の記録や監査が求められる業界では、Interaction Export APIとAI Interactions Change Notifications APIを組み合わせて、Copilot interactionの記録・監視基盤を構築できます。

たとえば、Interaction Export APIで取得したinteractionデータを社内の監査・ログ管理システムへ連携し、AI Interactions Change Notifications APIの変更通知をきっかけにコンプライアンスチェックなどの後続処理を開始するといった構成が考えられます。

なお、Microsoft Copilotのプロンプトや応答に含まれるキーワードや機密情報の検出は、Microsoft Purview Communication Complianceでも行えます。独自の監査基盤は、Purviewの標準機能との役割分担を整理したうえで、自社システムとの連携が必要な範囲に絞って設計します。


会議データのCRM/プロジェクト管理システム連携

Meeting Insights APIを利用すると、Teams会議から生成された会議メモやアクションアイテム、メンションを、CRMやプロジェクト管理システム、独自ワークフローへ連携できます。

たとえば顧客ミーティングでは、AI Insightsの生成完了をAI Insights Change Notifications APIで検知します。そのうえで、Meeting Insights APIから取得したアクションアイテムをCRMのタスクへ、会議メモを顧客履歴へ連携するといった非同期ワークフローを構築できます。


Microsoft 365 Copilot APIsの注意点

Microsoft 365 Copilot APIsを本番システムへ組み込む前に、把握しておきたい制約と設計上のポイントを整理します。


一般提供機能とプレビュー機能の境界を意識する

Copilot APIsでは、一般提供の機能とプレビューの機能が混在しています。本番設計の観点では、次の3種類に分けて確認すると整理しやすくなります。

  • API本体がプレビュー:Search API、Chat API、AI Insights Change Notifications API、AI Interactions Change Notifications API
  • 課金モデルがプレビュー:Retrieval API Pay-as-you-go
  • 一部操作のみプレビュー:Package Management APIのUpdate/Block/Unblock/Reassign


プレビュー機能は、仕様変更や提供終了の可能性があり、SLAの対象外となる場合があります。また、Microsoft Graphの/beta APIは実稼働アプリケーションでの利用がサポートされていません。

本番システムでプレビューのAPIを使う場合は、仕様や提供ステータスの変更に追随できる運用体制を整えておきます。変更点は、MicrosoftのMicrosoft 365 Copilot機能拡張の新機能や各APIのリファレンスで確認できます。


アクション実行が必要かどうかを最初に切り分ける

メール送信やファイル作成など、AIによるアクション実行まで要件に含まれる場合、Chat APIやWork IQ REST APIだけでは対応できません。独自アプリケーションやエージェントから操作まで行う場合は、Work IQ MCPのツールや、ツール実行に対応したエージェントを組み合わせます。

一方、Copilot Coworkは、利用者がMicrosoft CopilotやOutlook、Teamsの画面からタスクを任せる機能です。本番設計では、「情報の取得・回答まででよいのか、アクション実行まで必要なのか」と、操作するのが自社のアプリケーションか利用者本人かを最初に切り分け、機能範囲と課金方式を踏まえて使い分けを決めます。


セマンティックインデックスとデータソース対応範囲の限界

Retrieval APIとSearch APIの検索結果は、Microsoft Copilotのインデックスと、前述のファイル形式や検索対象範囲の制約に左右されます。期待した文書が返らない場合もあるため、こうした制約は利用者向けの仕様説明にも明記します。

また、Retrieval APIは画像や図表そのものの内容からの情報取得に対応しておらず、Search APIでも非テキストコンテンツに対するセマンティック検索はサポートされていません。図面やグラフ画像そのものを解析対象にする場合は、OCR・ドキュメント解析サービスやマルチモーダル対応モデルを組み合わせる構成を検討します。


レート制限・ファイルサイズ制限・KQL構文の運用配慮

Retrieval APIとSearch APIには、1ユーザーあたり1時間最大200リクエストの制限があります。利用規模に応じて、キャッシュや呼び出し頻度の制御を検討します。その他のCopilot APIsにもMicrosoft Graphのスロットリングが適用されるため、個別APIの制限も確認します。429 Too Many Requestsが発生した場合は、Retry-Afterヘッダーに従って再試行するように設計します。


ファイルサイズについては、Retrieval APIでは.docx、.pptx、.pdfは512MBを超えるファイル、それ以外の拡張子は150MBを超えるファイルが対象外です。Search APIのセマンティック検索にも同じファイルサイズ上限があります。大容量の資料を多く扱う場合は、事前にファイルサイズを確認します。Retrieval APIのfilterExpressionでKQL(Keyword Query Language)を使用する場合、KQL構文が誤っていてもエラーにならず、スコープなしでクエリが実行される点に注意が必要です。意図せず検索範囲が広がることを防ぐため、filterExpressionの構文と、実際に返される検索範囲を開発・テスト時に確認します。


まとめ

本記事では、Microsoft 365 Copilot APIsについて、Microsoft Graph APIとの違い、提供される9つのAPIと主な機能、セキュリティ・認証モデル、料金、利用手順、活用シーン、注意点を解説しました。Microsoft 365 Copilot APIsは、Microsoft Copilotを支える機能やコンポーネントを、独自アプリケーションやカスタムエンジンエージェントから安全に利用するためのAPI群です。特にRetrieval APIを使えば、データを複製せずに、既存のアクセス制御を保ったまま社内データを回答生成の根拠に利用できます。


一方で、一般提供機能とプレビュー機能が混在している点、新規開発で推奨されているWork IQ APIとの使い分け、APIごとの対応データソースや検索対象範囲の制約、アクセス許可の種類に応じたアプリ登録・認証設計など、本番導入前に整理しておくべき論点もあります。料金面では、Copilotライセンスを持つユーザーは原則として追加料金なしで利用でき、ライセンスを持たないユーザーにはRetrieval APIのPay-as-you-go(プレビュー)が用意されています。


東京エレクトロンデバイスでは、Microsoft 365 Copilot APIsを活用した生成AIソリューションの設計・実装を総合的にサポートしています。Retrieval APIを軸とした社内ナレッジRAGアプリの内製化、Chat APIやWork IQ APIによる独自ポータルへのCopilot体験埋め込み、Interaction Export APIを用いたコンプライアンス基盤構築、Meeting Insights APIによる会議データのCRM連携、Copilotライセンスと従量課金の最適設計、Microsoft Entra IDのアプリ登録と権限設計など、Microsoft Copilotエコシステム全体の導入設計に関するご相談をお受けしています。ご興味のある方はこちらからお問い合わせください。

CONTACT
お問い合わせ

Microsoft AzureおよびAI・IoTに関する
お問い合わせはこちらから

東京エレクトロンデバイス株式会社

Copyright © Tokyo Electron Device LTD. All Rights Reserved.
当ウェブサイトでは、サイトの利便性向上のためにクッキーを利用しています。サイトの閲覧を続行されるには、クッキーの使用にご同意いただきますようお願いします。詳細はこちら