Microsoft 365 Copilot API は、Copilot エクスペリエンスを強化するコンポーネントへのアクセスを提供します。 これらの API を使用すると、Copilot 機能を使用して、カスタム エンジン エージェントとジェネレーティブ AI ソリューションを強化できます。 Copilot Search API を使用すると、開発者は、関連するドキュメントとファイルを返すコンテキストと意図を理解する自然言語クエリを使用して、OneDrive 全体で職場または学校のコンテンツに対してハイブリッド検索 (セマンティックおよび字句) を実行できます。 SharePoint、Copilot Connectors などの他のデータ ソースは、現在 Search API ではサポートされていませんが、今後のリリースで追加される予定です。 セマンティック インデックス作成の詳細については、「セマンティック インデックスMicrosoft 365 Copilot」を参照してください。
重要
/beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。
Search API は、セマンティック ドキュメント検出のための合理化されたソリューションを提供します。別の検索インフラストラクチャでデータをレプリケート、インデックス作成、管理する必要はありません。 API は、クエリの意図を理解するために自然言語処理を適用し、インテリジェントな結果のランク付けを実行して、最も関連性の高いドキュメントを生成します。 従来のキーワード (keyword)ベースの検索アプローチでは、この関連性を実現することはより困難です。
セマンティック検索は、インテリジェントなナレッジ検出ソリューションを構築し、Microsoft 365 コンテンツを表示する場合に不可欠です。 セマンティック検索を実装すると、ソリューションは、組織データの膨大なリポジトリに基づく、より正確でコンテキストに関連するドキュメント検出を提供できます。 Search API は、職場または学校のコンテンツに関連するファイル、ファイル プレビュー、および OneDrive のファイル メタデータを提供することでこれを実現します。 Search API は、データを所定の位置に保持し、アクセスとガバナンスの制御を維持します。 Search API では、最新かつ最も関連性の高いコンテンツによって検索結果が確実に通知されます。 このプロセスにより、カスタム AI を利用した検索アプリケーションの信頼性と有用性が向上します。
Graph エクスプローラーで最初の Search API クエリを試してください。
Search API を使用する理由
Search API は、コンテキスト上の関連性とユーザー意図の理解を最適化しながら、職場または学校のコンテンツに対して OneDrive 全体でハイブリッド検索 (セマンティックと字句) を実行する、安全で準拠した方法を提供します。 したがって、セキュリティとコンプライアンスに関するデータの送信、アクセス許可の中断、または侵害を行う必要はありません。
カスタム AI 搭載の検索アプリケーションでは、Search API を使用して、OneDrive に格納されているドキュメントを検出できます。 これらのアプリケーションは、個別の検索インデックスを構築して管理するのではなく、ハイブリッド検索機能を OneDrive コンテンツに適用して、検索と同じ方法で関連コンテンツMicrosoft 365 Copilot表示できます。
インテリジェントなドキュメント検出を必要とするエンタープライズ ナレッジ アプリケーションでは、API のフィルター機能を使用して、特定の OneDrive パスまたはフォルダーに検索をスコープできます。 この方法では、情報バリアとアクセス制御を尊重しながら、承認されたソースのみが結果に含まれるようにします。
ドキュメント中心のアプリケーションでは、セマンティック理解とパスベースのフィルター処理を組み合わせて、ユーザーが正確なキーワード (keyword)一致ではなく、自然言語の説明に基づいて適切なドキュメントをすばやく見つけるのに役立つ直感的な検索エクスペリエンスを作成できます。
コンプライアンスと安全性のリスクを管理する
Search API では、Microsoft 365 の組み込みのセキュリティとコンプライアンス機能を使用して、データ ソースのアクセス許可とコンプライアンス設定が確実に保持されます。 データを所定の場所で検索することで、データ リークを防ぎ、機密情報にアクセスできるのは承認されたユーザーに限定されます。 この機能は、厳格なセキュリティとコンプライアンスの標準を維持するために不可欠です。 organization内では、Microsoft 365 のアクセス許可モデルにより、個人はアクセスが許可されているコンテンツからのみ結果を取得できます。
関連性と鮮度を解決する
Search API は、データの重複なしに OneDrive コンテンツに対して直接ハイブリッド検索を実行するため、その結果は最新で関連性の高い状態に保たれます。 コストのかかる個別の検索インフラストラクチャを維持する必要がなくなります。
所有コストと開発作業のコストを削減する
Search API を使用すると、セキュリティで保護されたデータエクスポートと検索インデックス作成パイプラインを構築する必要がなくなり、組織に多大なコストが発生する可能性があります。 API では、次のような必要な機能がサポートされています。
- ハイブリッド (セマンティックおよび字句) 検索
- 自然言語処理
- コンテンツのインデックス作成
- データ ストレージ
- キーワード照会言語を使用したパスベースのフィルター処理 (KQL)
- セキュリティとコンプライアンス
これらの組み込み機能を使用して、経費や複雑さを回避し、Microsoft 365 内で厳しいアクセス制御とコンプライアンスを維持します。
ライセンス
Search API は、Microsoft 365 Copilot ライセンス アドオンを持つユーザーに追加料金なしで利用できます。 Microsoft 365 Copilotアドオン ライセンスを持たないユーザーのサポートは現在利用できません。
Microsoft 365 Copilot Search API にアクセスまたは使用することで、Microsoft 365 Copilot API の使用条件 (プレビュー) に同意したことになります。
ベスト プラクティス
次のベスト プラクティスは、フィルター処理されていないクエリ ( filterExpressionのないクエリ) とフィルター処理されたクエリ ( filterExpressionを持つクエリ) の両方に適用されます。
- Search API は、関連性で並べ替えられた結果を返します。
- Search API によって返されるすべての検索結果を使用して、包括的なドキュメント検出を行います。
- さまざまなコンテンツに適用される可能性のある過度に一般的なクエリは避けてください。
- セマンティック理解を深める目的で、クエリにできるだけ多くのコンテキストを指定します。
-
queryを記述的で自然な言語ベースにします。 -
queryを作成するときに、重要なキーワードのスペル ミスを回避します。
フィルター処理されたクエリ ( filterExpressionを含むクエリ) に次のベスト プラクティスを適用します。
-
pathパラメーターには、ファイルまたはフォルダーの詳細ウィンドウ (共有リンクやブラウザー アドレスではなく) に表示される完全な OneDrive パスを使用します。 例:https://contoso-my.sharepoint.com/personal/username_domain_com/Documents/Project/Report.docx。
現在のスコープと制限
現在、Search API には次の制限が適用されます。
-
query要求パラメーターの文字数は 1,500 文字です。 - データ ソースとしてサポートされているのは、職場または学校用の OneDrive のみです。
-
filterExpressionでは、path式のみがサポートされています。 今後のリリースでは、より多くのキーワード照会言語 (KQL) プロパティがサポートされる可能性があります。 -
pageSize要求パラメーターの最大値は 100 です。 - ユーザー 1 時間あたり最大 200 件の要求がサポートされます。
- テーブル、画像、グラフなど、テキスト以外のコンテンツに対するセマンティック検索はサポートされていません。
- .docx、.pptx、.pdf 拡張子が 512 MB を超えるファイルに対するセマンティック検索はサポートされていません。 150 MB を超えるその他の拡張子を持つファイルのセマンティック検索はサポートされていません
- セマンティック検索は、OneDrive コンテンツのデータの個人用設定されたワーキング セットで使用できます。ユーザーの OneDrive にすべてのコンテンツが含まれているわけではありません。
- セマンティック検索は、次のファイル拡張子でのみ使用できます:.aspx、.docx、.pptx、.pdf、.onepart、.doc、.html、.eml、.mp4、.loop、.one、.fluid、.png、.jpg、.json、.csv、.xml、.ppt。
- Search API には、Microsoft 365 Copilotセマンティック インデックスのすべての制限が適用されます。
- 応答ペイロードの
searchHitsが空の場合、関連する結果は見つかりませんでした。