View a markdown version of this page

Box データソースを接続する - Amazon Bedrock

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Box データソースを接続する

認証を設定し、認証情報を AWS Secrets Manager シークレットに保存したら、ナレッジベースに Box データソースを作成します。このページでは、 AWS マネジメントコンソール または API を使用してデータソースを作成し、次に設定できるコネクタパラメータのリファレンスを作成する方法について説明します。

注記

最初に認証のセットアップを完了します。Box のクライアント認証情報付与認証を設定する 「(推奨)」または「」を参照してくださいBox の OAuth 2.0 認証を設定する。シークレット ARN が必要です。

データソースを作成する

Console
Box をマネージドナレッジベースに接続するには
  1. データソースで、データソースの名前を指定します。

  2. データソースドロップダウンから Box を選択します。

  3. 認証 で、認証方法を選択し、シークレットを選択します。クライアント認証情報付与 (CCG) は Box エンタープライズ全体のコンテンツをクロールするためのものです。OAuth 2.0 は特定のユーザーのコンテンツをクロールするためのものです。

  4. (オプション) ドキュメントレベルのアクセスコントロールを有効にするには、ACLsを使用してドキュメントアクセスを制御するを選択します。このオプションは、クライアント認証情報付与認証でのみ使用でき、作成後に変更することはできません。詳細については、「ドキュメントレベルのアクセスコントロール」を参照してください。

  5. (オプション) OAuth 2.0 クロールの場合は、クロールする特定のファイルとフォルダURLs を入力します。

API

Box データソースを作成するには、Amazon Bedrock エージェントのビルドタイムエンドポイントを使用して CreateDataSource リクエストを送信します。次の AWS Command Line Interface 例では、クライアント認証情報付与認証を使用するデータソースを作成します。代わりに OAuth 2.0 を使用するには、 authTypeを に変更しますOAUTH2。ドキュメントレベルのアクセスコントロールを有効にするには、 aclEnabledを に設定しますtrue。各フィールドの説明については、以下のコネクタパラメータリファレンスを参照してください。

aws bedrock-agent create-data-source \ --name "Box-connector" \ --knowledge-base-id "your-knowledge-base-id" \ --data-source-configuration file://box-managed-connector.json

box-managed-connector.json ファイルには以下が含まれています。

{ "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR", "managedKnowledgeBaseConnectorConfiguration": { "connectorParameters": { "type": "BOX", "version": "1", "aclEnabled": false, "connectionConfiguration": { "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-box-ccg-creds", "authType": "CCG" }, "filterConfiguration": { "maxFileSizeInMegaBytes": "500" } } } }

OAuth 2.0 データソースの場合は、 authTypeを に設定しますOAUTH2。必要に応じて、 inclusionFolderIdsdataEntityConfigurationで を追加してinclusionFileIds、特定のフォルダとファイルをクロールできます。

{ "type": "BOX", "version": "1", "connectionConfiguration": { "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-box-oauth2-creds", "authType": "OAUTH2" }, "dataEntityConfiguration": { "inclusionFolderIds": ["123456789"], "inclusionFileIds": ["987654321"] } }

マネージドナレッジベースの場合、 CreateDataSourceは非同期です。オペレーションが完了すると、データソースのステータスは から CREATING に移行AVAILABLEします。

コネクタパラメータ

データソース設定では、次のコネクタパラメータを使用します。Box に接続するには、 のコネクタタイプBOXとして を指定しますconnectorParameters。ラップするフィールド connectorParameters ( deletionProtectionConfigurationや などmediaExtractionConfiguration) については、「」を参照してくださいデータソースを接続する

connectionConfiguration
フィールド 必要 説明
secretArn はい Box 認証情報を含む AWS Secrets Manager シークレットの ARN。
authType はい 認証タイプ: CCG (推奨) または OAUTH2。「認証方法」を参照してください。
dataEntityConfiguration (OAuth 2.0 のみ)
フィールド 必要 説明
inclusionFolderIds いいえ クロールするフォルダ IDs のリスト。
inclusionFileIds いいえ クロールするファイル IDs のリスト。
filterConfiguration (オプション)
フィールド 必要 説明
maxFileSizeInMegaBytes いいえ コネクタが取り込む 1 つのファイルの最大サイズ、メガバイト単位。数値文字列として を指定します (例: "500")。デフォルトは "500" です。
aclEnabled (オプション)
フィールド 必要 説明
aclEnabled いいえ に設定するとtrue、ドキュメントレベルのアクセスコントロールが有効になります。CCG 認証が必要です。データソースの作成後にこの設定を変更することはできません。詳細については、「ドキュメントレベルのアクセスコントロール」を参照してください。

認証方法を変更する

UpdateDataSource オペレーションまたは を使用して、データソースの認証方法 (OAuth 2.0 からクライアント認証情報付与など) を変更するには、データソースを新しい authTypeと、一致する認証情報を含むシークレットで更新します AWS マネジメントコンソール。ドキュメントレベルのアクセスコントロール設定は、データソースの作成時に修正されるため、ACLs を追加または削除するには、新しいデータソースを作成する必要があります。

次の手順

データソースを作成したら、同期してコンテンツをナレッジベースに取り込みます。詳細については、「データソースを同期する」を参照してください。ユーザーアクセス許可でクエリ結果をフィルタリングするには、「」を参照してくださいドキュメントレベルのアクセスコントロール