SharePoint Embedded を Foundry ナレッジソースとして設定する

適用対象: Developer

アプリに SharePoint Embedded コンテナーに保存されているファイルに対して固定されたエージェントエクスペリエンスが必要な場合は、SharePoint ナレッジソースで Microsoft Foundry エージェントサービスを使用します。

SharePoint Embedded コンテナーの種類の場合、ナレッジソースは一般的に利用可能な Microsoft 365 Copilot Retrieval API を介して回答の根拠となります。 Foundry は取得呼び出しをエージェントの一部として実行するため、同じ前提条件、インデックス作成動作、および課金が適用されます。 Foundry が使用する sharePointEmbedded データソースはプレビュー段階です。代わりに独自のグラウンディング手順を実行するには、「取得 API の使用」で説明されているように取得 API を直接呼び出します。

注:

SharePoint Embedded の SharePoint ナレッジソースはプレビュー段階です。

前提条件

開始する前に、次のことを確認してください:

コンテナーが 1 つ以上ある SharePoint Embedded アプリ。
SharePoint Embedded アプリのコンテナーの種類 ID。
Microsoft Foundry エージェントサービスプロジェクト。
コンテナーの種類に対して構成された従量課金制。
テナント内に少なくとも 1 人のユーザーが Microsoft 365 Copilot ライセンスを持っているため、セマンティックインデックスが初期化されます。詳細については、「Microsoft 365 Copilot のセマンティックインデックス」を参照してください。
エージェントがコンテンツにアクセスする必要がある消費テナントごとに、コンテナーの種類の登録を更新するアクセス許可。

エージェントにクエリを実行するユーザーには、それぞれ Microsoft 365 Copilot ライセンスは必要ありません。使用量は、Copilot Studio のメッセージメーターで請求され、料金は、コンテナーの種類に対して構成された課金モデルに従います。詳細については、「課金メーター」を参照してください。

SharePoint ナレッジソースを構成する

SharePoint Embedded コンテナーの種類 ID に設定した remoteSharePointParameters.containerTypeId を使用して Foundry SharePoint ナレッジソースを構成します。

ソース固有の構成の詳細については、「 SharePoint ナレッジソースのプロパティ」を参照してください。

コンテナーの種類への Foundry アクセス権を付与する

Microsoft Foundry に、消費する各テナント内のコンテナーの種類への読み取りアクセス権を付与します。 Foundry アプリケーション ID は 880da380-985e-4198-81b9-e05b1cc53158 です。

コンテナーの種類の所有アプリケーションは、消費テナントの登録 API を呼び出す必要があります。

PUT /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeId}/applicationPermissionGrants/880da380-985e-4198-81b9-e05b1cc53158
Content-Type: application/json

{
  "delegatedPermissions": ["readContent"],
  "applicationPermissions": ["none"]
}

{fileStorageContainerTypeId}コンテナーの種類 ID に置き換えます。

このアクセス許可は、コンテナータイプの登録エンドポイントの作成を使用して、最初のコンテナータイプの登録中に付与することもできます。

取得の検証

サポートされているファイルを SharePoint Embedded コンテナーにアップロードします。
インデックスの作成が完了するまで待ちます。
コンテナーコンテンツにアクセスできるユーザーとしてサインインします。
アップロードされたファイルで回答できる質問をエージェントに尋ねます。
回答が期待される SharePoint 埋め込みコンテンツに基づいていることを確認します。

回答で想定されるファイルが省略されている場合は、次をチェックします。

消費テナントでのコンテナーの種類の登録。
Foundry アプリケーションのアクセス許可の付与。
テナントでのセマンティックインデックスの初期化。
コンテナーとファイルへのユーザーアクセス。
サポートされているファイル形式。
コンテンツの検出可能性の設定。
インデックス作成の遅延。

次の手順

Last updated on 2026-08-13