サードパーティ データソースを接続する

注: この機能はプレビュー版で、GCP サービス固有の規約の「pre-GA サービス規約」が適用されます。 一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、これらのプロダクトや機能には、他の一般提供前のバージョンと互換性のない変更が行われる場合があります。詳細については、リリース ステージの説明をご覧ください。 さらに、この機能を使用すると、生成 AI プレビュー版の利用規約（以下「プレビュー規約」）に同意したことになります。この機能については、お客様は Cloud のデータ処理に関する追加条項に記載されているとおりに個人データを処理できます。その際、（プレビュー規約に定義されるとおり）本契約で規定されている制限と義務が適用されます。

このページでは、サードパーティのデータソースを Vertex AI Search に接続する方法について説明します。

プレビュー: サードパーティのコネクタは許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

サードパーティのデータソースを接続するときに、Vertex AI Search はデータコネクタを作成し、指定したエンティティにデータストア（エンティティ データストア）を関連付けます。エンティティ タイプは、接続先のデータソースに固有です。たとえば、Jira Cloud のエンティティには、問題、添付ファイル、コメント、ワークログなどがあります。

サードパーティのデータソースは、一般的な検索アプリでのみ使用できます。チャット、レコメンデーション、エージェント アプリではサードパーティのデータソースを使用できません。

サードパーティ製コネクタは CMEK 準拠ではありません。

Google データソースからデータをインポートするには、検索データストアを作成するをご覧ください。

始める前に

1. Google アカウント チームに連絡し、サードパーティのデータソース コネクタの許可リストへの追加を依頼します。

2. 使用するソースのセクションに移動します。

   • Confluence Cloud を接続する
   • Jira Cloud を接続する
   • Salesforce を接続する
   • ServiceNow を接続する
   • SharePoint Online を接続する
   • Slack を接続する
   • Dropbox を接続する
   • Box を接続する
   • OneDrive を接続する

Confluence Cloud を接続する

次の手順を使用して、Confluence Cloud から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の認証情報を用意します。

  • インスタンスの URL。https://EXAMPLE.atlassian.net の形式です。例: https://google.atlassian.net。

  • インスタンス ID。これは cloudid です。https://EXAMPLE.atlassian.net/_edge/tenant_info に移動して cloudId の値をコピーすると確認できます。

• OAuth 2.0 を有効にして、クライアント ID とクライアント シークレットを取得します。

  コールバック URL として https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html を使用します。Confluence Cloud で OAuth 2.0 を有効にしてクライアント ID とクライアント シークレットを取得する方法については、Atlassian デベロッパー ドキュメントの OAuth 2.0（3LO）アプリをご覧ください。

• OAuth 2.0 権限スコープを設定する場合は、次のスコープを構成します。

  スコープを表示する

  • read:permission:confluence
  • read:content:confluence
  • read:content-details:confluence
  • read:space-details:confluence
  • read:audit-log:confluence
  • read:page:confluence
  • read:attachment:confluence
  • read:blogpost:confluence
  • read:custom-content:confluence
  • read:comment:confluence
  • read:template:confluence
  • read:label:confluence
  • read:watcher:confluence
  • read:group:confluence
  • read:relation:confluence
  • read:user:confluence
  • read:configuration:confluence
  • read:space:confluence
  • read:space.permission:confluence
  • read:space.property:confluence
  • read:user.property:confluence
  • read:space.setting:confluence
  • read:analytics.content:confluence
  • read:content.permission:confluence
  • read:content.property:confluence
  • read:content.restriction:confluence
  • read:content.metadata:confluence

• ユーザー権限を正しく適用するには、各 Confluence Cloud ユーザーがメールアドレスをすべてのユーザーに公開する必要があります。これを行うには、Confluence Cloud でメールの公開設定を変更し、公開設定を Anyone に設定します。詳細については、Atlassian のドキュメントのメールの公開設定を設定するをご覧ください。

Console

Google Cloud コンソールを使用して Confluence Cloud から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [新しいデータストア] をクリックします。

4. [データソースを選択] ページで、[サードパーティ ソース] セクションに移動し、[Confluence] を選択します。

5. 認証情報を入力し、[認証] をクリックします。

6. 新しいウィンドウが表示されます。 インスタンスのユーザー名とパスワードを入力します。 認証が成功したことを確認してから、[データストアの Confluence ソースを指定する] ページに戻ります。

7. 同期するエンティティを選択し、[続行] をクリックします。

