このドキュメントでは、エージェント コンテキスト ファイルを使用して AlloyDB for PostgreSQL Studio でデータ エージェントを作成する方法について説明します。データ エージェントは、単一のエージェント コンテキスト ファイルに関連付けられます。
データ エージェントについては、データ エージェントの概要をご覧ください。始める前に
エージェントを作成する前に、次の前提条件を満たしてください。
必要なサービスを有効にする
プロジェクトで次のサービスを有効にします。
AlloyDB for PostgreSQL クラスタとインスタンスを準備する
- 既存の AlloyDB クラスタとインスタンスにアクセスできることを確認するか、新しいクラスタとインスタンスを作成します。
- エンドユーザーがアクセスするデータとスキーマをデータベースに入力します。
必要なロールと権限
- Identity and Access Management（IAM）ユーザーまたはサービス アカウントをデータベース レベルでクラスタに追加します。詳細については、データベース ユーザーを管理するをご覧ください。
- プロジェクト レベルで IAM ユーザーに
alloydb.databaseUserロールを付与します。詳細については、プロジェクトの IAM ポリシー バインディングを追加するをご覧ください。
データ エージェントを作成する
データ エージェントを作成する手順は次のとおりです。
Google Cloud コンソールで、AlloyDB ページに移動します。
リストからクラスタを選択します。
ナビゲーション メニューで [AlloyDB Studio] をクリックします。
Identity and Access Management（IAM）認証を使用して Studio にログインします。
[エクスプローラ] ペインで、[データ エージェント] の横にある [アクションを表示] をクリックします。
[Create Agent（エージェントを作成）] をクリックします。
[エージェント名] に、一意のエージェント名を入力します。エージェント名では大文字と小文字が区別され、英字、数字、ハイフン、アンダースコアを使用できます。
省略可。[エージェントの説明] に、エージェントの説明を追加します。
省略可。[詳細オプションを表示] をクリックし、[ロケーションを選択] でエージェント コンテキストを保存するリージョンを選択します。
[作成] をクリックします。
エージェント コンテキストを構築する
エージェントを作成したら、Gemini CLI を使用してコンテキストをビルドするの手順に沿って、エージェント コンテキスト ファイルを作成します。その後、エージェントを編集してコンテキスト ファイルをアップロードできます。
エージェントを編集する
データ エージェントを編集する手順は次のとおりです。
Google Cloud コンソールで、AlloyDB ページに移動します。
リストからクラスタを選択します。
ナビゲーション メニューで [AlloyDB Studio] をクリックします。
Identity and Access Management（IAM）認証を使用して Studio にログインします。
[エクスプローラ] ペインで、[データ エージェント] の横にある [アクションを表示] をクリックします。
[エージェントを編集] をクリックします。
省略可: [エージェントの説明] を編集します。
[エージェント コンテキスト ファイルをアップロード] セクションで [参照] をクリックし、エージェント コンテキスト ファイルを選択します。
[保存] をクリックします。
データ エージェントを削除する
データ エージェントを削除するには、次の操作を行います。
Google Cloud コンソールで、AlloyDB ページに移動します。
リストからクラスタを選択します。
ナビゲーション メニューで [AlloyDB Studio] をクリックします。
Identity and Access Management（IAM）認証を使用して Studio にログインします。
[エクスプローラ] ペインで、[データ エージェント] の横にある [アクションを表示] をクリックします。
[エージェントを削除] をクリックします。
[エージェントの削除] 確認ダイアログで、エージェントの名前を入力します。
[確認] をクリックして、エージェントを削除します。
次のステップ
- データ エージェントの詳細を確認する。
- データ エージェントを検査して呼び出す方法を確認する。