Cloud SQL for PostgreSQL Studio でデータエージェントを管理する

MySQL | PostgreSQL | SQL Server

このドキュメントでは、エージェントコンテキストファイルを使用して Cloud SQL for PostgreSQL Studio でデータエージェントを作成する方法について説明します。データエージェントは、単一のエージェントコンテキストファイルに関連付けられます。

データエージェントについては、データエージェントの概要をご覧ください。

始める前に

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

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

既存の Cloud SQL インスタンスにアクセスできることを確認するか、新しいインスタンスを作成します。詳細については、Cloud SQL のインスタンスを作成するをご覧ください。
エンドユーザーがアクセスするデータとスキーマをデータベースに入力します。

IAM ユーザーまたはサービスアカウントをインスタンスに追加します。詳細については、Cloud SQL の IAM データベース認証でユーザーを管理するをご覧ください。
プロジェクトレベルで IAM ユーザーに cloudsql.studioUser ロールと cloudsql.instanceUser ロールを付与します。詳細については、プロジェクトの IAM ポリシーバインディングを追加するをご覧ください。

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

gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

INSTANCE_ID は、Cloud SQL インスタンス ID に置き換えます。

データエージェントを作成する手順は次のとおりです。

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

Cloud SQL に移動
リストからインスタンスを選択します。
ナビゲーションメニューで [Cloud SQL Studio] をクリックします。
Identity and Access Management（IAM）認証を使用して Studio にログインします。
[エクスプローラ] ペインで、[データエージェント] の横にある [アクションを表示] をクリックします。
[エージェントを作成] をクリックします。
[エージェント名] に、一意のエージェント名を入力します。エージェント名では大文字と小文字が区別され、英字、数字、ハイフン、アンダースコアを使用できます。
省略可。[エージェントの説明] に、エージェントの説明を追加します。
省略可。[詳細設定を表示] をクリックし、[ロケーションを選択] でエージェントコンテキストを保存するリージョンを選択します。
[作成] をクリックします。

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

データエージェントを編集する手順は次のとおりです。

データエージェントを削除する手順は次のとおりです。