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

プレビュー

この機能は サービス固有の規約の「一般サービス規約」セクションの「一般提供前サービス規約」と、 生成 AI プレビュー版プロダクトに関する追加規約の対象となります。pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。 詳細については、 リリースステージの説明をご覧ください。

このリリースへのアクセスについては、 アクセス リクエスト ページをご覧ください。

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

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

始める前に

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

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

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

• Data Analytics API with Gemini
• Gemini for Google Cloud API
• Knowledge Catalog API

Cloud SQL インスタンスを準備する

既存の Cloud SQL インスタンスにアクセスできることを確認するか、新しいインスタンスを作成します。 詳細については、Cloud SQL のインスタンスを作成する をご覧ください。

このチュートリアルでは、Cloud SQL インスタンスにデータベースが必要です。詳細については、Cloud SQL インスタンスでデータベースを作成するをご覧ください。

必要なロールと権限

• IAM ユーザーまたはサービス アカウントをインスタンスに追加します。詳細については、Cloud SQL の IAM データベース認証でユーザーを管理するをご覧ください。
• プロジェクト レベルで IAM ユーザーに cloudsql.studioUser ロール、cloudsql.instanceUser ロール、geminidataanalytics.queryDataUser ロールを付与します。詳細については、プロジェクトの IAM ポリシー バインディングを追加する をご覧ください。
• また、postgres ユーザーなどのスーパーユーザー権限を持つユーザーとしてログインして、IAM ユーザーまたはサービス アカウントに読み取り専用のデータベース権限を付与する必要があります。
  
  GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;
  
  USER_NAME は、ユーザーのメールアドレスに置き換えます。メールアドレスには特殊文字（@ と .）が含まれているため、引用符で囲む必要があります。
  
  詳細については、個々の IAM ユーザーまたはサービス アカウントにデータベース権限を付与するをご覧ください。

Cloud SQL インスタンスに executesql 権限を付与する

Cloud SQL インスタンスに executesql 権限を付与し、Cloud SQL Data API を有効にするには、次のコマンドを実行します。

gcloud config set project PROJECT_ID
gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

次のように置き換えます。

• PROJECT_ID: 実際の Google Cloud プロジェクト ID。
• INSTANCE_ID: Cloud SQL インスタンスの ID。

このチュートリアルの手順を行うには、Google Cloud にログインし、IAM 認証を使用してデータベースを認証します。

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

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

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

   Cloud SQL に移動

2. リストからインスタンスを選択します。

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

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

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

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

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

8. 省略可。In [Context set description], add a description for your context set.

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

注: プロジェクトで最初のコンテキスト セットを作成するには、数分かかることがあります。

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

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

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

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

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

   Cloud SQL に移動

2. リストからインスタンスを選択します。

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

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

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

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

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

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

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

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

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

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

   Cloud SQL に移動

2. リストからインスタンスを選択します。

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

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

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

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

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

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

注: データベースを削除する前に、そのデータベースに関連付けられているすべてのコンテキスト セットを削除する必要があります。

次のステップ

• コンテキスト セットの詳細を確認する。
• コンテキスト セットをテストする方法を確認する。
• Gemini CLI を使用してコンテキストを構築する方法を確認する。