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