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

注: この機能はプレビュー版で、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 を接続する
   • Connect Box
   • OneDrive を接続する

Confluence Cloud を接続する

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

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

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

接続を設定する前に:

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

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

  • インスタンスの URLhttps://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. 認証情報を入力し、[Authenticate] をクリックします。

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

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

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

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

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

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

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

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

次のステップ

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

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

Jira Cloud を接続する

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

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

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

始める前に

接続を設定する前に:

• アクセス制御を設定します。データソースのアクセス制御が適切に構成されていることを確認します。この手順により、承認されたユーザーのみがデータにアクセスして管理できるようになります。詳細については、データソースのアクセス制御を使用するをご覧ください。
• ユーザー権限を正しく適用するには、Jira Cloud ユーザーが共有の同意を提供する必要があります。
• Atlassian アカウント、Jira インスタンス、プロジェクトがあることを確認します。
• Jira インスタンスとプロジェクトに対する管理者権限があることを確認します。

Jira で認証と権限を設定する

次のセクションの手順に沿って、Jira インスタンスに必要な認証情報と管理者権限があることを確認します。Atlassian Developer Console でクライアント ID とクライアント シークレットを作成し、必要な OAuth 2.0 スコープを構成して、ユーザーの権限を設定します。最後に、インスタンスの URL と ID を取得し、ロールを構成して認証し、Jira Cloud と Vertex AI Search の間でデータを同期します。

クライアント ID とクライアント シークレットを作成する

注: OAuth 2.0 を有効にしてクライアント ID とシークレットを取得するには、Atlassian デベロッパー ドキュメントの OAuth 2.0（3LO）アプリをご覧ください。

1. developer.atlassian.com にログインします。
2. 右上のプロフィール アイコンをクリックし、[デベロッパー コンソール] を選択します。
3. [Create] をクリックし、[OAuth 2.0 Integration] を選択します。
4. アプリの名前を入力します。
   • 利用規約のチェックボックスをオンにします。
   • [作成] をクリックします。

5. [概要]、[配信]、[権限]、[認証]、[設定] の 5 つのオプションが表示されます。まず、[Authorization] から始めます。

   a. [承認] をクリックします。

   b. [認証タイプ] テーブルで、[OAuth 2.0（3LO）] の [追加] を選択します。

6. [Callback URL] フィールドに https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html を入力し、[Save changes] をクリックします。

   注: [アプリに API がありません。アプリに API を追加する。これは次のセクションで説明します。

7. [権限] を選択します。

   a. [Jira API] に移動し、[追加]、[構成] の順にクリックします。

   注: [追加] をクリックすると、ボタンが [設定] に変わります。

   b. [従来のスコープ] タブに移動し、[スコープを編集] をクリックします。次のスコープを選択します。

   ビュー スコープ

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

   7 つのスコープが選択されていることを確認して、変更を保存します。

8. [配信] をクリックし、[編集] を選択して、次の操作を行います。

   • 他のフィールドの編集を有効にするには、まず [共有] ラジオボタンを選択します。
   • 残りのフィールドに入力します。
   • Does your app store personal data? と尋ねられたら [はい] を選択します。

9. [設定] を選択して、[クライアント ID] と [クライアント シークレット] をコピーします。

インスタンスの URL とインスタンス ID を取得する

インスタンスの URL を取得する手順は次のとおりです。

1. atlassian.net に移動し、管理者アカウントでログインします。
2. 同期するアプリを選択します。たとえば、最初のアプリを同期します。
3. インスタンス URL（アドレスバーのサブドメイン）を確認します。Assign appropriate permissions のようになります。

インスタンス ID を取得する手順は次のとおりです。

1. 新しいタブを開き、インスタンスの URL をコピーして、インスタンスの URL に /_edge/tenant_info を追加します。例: https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info
2. リンクに移動して、cloudId 値を確認します。cloudId はインスタンス ID です。

権限とロールを設定する

1. 管理者アカウントで atlassian.com にログインします。
2. 左上のメニュー アイコンをクリックするか、admin.atlassian.com に移動します。

3. [管理] ページで [ユーザーを管理] をクリックし、[グループ] ページに移動します。

4. [グループを作成] をクリックします。 グループの名前を入力して作成します。

5. 新しいグループのページの [グループ商品アクセス] セクションで、[グループに商品を追加] をクリックします。

6. Jira の場合は、プロダクトのロールとして [ユーザー アクセス管理者] を選択します。

7. [Jira 管理者] で、プロダクト ロールとして [プロダクト管理者] を選択し、変更を保存します。

8. [グループ] ページで [グループ メンバーを追加] をクリックし、コネクタが認証するユーザーまたはアカウントを追加します。

Jira Cloud コネクタを作成する

Console

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

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

   Agent Builder

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

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

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

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

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 認証情報を準備します。

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

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

次のステップ

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

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

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

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

次のステップ

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

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