Microsoft 365 Copilot API は、Copilot エクスペリエンスを強化するコンポーネントへのアクセスを提供し、Microsoft 365 Copilot 機能を使用してカスタム エンジン エージェントと生成 AI ソリューションを強化する機能を解放します。 Microsoft 365 Copilot Retrieval API を使用すると、Microsoft 365 Copilot を強化するハイブリッド インデックスから関連するテキスト チャンクを返すことで、Microsoft 365 と Microsoft 以外の知識を活用して生成 AI ソリューションを基盤にすることができます。
Retrieval API は、データをレプリケート、インデックス作成、チャンク化、別のインデックスでセキュリティで保護する必要なく、検索拡張生成 (RAG) 用の合理化されたソリューションを提供します。 API はユーザーのコンテキストと意図を理解し、クエリ変換を実行して最も関連性の高い結果を導き出します。これは、語彙検索や代替ソースからの基本的な RAG でさえ達成するのが困難です。
RAG は、生成 AI ソリューションを構築し、Microsoft 365 の知識を使用する場合に不可欠です。 RAG を実装すると、ソリューションは、組織データの膨大なリポジトリに基づいた、より正確でコンテキストに即した応答を提供できます。 Retrieval API は、SharePoint、OneDrive、Copilot コネクタから最新の関連するテキスト スニペットを抽出することで RAG を実現します。 Retrieval API は、データを所定の位置に保持し、アクセスとガバナンスの制御を維持します。 Retrieval API により、合成された応答に最新かつ最も関連性の高いデータが確実に反映されます。 このプロセスにより、生成 AI ソリューションの信頼性と有用性が向上します。
API を調べるには、 対話型デモでクエリを試してください。
ヒント
コードを記述する前に検索 API を調べますか? 対話型デモを試して、Microsoft 365 データを含むライブ要求と応答を確認します。
検索 API を使用する理由
Retrieval API は、コンテキストの再現を最適化しながら、SharePoint、OneDrive、Copilot コネクタから関連するテキスト チャンクを取得するための安全で準拠した方法を提供します。 したがって、データをエグレスしたり、権限を侵害したり、セキュリティとコンプライアンスを侵害したりする必要はありません。
カスタムナレッジ アプリケーションでは、Retrieval API を使用して、SharePoint、OneDrive、Copilot コネクタに保存されているorganization固有の情報に基づいて応答できます。 これらのアプリケーションは、個別のベクター インデックスを構築して維持するのではなく、代わりに Microsoft 365 データ ソースから関連するコンテキストを取得して、Microsoft 365 Copilot と同じ方法で大規模言語モデル (LLM) の応答を作成できます。
高精度な情報取得を必要とする金融および法務アプリケーションでは、API のフィルタリング機能を使用して、検索範囲を特定のドキュメント ライブラリまたはコンテンツ タイプに限定し、情報バリアとアクセス制御を考慮しながら、承認されたソースのみを応答に確実に含めることができます。
マルチソース アプリケーションは、SharePoint と OneDrive のコンテンツを Microsoft 365 Copilot コネクタからの情報と組み合わせて、一貫したセキュリティとコンプライアンスの制御を維持しながら、Microsoft 365 とサード パーティの両方のリポジトリにまたがる統合サポート情報を作成できます。
クライアントに合わせたソリューションを提供することを専門とするコンサルティング会社が、作業の大部分が SharePoint に保存されているデータに焦点を当てていると想像してください。 同社は、コンサルタントが重要なクライアントとの会議の準備を支援するカスタムエンジンエージェントを開発しています。 このエージェントは、SharePoint の正確かつ最新の情報にアクセスして取得する必要があります。 同社は、市場の直接の競合相手である 2 つの主要なクライアントと協力しています。 したがって、同社は、一方のクライアントの文書やデータが他方のクライアントから決してアクセスできないように、厳格なセキュリティおよびコンプライアンス基準を維持することが重要な必要性を抱えています。 Retrieval API は、企業がコンプライアンスと安全のリスクを管理し、データの関連性と鮮度を確保するのに役立ち、開発作業全体を簡素化します。
コンプライアンスと安全のリスクを管理する
検索 API は、Microsoft 365 の組み込みのセキュリティとコンプライアンス機能を使用して、データ ソースのアクセス許可とコンプライアンス設定が確実に保持されるようにします。 データをその場で取得することで、データ漏洩を防ぎ、あるクライアントの機密情報が別のクライアントに決してアクセスできないようにするため、厳格なセキュリティとコンプライアンス標準を維持するために不可欠です。 organization 内では、Microsoft 365 のアクセス許可モデルを使用すると、個人はアクセスが許可されているコンテンツからのみ結果を取得できます。
関連性と鮮度を解決する
Retrieval API は、データの重複を起こさずに関連するコンテキストを取得するため、その結果が最新の状態に保たれ、コストのかかる個別のデータ パイプラインを維持する必要がなくなります。
所有コストと開発作業の削減
Retrieval API を使用すると、組織に多大なコストがかかる可能性のある安全なデータ エクスポートおよびインデックス作成パイプラインを構築する必要がなくなります。 API は、次の必要な機能をサポートします。
- 検索プロバイダーの管理
- クローラー
- データ コネクタ
- データ ストレージ
- コンテンツ パーサー
- インデックス作成
- セキュリティ
組織はこれらの組み込み機能を使用して、経費や複雑さを回避し、Microsoft 365 内で厳格なアクセス制御とコンプライアンスを維持できます。
取得 API の機能
Retrieval API を使用すると、次のデータ ソースからデータを取得できます。
- SharePoint
- OneDrive
- Copilot コネクタ
API は自然言語のクエリをサポートし、Microsoft 365 Copilot スタックを使用して、Microsoft 365 信頼境界内に関連するグラウンディング コンテキストを取得します。 この API を使用すると、キーワード照会言語 (KQL) を使用して検索の範囲を設定し、ユース ケースにとって最も重要なコンテンツから取得することができます。 KQL を使用すると、URL、日付範囲、ファイルの種類などでフィルター処理できます。
ライセンス
検索 API は、Microsoft 365 Copilot アドオン ライセンスを持つユーザーが追加料金なしで利用できます。 Microsoft 365 Copilot Retrieval API にアクセスするか使用すると、Microsoft 365 Copilot API の使用条件 (プレビュー) に同意したものとみなされます。
Microsoft 365 Copilot アドオン ライセンスをお持ちでないユーザーは、SharePoint コネクタや Copilot コネクタなどのテナント レベルのデータ ソースの従量課金制消費 (プレビュー) を介して検索 API を利用できます。 OneDrive などのユーザー レベルのデータ ソースは使用できません。
注:
Retrieval API 従量課金制の使用は、現在プレビュー機能です。 Microsoft 365 Copilot Retrieval API 従量課金制の使用にアクセスまたは使用するときは、Microsoft 365 Copilot Retrieval API 従量課金制の利用規約 (プレビュー) に同意したことになります。
取得 API の従量課金制が有効になっている非 Copilot ライセンス ユーザーは、従量課金制で Microsoft Foundry の SharePoint ツールを使用できます。
Retrieval API の従量課金制の使用を有効または無効にする方法、および価格の詳細については、「 Retrieval API 従量課金制の概要」を参照してください。
ベスト プラクティス
次のベスト プラクティスは、フィルター処理されていないクエリ ( filterExpression を使用しないクエリ) とフィルター処理されたクエリ ( filterExpression を含むクエリ) の両方に適用できます。
- Retrieval API によって返される結果と抽出は順序付けされていません。 このため、LLM が使用できるトークンの数について厳密な要件がない限り、 maximumNumberOfResults を制限しないことをお勧めします。
- 回答を生成するために、検索 API によって返されるすべての抽出を LLM/オーケストレーターに送信します。
- 多種多様なコンテンツに当てはまる可能性がある汎用クエリは避けてください。
- クエリでできるだけ多くのコンテキストを指定します。
- queryString は 1 つの文である必要があります。
- queryString を作成するときに、コンテキスト リッチ キーワードのスペル ミスを避けます。
フィルター処理されたクエリ ( filterExpression を含むクエリ) には、次のベスト プラクティスを適用します。
- SharePoint または OneDrive の パス パラメーターを使用してフィルター処理する場合は、共有リンクを使用したり、アドレス バーから URL をコピーしたりしないでください。 代わりに、SharePoint または OneDrive オンラインでフォルダーまたはファイルの場所に移動し、3 つのドットを選択して [その他のアクション] を開きます。 ペインを下にスクロールして、[ 詳細] を選択します。 そこから、左側のナビゲーション ウィンドウを下にスクロールして、パスを見つけてコピーできます。
既知の制限
取得 API に対する現在の調整およびその他の制限事項を次に示します。
- You need the Files.取得 API を使用して SharePoint コンテンツを取得するための Read.All および Sites.Read.All アクセス許可。
- You need the Files.取得 API を使用して OneDrive コンテンツを取得するための Read.All および Sites.Read.All のアクセス許可。
- 取得 API を使用して Copilot コネクタのコンテンツを取得するには、 ExternalItem.Read.All アクセス許可が必要です。
- Retrieval API は、コンテキストの再現用に最適化されています。
- queryString 要求パラメーターには、1,500 文字の制限があります。
- dataSource 要求パラメーターを使用して、一度に 1 つのデータ ソースから取得する必要があります。 インターリーブされた結果はサポートされていません。
- filterExpression 要求パラメーターの KQL 構文が正しくない場合、クエリは範囲を設定せずに正常に実行されます。
- filterExpression では、すべての SharePoint プロパティと OneDrive プロパティがサポートされているわけではありません。 サポートされているプロパティの一覧については、 API リファレンスを参照してください。
- maximumNumberOfResults 要求パラメーターの最大値は 25 です。
- 応答ペイロードの relevanceScore は、 queryString と抽出の間のコサイン類似性を測定し、0 から 1 の範囲に正規化されます。
- Copilot コネクタから取得するときに、 relevanceScore なしで抽出が返される可能性があります。
- ユーザー 1 人あたり 1 時間あたり最大 200 の要求がサポートされます。
- テーブル内のテキストからの取得は、OneDrive と SharePoint の .doc、.docx、.pptx ファイルに限定されます。
- 画像やグラフなど、テキスト以外のコンテンツからの取得はサポートされていません。
- .docx、.pptx、.pdf 拡張子が 512 MB を超えるファイルの結果はサポートされません。 150 MB を超える拡張子を持つ他のファイルの結果はサポートされません。
- SharePoint または OneDrive から取得する場合、セマンティック取得とハイブリッド取得は、 .doc、.docx、.pptx、.pdf、.aspx、および .one ファイル拡張子でのみサポートされます。 他のすべてのファイル拡張子は、語彙検索のみをサポートします。
- Retrieval API は、Microsoft 365 Copilot セマンティック インデックスのすべての制限の対象となります。
- 応答ペイロードの retrievalHits が空の場合、関連する結果は見つかりませんでした。