このページでは、データストアを作成して GitHub を Gemini Enterprise に接続する方法について説明します。
始める前に
GitHub 接続を設定する前に、次のものが用意されていることを確認してください。
ディスカバリー エンジン編集者ロール(
roles/discoveryengine.editor)を付与します。このロールは、ユーザーがデータストアを作成する際に必要になります。このロールを付与する手順は次のとおりです。- Google Cloud コンソールで、[IAM] ページに移動します。
- ユーザー アカウントを見つけて、edit 編集アイコンをクリックします。
- ユーザーに
Discovery Engine Editorロールを付与します。詳細については、IAM のロールと権限をご覧ください。
GitHub アカウントにログインして、認証情報を取得します。
このコネクタを使用する GitHub アプリを作成します。詳細については、GitHub アプリの作成をご覧ください。
GitHub データストアを作成する
GitHub データストアを作成する手順は次のとおりです。
コンソールで、[Gemini Enterprise] ページに移動します。 Google Cloud
Google Cloud プロジェクトを選択するか作成します。
ナビゲーション メニューで [データストア] をクリックします。
[Create data store] をクリックします。
In the [Source] section, search for [GitHub], and click [Select].
[データ] セクションで、次の操作を行います。
[認証設定] セクションに、次の詳細を入力します。
- クライアント ID: アプリケーションの OAuth クライアント ID。
- クライアント シークレット: アプリケーションの OAuth クライアント シークレット。
認証情報の詳細については、GitHub の構成をご覧ください。
[ログイン] をクリックして、GitHub へのログインと承認を完了します。
[詳細オプション] セクションの [オーナーのログイン] フィールドに組織名を入力します。
[続行] をクリックします。
[検索するエンティティ] セクションで、必要なエンティティをすべて選択します。
[続行] をクリックします。
[アクション] セクションの [Select GitHub actions to enable] で、カテゴリからアクションを選択して、データストアを有効にします。
アクションのリストを管理するには、アクションの管理をご覧ください。
[続行] をクリックします。
[構成] セクションで、次の操作を行います。
- [マルチリージョン] リストから、データコネクタのロケーションを選択します。
- [データコネクタ名] フィールドに、コネクタの名前を入力します。
- ロケーションとして
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 に関連付ける場合があります。
- 複数のフェデレーション検索データソースが有効になっている場合、クエリはそれらすべてに送信されることがあります。
- データがサードパーティ システムに到達すると、そのシステムの利用規約とプライバシー ポリシーに則って管理されます。
次のステップ
- アプリが設定された後に検索結果がどのように表示されるかをプレビューする。検索結果を取得するをご覧ください。
- データストアのアラートを有効にする。サードパーティのデータストアのアラートを構成するをご覧ください。