AlloyDB Studio でコンテキスト セットを管理する

このドキュメントでは、コンテキスト セット ファイルを使用して AlloyDB for PostgreSQL Studio でコンテキスト セットを作成する方法について説明します。コンテキスト セット名は、データベース内で一意である必要があります。

コンテキスト セットの詳細については、コンテキスト セットの概要をご覧ください。

始める前に

エージェントを作成する前に、次の前提条件を満たす必要があります。

必要なサービスを有効にする

プロジェクトで次のサービスを有効にします。

AlloyDB for PostgreSQL クラスタ、インスタンス、データベースを準備する

既存の AlloyDB クラスタとインスタンスにアクセスできることを確認するか、新しいクラスタとインスタンスを作成します。
このチュートリアルでは、AlloyDB インスタンスにデータベースが必要です。詳細については、データベースを作成するをご覧ください。

必要なロールと権限

AlloyDB for PostgreSQL インスタンスに executesql 権限を付与する

AlloyDB for PostgreSQL インスタンスに executesql 権限を付与し、data_api_access インスタンス設定を値 ALLOW_DATA_API に設定するには、次の curl コマンドを使用します。
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED",
     }'
次のように置き換えます。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • LOCATION: AlloyDB クラスタが配置されているリージョン。
  • CLUSTER_ID: AlloyDB クラスタの ID。
  • INSTANCE_ID: AlloyDB インスタンスの ID。
このチュートリアルの手順を行うには、Google Cloud にログインし、IAM 認証を使用してデータベースに対する認証を行います。

コンテキスト セットを作成する

コンテキスト セットを作成する手順は次のとおりです。

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

    AlloyDB に移動する

  2. リストからクラスタを選択します。

  3. ナビゲーション メニューで [AlloyDB Studio] をクリックします。

  4. IAM 認証を使用して Studio にログインします。

  5. [エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。

  6. [コンテキスト セットを作成] をクリックします。

  7. [コンテキスト セット名] に、一意のコンテキスト セット名を入力します。コンテキスト セット名では大文字と小文字が区別され、英字、数字、ハイフン、アンダースコアを使用できます。

  8. 省略可。[コンテキスト セットの説明] に、コンテキスト セットの説明を追加します。

  9. [作成] をクリックします。

コンテキスト セットを構築する

コンテキスト セットを作成したら、Gemini CLI を使用してコンテキストを構築するの手順に沿って、コンテキスト セット ファイルを作成します。その後、コンテキスト セットを編集してコンテキスト セット ファイルをアップロードできます。

コンテキスト セットを編集する

コンテキスト セットを編集する手順は次のとおりです。

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

    AlloyDB に移動する

  2. リストからクラスタを選択します。

  3. ナビゲーション メニューで [AlloyDB Studio] をクリックします。

  4. Identity and Access Management 認証を使用して Studio にログインします。

  5. [エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。

  6. [コンテキスト セットを編集] をクリックします。

  7. 省略可: [コンテキスト セットの説明] を編集します。

  8. [コンテキスト セット ファイルのアップロード] セクションで [参照] をクリックし、コンテキスト セット ファイルを選択します。

  9. [保存] をクリックします。

コンテキスト セットを削除する

コンテキスト セットを削除するには、次の操作を行います。

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

    AlloyDB に移動する

  2. リストからクラスタを選択します。

  3. ナビゲーション メニューで [AlloyDB Studio] をクリックします。

  4. Identity and Access Management 認証を使用して Studio にログインします。

  5. [エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。

  6. [コンテキスト セットを削除] をクリックします。

  7. [コンテキスト セットを削除しますか？] 確認ダイアログで、コンテキスト セットの名前を入力します。

  8. [確認] をクリックして、コンテキスト セットを削除します。

次のステップ