8. データ コネクタのリージョンを選択します。

9. データ コネクタの名前を入力します。

10. 同期の頻度を選択します。

11. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

12. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [アクティブ] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

Jira Cloud を接続する

次の手順を使用して、Jira Cloud から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の認証情報を用意します。

  • インスタンスの URL。https://EXAMPLE.atlassian.net の形式です。例: https://google.atlassian.net。

  • インスタンス ID。これは cloudid です。https://EXAMPLE.atlassian.net/_edge/tenant_info に移動して cloudId の値をコピーすると確認できます。

  • OAuth 2.0 を有効にして、クライアント ID とクライアント シークレットを取得します。

    コールバック URL として https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html を使用します。OAuth 2.0 を有効にしてクライアント ID とクライアント シークレットを取得する方法については、Atlassian デベロッパー ドキュメントの OAuth 2.0（3LO）アプリをご覧ください。

• OAuth 2.0 権限スコープを設定する場合は、次のスコープを構成します。

  スコープを表示する

  • read:jira-work
  • manage:jira-project
  • manage:jira-configuration
  • read:jira-user
  • write:jira-work
  • manage:jira-webhook
  • manage:jira-data-provider

• 必要なユーザーロールは組織管理者です。

次の制限が適用されます。

• ユーザー権限が正しく適用されるようにするには、Jira Cloud ユーザーが共有に同意する必要があります。

Console

Google Cloud コンソールを使用して Jira Cloud から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースを選択] ページで、[サードパーティ ソース] セクションに移動し、[Jira] を選択します。

5. 認証情報を入力し、[認証] をクリックします。

6. 新しいウィンドウが表示されます。 インスタンスのユーザー名とパスワードを入力します。 認証が成功したことを確認してから、[データストアの Jira ソースを指定する] ページに戻ります。

7. 同期するエンティティを選択し、[続行] をクリックします。

8. データストアのリージョンを選択します。

9. データストアの名前を入力します。

10. 同期の頻度を選択します。

11. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

12. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [アクティブ] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

Salesforce を接続する

次の手順を使用して、Salesforce から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の認証情報を用意します。Salesforce でコンシューマ ID とシークレットを設定する方法については、Salesforce のドキュメントの OAuth 2.0 クライアント認証情報フローの接続アプリを構成するをご覧ください。

  • インスタンスの URL
  • コンシューマ ID
  • コンシューマ シークレット

次の制限が適用されます。

• ユーザーをエンティティとして同期するには、ユーザーが共有に同意する必要があります。

Console

Google Cloud コンソールを使用して Salesforce から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud を Salesforce CORS 許可リストに追加します。すでにこの操作を行っている場合は、次のステップに進みます。

   1. Salesforce のドキュメントの手順に沿って、CORS 許可リストを構成します。

   2. オリジン URL として https://console.cloud.google.com/ を入力し、構成を保存します。

2. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

3. ナビゲーション メニューで [データストア] をクリックします。

4. [データストアを作成] をクリックします。

5. [データソースの選択] ページで、[サードパーティ ソース] セクションに移動し、[Salesforce] を選択します。

6. Salesforce の認証情報を入力します。

7. 同期するエンティティを選択し、[続行] をクリックします。

8. データストアのリージョンを選択します。

9. データストアの名前を入力します。

10. 同期の頻度を選択します。

11. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

12. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。 データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [アクティブ] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

ServiceNow を接続する

次の手順を使用して、ServiceNow から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の認証情報を用意します。

  • https://<domain-name>.service-now.com/ 形式のインスタンス URL。
  • クライアント ID とクライアント シークレット。エンドポイントの設定とクライアント ID とクライアント シークレットの取得については、ServiceNow のドキュメントのクライアントがインスタンスにアクセスするためのエンドポイントを作成するをご覧ください。

  • 次のいずれかの ServiceNow ロールタイプのユーザー名とパスワード:

    • 管理者ロール。ServiceNow ドキュメントの基本システムロールをご覧ください。

    • カスタム ServiceNow ロール。これは、管理者ロールを使用する代わりに使用できます。カスタム ServiceNow ロールを使用するには、次のフィールドを使用してアクセス制御ルールを作成します。

      フィールドを表示する

      • タイプ: record
      • オペレーション: read
      • 名前（それぞれに個別のアクセス制御ルールが必要）:
      • incident
      • sc_cat_item
      • kb_knowledge
      • kb_knowledge_base
      • kb_uc_can_read_mtom
      • kb_uc_can_contribute_mtom
      • sys_user_role
      • sys_user_has_role
      • sys_user_group
      • sys_user_grmember
      • ロールが必要: カスタムロールの名前

      詳細については、ServiceNow のドキュメントのロールを作成するとACL ルールを作成するをご覧ください。

