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