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

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

始める前に

GitHub 接続を設定する前に、次のものが用意されていることを確認してください。

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

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

      [IAM] に移動

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

  • GitHub アカウントにログインして、認証情報を取得します。

  • このコネクタを使用する GitHub アプリを作成します。詳細については、GitHub アプリの作成をご覧ください。

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

GitHub データストアを作成するには、次の手順を実行します。

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

    Gemini Enterprise

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

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

  4. [Create data store] をクリックします。

  5. [ソース] セクションで「GitHub」を検索して選択します。

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

    1. クライアント認証情報の詳細を入力します。

      • クライアント ID: アプリケーションの OAuth クライアント ID。
      • クライアント シークレット: アプリケーションの OAuth クライアント シークレット。

      認証情報の詳細については、GitHub 構成をご覧ください。

    2. ユーザーが ID プロバイダ（IdP）を介してログインする場合、 GitHub Enterprise Managed Users （EMU）など、 GitHub SSO のログイン情報を入力します。それ以外の場合は、これらのフィールドを空白のままにします。

      • GitHub SSO スコープ: ログインをゲートする GitHub 名前空間。IdP がエンタープライズ レベルで構成されている場合は、[enterprises] を選択します。IdP が組織レベルで構成されている場合は、[orgs] を選択します。

      • GitHub SSO スラッグ: GitHub エンタープライズまたは 組織のスラッグ。たとえば、エンタープライズ URL https://github.com/enterprises/octocorp の場合は octocorp です。スラッグのみを入力してください。完全な URL は入力しないでください。

    3. [Verify Auth] をクリックして、GitHub 認証の確認を完了します。

  7. [データ] > [詳細オプション] セクションで、次の操作を行います。

    1. [組織名] フィールドに GitHub 組織名を入力します。 検索とアクションのスコープを設定するために必要です。

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

  8. [データ] > [検索するエンティティ] セクションで、次の操作を行います。

    1. 必要なエンティティを選択します。

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

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

    1. [Select GitHub actions to enable] で、カテゴリからアクションを選択して、そのデータストアを有効にします。

      アクションのリストを管理するには、アクションの管理をご覧ください。

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

  10. データストアの作成フローに [詳細オプション] セクションが表示される場合は、そのセクションで [Enable Static IP Addresses] チェックボックスをオンにできます。これにより、データストアは送信トラフィックに固定 IP アドレスのセットを使用するようになり、ソースシステムでの許可リスト登録に適しています。詳細については、静的 IP エグレスを構成するをご覧ください。

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

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

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

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

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

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

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

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

クエリ実行

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

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

データの取り扱い

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

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

次のステップ