Console

Google Cloud コンソールを使用して ServiceNow から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースを選択] ページで、[サードパーティ ソース] セクションに移動し、[ServiceNow] を選択します。

5. ServiceNow の認証情報を入力します。

6. 同期するエンティティを選択し、[続行] をクリックします。

7. データ コネクタのリージョンを選択します。

8. データ コネクタの名前を入力します。

9. 同期の頻度を選択します。

10. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

11. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。 データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [アクティブ] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

SharePoint Online を接続する

次の手順を使用して、SharePoint Online から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• Sharepoint アカウントの 2 要素認証（2FA）をオフにする必要があります。基本的な Oauth2 パスワード認証のみがサポートされています。

• 管理者の同意を付与します。同意を付与する方法については、Microsoft のドキュメントのテナント全体の管理者の同意をアプリケーションに付与するをご覧ください。

• 設定時に使用する次の SharePoint Online の認証情報を用意します。

  • インスタンスの URL。http://DOMAIN_OR_SERVER/[sites/]WEBSITE の形式です。 URL の詳細については、SharePoint ドキュメントの SharePoint の URL とトークンをご覧ください。
  • テナント ID、クライアント ID、クライアント シークレット。アプリケーションを登録するには、ログイン オーディエンスに [この組織ディレクトリ内のアカウントのみ] を選択してから、この認証情報を探します。詳細については、Microsoft のドキュメントのクイックスタート: Microsoft Identity Platform にアプリケーションを登録するをご覧ください。
  • ユーザー名とパスワード。これらは、2 段階認証プロセスが無効になっている SharePoint サイト管理者または SharePoint サイト コレクション管理者のいずれかに対応する必要があります。

• 次の表に、構成に推奨されるロールとその制限事項を示します。

  ロールを表示する

  ロール	クライアント アプリケーションの登録	すべてのエンティティのコンテンツを取得できる	ACL を取得できる	ID を取得できる	メモ
  サイト管理者	×	○	○	○
  サイト コレクション管理者	×	○	○	○
  グローバル管理者	○	×	○	×	制限事項: ID やコメント、添付ファイルのエンティティを取得できない
  サイト所有者	×	○	○	×	制限事項: ID を取得できない
  アプリケーション管理者	○	なし	なし	なし	アプリケーション管理者ロールは、Microsoft 365 管理センター / Entra 管理センターに関連しています。これは SharePoint に固有のものではありません。

Console

Google Cloud コンソールを使用して Sharepoint Online から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースを選択] ページで、[サードパーティ ソース] セクションに移動し、[Sharepoint Online] を選択します。

5. SharePoint Online の認証情報を入力します。

6. 同期するエンティティを選択し、[続行] をクリックします。

7. データストアのリージョンを選択します。

8. データストアの名前を入力します。

9. データストアの同期頻度を選択します。

10. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

11. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [アクティブ] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

Slack を接続する

次の手順を使用して、Slack から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の Slack の認証情報を用意します。

  • ワークスペース ID。ワークスペース ID の取得については、Slack ドキュメントのデータストアの Slack ソースを指定するをご覧ください。
  • アクセス トークン。 クライアント アプリの作成とスコープの定義については、Slack のドキュメントのクイックスタートとSlack API トークンをすばやく取得して使用する方法をご覧ください。
  • OAuth 2.0 権限スコープを設定する場合は、次のスコープを構成します。

    スコープを表示する

    • users:read.email
    • channels:history
    • channels:read
    • groups:history
    • groups:read
    • im:history
    • im:read
    • mpim:history
    • mpim:read
    • team:read
    • users.profile:read
    • users:read
    • files:read
    • usergroups:read

次の制限が適用されます。

• Slack のデフォルトの動作では、非公開チャンネル、マルチパーティのインスタント メッセージ、1 対 1 のインスタント メッセージのコンテンツのクロールと同期が制限されます。

Console

Google Cloud コンソールを使用して Slack から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースを選択] ページで、[サードパーティ ソース] セクションに移動し、[Slack] を選択します。

