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

適用対象: 開発者

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

注:

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

前提条件

開始する前に、次の情報があることを確認してください。

  • 少なくとも 1 つのコンテナーを含む SharePoint Embedded アプリ。
  • SharePoint Embedded アプリのコンテナーの種類 ID。
  • Microsoft Foundry Agent Service プロジェクト。
  • プレビュー中にテナント内の少なくとも 1 つのMicrosoft 365 Copilot ライセンス。
  • エージェントがコンテンツにアクセスする必要がある各使用テナントのコンテナーの種類の登録を更新するアクセス許可。

プレビュー中は、Copilot ライセンスが必要です。 プレビュー後、この機能は従量制課金に移行する予定です。

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

remoteSharePointParameters.containerTypeIdを SharePoint Embedded コンテナーの種類 ID に設定して、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 に置き換えます。

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

取得の検証

  1. サポートされているファイルを SharePoint Embedded コンテナーにアップロードします。
  2. インデックス作成が完了するまで待ちます。
  3. コンテナー コンテンツにアクセスできるユーザーとしてサインインします。
  4. アップロードされたファイルが応答できることをエージェントに質問します。
  5. 答えが予想される SharePoint Embedded コンテンツに固定されていることを確認します。

答えが予想されるファイルを省略した場合は、次のチェック。

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

次の手順

  • Last updated on