Zendesk データストアを設定する

このページでは、データストアを作成して Zendesk を Gemini Enterprise に接続する方法について説明します。

始める前に

Zendesk データストアを設定する前に、次のことを確認してください。

  1. ディスカバリー エンジン編集者ロール（roles/discoveryengine.editor）を付与します。このロールは、ユーザーがデータストアを作成する際に必要になります。このロールを付与する手順は次のとおりです。

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

      IAM に移動

    2. ユーザー アカウントを見つけて、edit 編集アイコンをクリックします。
    3. ユーザーに Discovery Engine Editor ロールを付与します。詳細については、IAM のロールと権限をご覧ください。

  2. OAuth クライアントを作成し、次の認証情報を取得します。

    • クライアント ID

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

  3. OAuth アプリケーションの 必要な権限を Zendesk 内で構成します。

  4. Zendesk API 設定でトークン アクセスが有効になっていることを確認します。

Zendesk データストアを作成する

Zendesk データストアを作成する手順は次のとおりです。

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

    Gemini Enterprise

  2. Google Cloud プロジェクトを選択するか作成します。

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

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

  5. [ソース] で「Zendesk」を検索し、[選択] をクリックします。

  6. [データ] セクションで、次の操作を行います。

    1. [認証の設定] セクションで、次の詳細を入力します。 * インスタンス URI: Zendesk インスタンス URI（https://[subdomain].zendesk.com など）を入力します。 * クライアント ID: Zendesk に登録されているアプリケーションの一意の識別子。* クライアント シークレット: Zendesk での OAuth 2.0 アプリケーション登録プロセスで生成された秘密鍵。

      クライアント ID とクライアント シークレットの取得方法については、クライアント ID とクライアント シークレットを取得するをご覧ください。検索の実行に必要な権限については、必要な権限をご覧ください。

    2. [ログイン] をクリックして、Zendesk へのログインを完了します。

    3. [続行] をクリックします。

    4. [宛先] セクションで、次の操作を行います。

      1. プロキシ サーバー: HTTP トラフィックをルーティングするプロキシのホスト名または IP アドレスを入力します。ホストとポートを含めます。
      2. Zendesk Support URL: インスタンス URL（https:// を含む）を入力します。これは Zendesk Support の URL です。
      3. [続行] をクリックします。

    5. 省略可: [詳細オプション] セクションで、次の操作を行います。

      1. 静的 IP アドレスを有効にする: システムの許可リストに追加する静的 IP アドレスの狭いセットを登録します。これらの IP アドレスが許可リストに登録されるまで、同期実行は失敗します。
      2. 1 分あたりの最大 API リクエスト数: 各コネクタ実行で Zendesk インスタンスに送信する 1 分あたりの最大 API リクエスト数。
      3. [続行] をクリックします。

    6. [検索するエンティティ] セクションで、検索するすべてのエンティティをリストから選択します。エンティティを 1 つ以上選択する必要があります

  7. [続行] をクリックします。

  8. [構成] セクションで、次の操作を行います。

    1. [マルチリージョン] リストから、データコネクタのロケーションを選択します。
    2. [データコネクタ名] フィールドに、コネクタの名前を入力します。
    3. ロケーションとして US または EU を選択した場合は、暗号化設定を構成します。
      • 省略可: 単一リージョンの鍵を構成していない場合は、[設定ページに移動] をクリックして構成します。詳細については、サードパーティ コネクタの単一リージョンの鍵を登録するをご覧ください。
      • [Googleが管理する暗号鍵] または [Cloud KMS 鍵] を選択します。
      • [Cloud KMS 鍵] を選択した場合:
        • [鍵管理のタイプ] リストで、適切なタイプを選択します。
        • [Cloud KMS 鍵] リストで、鍵を選択します。
      詳細については、顧客管理の暗号鍵をご覧ください。

  9. [続行] をクリックします。

  10. [お支払い] セクションで、[全般的な料金] または [構成可能な料金] を選択します。詳細については、プロジェクトの課金ステータスを確認するとライセンスをご覧ください。

[データストア] ページで、データストア名をクリックしてステータスを確認します。データストアの状態が「作成中」から「アクティブ」に変わると、Zendesk コネクタを使用できるようになります。

データストアを作成したら、アプリを作成し、Zendesk データストアに接続します。クエリを実行する前に、Gemini Enterprise を Zendesk に対して承認します。

検索の実行に必要な権限については、必要な権限をご覧ください。

データの取り扱いとクエリの実行

このセクションでは、Gemini Enterprise がクエリを管理する方法と、フェデレーション データストアの使用によるプライバシーへの潜在的な影響について説明します。

クエリ実行

Zendesk を承認した後、Gemini Enterprise に検索クエリを送信すると、次のようになります。

  • Gemini Enterprise は、検索クエリを Zendesk API に直接送信します。
  • Gemini Enterprise は、結果を接続された他のデータソースからの結果と統合して、包括的な検索結果を表示します。

データの取り扱い

サードパーティの連携検索を使用する場合、次のデータ処理ルールが適用されます。

  • クエリ文字列がサードパーティの検索バックエンド（Zendesk API）に送信されます。
  • これらのサードパーティは、クエリをユーザーの ID に関連付ける場合があります。
  • 複数の連携検索データソースが有効になっている場合、クエリはそれらすべてに送信されることがあります。
  • データがサードパーティ システムに到達すると、そのシステムの利用規約とプライバシー ポリシーが適用されます。

次のステップ