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