5. Slack の認証情報を入力します。

6. 同期するエンティティを選択し、[続行] をクリックします。

7. データストアのリージョンを選択します。

8. データストアの名前を入力します。

9. データストアの同期頻度を選択します。

10. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

11. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [アクティブ] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

Dropbox を接続する

次の手順を使用して、Dropbox から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

始める前に

接続を設定する前に:

• データソースのアクセス制御を設定します。詳細については、データソースのアクセス制御を使用するをご覧ください。

• 次の Dropbox の認証情報を用意します。これらのパラメータの設定については、Dropbox ドキュメントの OAuth ガイドをご覧ください。

  • クライアント ID
  • クライアント シークレット

Console

Google Cloud コンソールを使用して Dropbox から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースを選択] ページで、[サードパーティ ソース] セクションに移動し、[Dropbox] を選択します。

5. Dropbox の認証情報を入力し、[認証] をクリックします。新しいウィンドウが表示されます。

6. アカウントを認証し、認証が成功したことを確認してから、[データストアの Dropbox ソースを指定する] ページに戻ります。

7. 同期するエンティティを選択し、[続行] をクリックします。

8. データストアのロケーションを選択します。

9. データストアの名前を入力します。

10. データストアの同期頻度を選択します。

11. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

12. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [アクティブ] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。[ドキュメント] タブで、エンティティが正しく取り込まれていることを確認します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• アプリとデータストアを設定した後の検索結果の表示方法をプレビューするには、検索結果を取得するをご覧ください。サードパーティのアクセス制御を使用した場合は、サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

Box を接続する

次の手順でを使用して、Box から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

始める前に

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の Box の認証情報を用意します。これらのパラメータの設定については、Box デベロッパー ドキュメントの JWT Auth をご覧ください。

  • 企業 ID
  • クライアント ID
  • クライアント シークレット
  • 公開鍵 ID
  • 秘密鍵
  • パスフレーズ

• JWT エンドポイントを作成するときに、次のスコープを構成します。

  スコープを表示する

  • root_readonly
  • root_readwrite
  • manage_managed_users
  • manage_app_users
  • manage_groups
  • manage_enterprise_properties
  • as_user
  • generate_access_token

次の制限が適用されます。

• コメントの増分変更の同期には、構成された頻度間隔よりも時間がかかる場合があります。
• エンティティを含むフォルダがコピーまたは移動された場合、増分変更の同期には、構成された頻度間隔よりも時間がかかることがあります。

Console

Google Cloud コンソールを使用して Box から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースを選択] ページで、[サードパーティ ソース] セクションに移動し、[Box] を選択します。

5. 認証情報を入力します。

6. 同期するエンティティを選択し、[続行] をクリックします。

7. データストアのリージョンを選択します。

8. データストアの名前を入力します。

9. データストアの同期頻度を選択します。

10. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

11. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [アクティブ] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• アプリとデータストアを設定した後の検索結果の表示方法をプレビューするには、検索結果を取得するをご覧ください。サードパーティのアクセス制御を使用した場合は、サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

OneDrive を接続する

次の手順を使用して、OneDrive から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

始める前に

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の OneDrive の認証情報を用意します。

  • クライアント ID、クライアント シークレット、テナント ID。これらのパラメータの設定については、Microsoft のドキュメントのクイックスタート: Microsoft Identity Platform にアプリケーションを登録するをご覧ください。

  • アクセスのスコープを指定します。管理者のロールが必要です。詳細については、Microsoft のドキュメントの クイックスタート: ウェブ API にアクセスするようにクライアント アプリケーションを構成するをご覧ください。

    次のスコープを構成します。

    スコープを表示する

    • Files.Read.All Application
    • Group.Read.All Application
    • Sites.FullControl.All Application
    • User.Read Delegated
    • User.Read.All Application

Console

Google Cloud コンソールを使用して OneDrive から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースを選択] ページで、[サードパーティ ソース] セクションに移動し、[OneDrive] を選択します。

5. OneDrive の認証情報を入力します。

6. 同期するエンティティを選択し、[続行] をクリックします。

7. データストアのリージョンを選択します。

8. データストアの名前を入力します。

9. データストアの同期頻度を選択します。

10. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

11. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [アクティブ] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• アプリとデータストアを設定した後の検索結果の表示方法をプレビューするには、検索結果を取得するをご覧ください。サードパーティのアクセス制御を使用した場合は、サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。