AlloyDB Studio でデータエージェントを管理する

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

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

始める前に

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

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

既存の AlloyDB クラスタとインスタンスにアクセスできることを確認するか、新しいクラスタとインスタンスを作成します。

データベースレベルで Identity and Access Management（IAM）ユーザーまたはサービスアカウントをクラスタに追加します。詳細については、データベースユーザーを管理するをご覧ください。
プロジェクトレベルで IAM ユーザーに alloydb.databaseUser ロールと serviceusage.serviceUsageConsumer 権限を付与します。詳細については、プロジェクトの IAM ポリシーバインディングを追加するをご覧ください。

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

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

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

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

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

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

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