このページでは、データストアを作成して GitHub を Gemini Enterprise に接続する方法について説明します。
始める前に
GitHub 接続を設定する前に、次のものが揃っていることを確認してください。
ディスカバリー エンジン編集者ロール(
roles/discoveryengine.editor)を付与します。このロールは、ユーザーがデータストアを作成する際に必要になります。このロールを付与する手順は次のとおりです。- Google Cloud コンソールで、[IAM] ページに移動します。
- ユーザー アカウントを見つけて、edit 編集アイコンをクリックします。
- ユーザーに
Discovery Engine Editorロールを付与します。詳細については、IAM のロールと権限をご覧ください。
GitHub アカウントにログインして、認証情報を取得します。
GitHub データストアを作成する
GitHub データストアを作成する手順は次のとおりです。
Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。
Google Cloud プロジェクトを選択するか作成します。
ナビゲーション メニューで [データストア] をクリックします。
[データストアを作成] をクリックします。
[ソース] セクションで「GitHub」を検索し、[選択] をクリックします。
[データ] セクションで、次の操作を行います。
[認証の設定] セクションで、次の詳細を入力します。
- クライアント ID: アプリケーションの OAuth クライアント ID。
- クライアント シークレット: アプリケーションの OAuth クライアント シークレット。
認証情報の詳細については、GitHub の構成をご覧ください。
[ログイン] をクリックして、GitHub へのログインと承認を完了します。
[詳細オプション] セクションの [所有者のログイン] フィールドに組織名を入力します。
[続行] をクリックします。
[検索するエンティティ] セクションで、必要なすべてのエンティティを選択します。
[続行] をクリックします。
[構成] セクションで、次の操作を行います。
- [マルチリージョン] リストから、データコネクタのロケーションを選択します。
- [データコネクタ名] フィールドに、コネクタの名前を入力します。
- ロケーションとして
usまたはeuを選択した場合は、[暗号化設定] を構成します。- 省略可: 単一リージョンの鍵を構成していない場合は、[設定ページに移動] をクリックして構成します。詳細については、サードパーティ コネクタの単一リージョンの鍵を登録するをご覧ください。
- [Googleが管理する暗号鍵] または [Cloud KMS 鍵] を選択します。
- [Cloud KMS 鍵] を選択した場合:
- [鍵管理のタイプ] リストで、適切なタイプを選択します。
- [Cloud KMS 鍵] リストで、鍵を選択します。
[続行] をクリックします。
[お支払い] セクションで、[全般的な料金] または [構成可能な料金] を選択します。詳細については、プロジェクトの課金ステータスを確認するとライセンスをご覧ください。
[作成] をクリックします。Gemini Enterprise によってデータストアが作成され、[データストア] ページにデータストアが表示されます。
[データストア] ページで、データストア名をクリックしてステータスを確認します。データストアの状態が「作成中」から「アクティブ」に変わると、GitHub コネクタを使用できるようになります。
データストアを作成したら、既存のアプリに接続するか、新しいアプリを作成してデータストアをアプリに接続できます。詳細については、次のステップをご覧ください。
データの取り扱いとクエリの実行
このセクションでは、Gemini Enterprise がクエリを管理する方法と、フェデレーション データストアの使用によるプライバシーへの潜在的な影響について説明します。
クエリ実行
GitHub を承認した後、Gemini Enterprise に検索クエリを送信すると、次のようになります。
- Gemini Enterprise は、検索クエリを GitHub API に直接送信します。
- Gemini Enterprise は、結果を接続された他のデータソースからの結果と統合して、包括的な検索結果を表示します。
データの取り扱い
サードパーティの連携検索を使用する場合、次のデータ処理ルールが適用されます。
- クエリ文字列がサードパーティの検索バックエンド(GitHub API)に送信されます。
- これらのサードパーティは、クエリをユーザーの ID に関連付ける場合があります。
- 複数のフェデレーション検索データソースが有効になっている場合、クエリはそれらすべてに送信されることがあります。
- データがサードパーティ システムに到達すると、そのシステムの利用規約とプライバシー ポリシーが適用されます。
次のステップ
- GitHub データをクエリするためのユーザー インターフェースを提供するには、GitHub データストアをアプリに接続します。手順については、データストアをアプリに接続して Gemini Enterprise を承認するをご覧ください。
- アプリが設定された後に検索結果がどのように表示されるかをプレビューする。検索結果を取得するをご覧ください。
- データストアのアラートを有効にする。サードパーティのデータストアのアラートを構成するをご覧ください。