Microsoft 365 Copilot API を使用すると、Microsoft 365 のコンプライアンス標準に合わせて、独自のアプリケーションやカスタム エンジン エージェントで Microsoft 365 Copilot 機能に安全にアクセスできます。 Microsoft 365 Copilot 用のカスタム エンジン エージェントを独自のモデルやオーケストレーターを使用して構築している場合でも、独自のアプリケーションで会話エクスペリエンスを構築している場合でも、Copilot API を使用すると、Microsoft 365 Copilot エクスペリエンスを強化するコンポーネントへのアクセスが提供されます。
エンタープライズ開発者は今日、コンプライアンスやガバナンスを損なうことなく、組織の知識への安全なアクセスを維持しながら AI の力を活用する方法という重要な課題に直面しています。 従来のアプローチでは、複雑な AI システムをゼロから構築し、機密データを外部ソースに抽出する必要があります。 Microsoft 365 Copilot API は、Microsoft 365 データに直接連携する実稼働可能な AI 機能へのアクセスを提供します。
Microsoft 365 Copilot API にアクセスするか使用すると、Microsoft 365 Copilot API の使用条件 (プレビュー) に同意したものと見なされます。
ヒント
コードを記述する前に API を調べますか? 対話型デモを試して、Microsoft 365 データを使用したライブ API 要求と応答を確認します。
Copilot API の機能
Copilot API には、エンタープライズ データに基づいた AI 搭載アプリケーションの構築を可能にする包括的な機能セットが用意されています。
次の表に、API を示し、その機能とシナリオについて説明します。
| API | それを使用して | シナリオ例 |
|---|---|---|
| 検索 API | 安全かつ準拠した方法で、Microsoft 365 コンテンツから関連情報を取得します。 | データ抽出なしで、独自の AI モデルを Microsoft 365 コンテンツに接続します。 organizationの最新のドキュメント、ポリシー、ナレッジベースに基づいて対応する専門のアシスタントを構築します。 これらのアプリケーションは、ドキュメントのアクセス制御と秘密度ラベルを尊重しながら、部門全体のユーザーにコンテキストに関連する情報を提供できます。 |
| 検索 API (プレビュー) | コンテキスト理解とインテリジェントな結果を備えた自然言語クエリを使用して、職場または学校の OneDrive コンテンツ全体でハイブリッド検索 (セマンティックおよび語彙) を実行します。 | ユーザーがセキュリティとコンプライアンスを維持しながら、完全一致ではなく自然言語クエリを使用して関連するドキュメントやファイルキーワード (keyword)検出できるようにする AI 搭載の検索アプリケーションを構築します。 |
| Interaction Export API | コンプライアンス ソリューションを有効にして、Microsoft 365 アプリケーション全体で Copilot とのユーザー操作をキャプチャしてアーカイブできるようにします。 | AI 相互作用の包括的な記録を維持し、AI の使用状況の監視を可能にし、組織のポリシーと規制要件への準拠を確保するシステムを開発します。 これらのソリューションは、AI 支援コンテンツ生成の文書化とレビューが必要な規制対象の業界にとって価値があります。 |
| AI Interactions Change Notifications API (プレビュー) | Microsoft 365 全体の Copilot 操作の変更通知を購読します。 | AI の相互作用をリアルタイムで監視およびログ記録するアプリケーションを構築し、プロアクティブなコンプライアンス チェック、異常検出、監査を可能にします。 |
| Meeting Insights API | Teams 会議用に AI によって生成された会議メモ、アクション アイテム、ディスカッション トピックを抽出します。 | Teams 会議からアクション アイテム、決定事項、概要を自動的に抽出して整理するアプリケーションを作成します。 これらをプロジェクト管理ツール、CRM システム、またはカスタム ワークフローとリンクします。 これらのシステムは、会議の成果を自動的にキャプチャ、整理、アクティブ化することによって、会議を費やした時間から創造される価値に変えることができます。 |
| AI 分析情報変更通知 API (プレビュー) | Teams 会議の Copilot AI 分析情報の変更通知を購読します。 | Teams 会議 AI 分析情報を使用するアプリケーションを構築し、重要な詳細を一貫してキャプチャし、アラインメントを促進します。 |
| Chat API (プレビュー) | カスタム アプリケーションで Microsoft 365 Copilot を利用した会話エクスペリエンスを有効にします。 | Microsoft 365 Copilot をエンタープライズ アプリケーションに統合すると、質問に回答し、タスクを実行し、Microsoft 365 データとユーザー コンテキストに基づいてガイダンスを提供できます。 これらのインターフェイスは、カスタム ポータルからモバイル アプリまで、毎日使用するツールに AI 機能を直接導入することで、ユーザーの生産性を向上させることができます。 |
| Copilot 使用状況レポート API | organization 内の Microsoft 365 Copilot のユーザー数と使用状況データを照会します。 | ユーザーによる Microsoft 365 Copilot の導入を追跡するためのレポートを作成します。 |
| パッケージ管理 API | organization全体のエージェントを表示および管理します。 | Create a inventory of all agents within your organization. |
注:
Chat API はテキストによる応答を返します。質問に回答し、ガイダンスを提供しますが、ファイルの作成、メールの送信、会議のスケジュール設定などのアクションは実行しません。 詳細については、Chat API の既知の制限事項を参照してください。
主な利点
Copilot API は、アプリケーションに次の利点をもたらします:
- 安全なグラウンディング、ガバナンス、コンプライアンス - Microsoft 365 のナレッジ インデックスに直接アクセスします。 既存のすべてのアクセス許可、秘密度ラベル、コンプライアンス制御、監査、ログ記録、監視、ポリシーの適用が自動的に尊重されます。 セキュリティと認証モデルの詳細については、「Microsoft 365 Copilot API のセキュリティと認証」を参照してください。
- 実稼働対応 AI - Microsoft 365 Copilot を強化するのと同じ運用グレードの AI 機能を使用して、カスタム検索拡張生成 (RAG) パイプラインと会議の文字起こし処理の開発を加速します。 Azure AI Foundry、Microsoft Copilot Studio、または Microsoft Agents SDK のいずれを使用してソリューションを開発する場合でも、Copilot API はプラットフォームにシームレスに統合されます。
- 責任ある AI - これらの Copilot とインテリジェントなエクスペリエンスを使用すると、RAI 検証チェックによって有害なコンテンツから保護されます。
要件
Copilot API の可能性をアプリケーションとカスタム エンジン エージェントに統合して最大限に引き出すには、次にアクセスする必要があります。
Microsoft 365 Copilot ライセンス - これらの API 経由で Microsoft 365 Copilot 機能にアクセスする各ユーザーに必要です。 このライセンスは、API を強化する AI 機能へのアクセスを提供します。
Microsoft 365 サブスクリプション: E3 または E5 サブスクリプション (または同等のもの) は、Microsoft 365 Copilot の基盤です。 このサブスクリプションでは、Copilot が基にしている Microsoft 365 サービスとデータにアクセスできます。
アプリの登録から API クライアントへ
Microsoft 365 のエージェントまたはアプリケーションの構築は、アプリ モデルを Copilot API に接続するチェーンに従います。
- アプリ パッケージ (Microsoft 365 アプリ モデルによって定義されたマニフェスト、アイコン、およびメタデータのバンドル) を作成します。
- そのパッケージの一部として、Microsoft Entra ID でアプリの登録を実行し、アプリケーション (クライアント) ID を生成します。
- 実行時に、そのアプリケーション (クライアント) ID を 認証プロバイダー (MSAL など) に指定して、サインイン ユーザーに代わってアクセス トークンを取得します。
- Copilot API (検索 API など) を呼び出すときに、結果のトークンを渡します。
アプリの登録は、パッケージ化モデルと API 消費モデルの間の架け橋です。ここで、アプリ パッケージ ID が Copilot API 呼び出しを承認する資格情報になります。
アプリ マニフェストの id フィールドと Entra アプリケーション (クライアント) ID は、異なる目的を果たす異なる識別子です。 マニフェスト id は、Microsoft 365 のパッケージ化および配布システム内でアプリを識別し、アプリのライフサイクル管理 (発行、更新、サイドローディング) に使用されます。 Entra アプリケーション (クライアント) ID は、アプリが Copilot API を呼び出すときの OAuth 認証に使用されます。
アプリ パッケージ、マニフェスト フィールド、および配布の詳細については、「 エージェントは Microsoft 365 のアプリです」を参照してください。 認証と組織のポリシーが Copilot API 呼び出しに適用される方法の詳細については、「Microsoft 365 Copilot API のセキュリティと認証」を参照してください。
注:
Work IQ 開発ツール (プレビュー) — 宣言型エージェントを構築する場合は、 wiqd このセットアップ手順を減らすことができます。名前付き環境では、 wiqd agent provision はエージェントの Microsoft 365 アプリの登録を実行し、結果の ID を環境ファイルに書き戻すため、アプリの登録は手動で行う最初の手順ではありません。 このプロセスは、Copilot API クライアント全般ではなく、宣言型エージェントのプロビジョニングに適用されます。 詳細については、 Work IQ 開発ツールのドキュメントを参照してください。
REST API 統合
Copilot API は、Microsoft Graph 名前空間 (graph.microsoft.com/v1.0/copilot および graph.microsoft.com/beta/copilot) で標準 REST API として使用できます。 この統合により、HTTP 要求をサポートする任意のプログラミング言語またはプラットフォームから API にアクセスできるようになります。 この API では、他の Microsoft Graph API と同じ 認証および承認 プロセスが使用されます。 すべての Copilot API は、既定で ID アクセス、条件付きアクセス、秘密度ラベル、アクセス許可のトリミングなど、organization の既存のポリシーを尊重します。
Copilot API と Microsoft Graph API の比較
Microsoft Graph API は通常、Microsoft 365 データに対して CRUD 操作を提供します。 Copilot API は、Microsoft 365 データに基づいて構築された AI 搭載の機能を提供します。 データを操作してアクセスする必要がある場合は、Microsoft Graph API を使用します。AI がそのデータに基づいて推論する必要がある場合は、Copilot API を使用します。 この基本的な違いはライセンス モデルにも反映されています。Microsoft Graph API は標準の Microsoft 365 ライセンス条項の下で利用できます。Copilot API には Microsoft 365 Copilot ライセンスが必要です。 このライセンス モデルは、標準のデータ アクセスを超える、より価値の高い AI 機能を提供します。