Gemini CLI を使用してコンテキストを作成する

MySQL | PostgreSQL | SQL Server

このドキュメントでは、Gemini CLI と MCP ツールボックスを使用してエージェントコンテキストファイルを作成する方法を説明します。自然言語から SQL クエリを生成する際に、これらのファイルに含まれるテンプレートとファセットによってコンテキストを提供します。さらに、DB コンテキスト拡充 MCP サーバーも使用します。

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

エージェントコンテキストを構築する大まかな手順は次のとおりです。

環境を準備する
ターゲットを絞ったテンプレートを生成する
ターゲットを絞ったファセットを生成する
省略可。バルクテンプレートを生成する

始める前に

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

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

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

必要なロールと権限

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

個々の IAM ユーザーまたはサービスアカウントにデータベース権限を付与する

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

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 に置き換えます。

環境を準備する

エージェントコンテキストファイルは、任意のローカル開発環境または IDE から作成できます。環境を準備する手順は次のとおりです。

Gemini CLI をインストールする
MCP ツールボックスをインストールして設定する
DB コンテキスト拡充 MCP サーバーをインストールして設定する

Gemini CLI をインストールする

Gemini CLI をインストールするには、Gemini CLI の使用を開始するをご覧ください。Gemini CLI は、必ず別個のディレクトリにインストールしてください。そのディレクトリを、MCP ツールボックスと DB コンテキスト拡充 MCP サーバーのインストールにも使用します。

MCP ツールボックスをインストールして設定する

Gemini CLI をインストールしたディレクトリに、MCP ツールボックス Gemini CLI 拡張機能をインストールします。
```
gemini extensions install https://github.com/gemini-cli-extensions/mcp-toolbox
```
MCP ツールボックスをインストールしたディレクトリ内に tools.yaml 構成ファイルを作成して、データベース接続を構成します。
```
  sources:
    my-cloud-sql-pg-source:
      kind: cloud-sql-postgres
      project: PROJECT_ID
      region: REGION_ID
      instance: INSTANCE_ID
      database: DATABASE_ID
      user: USER_NAME
      password: PASSWORD
```
次のように置き換えます。
- PROJECT_ID: 実際の Google Cloud プロジェクト ID。
- REGION_ID: Cloud SQL インスタンスのリージョン（us-central1 など）。
- INSTANCE_ID: Cloud SQL インスタンスの ID。
- DATABASE_ID: 接続先のデータベースの名前。
- USER_NAME: データベースユーザー。この値を設定する方法の詳細については、MCP ツールボックス内のソースをご覧ください。
- PASSWORD: データベースユーザー用のパスワード。この値を設定する方法の詳細については、MCP ツールボックス内のソースをご覧ください。
tools.yaml ファイルが正しく構成されていることを確認します。
```
./toolbox --tools-file "tools.yaml"
```

DB コンテキスト拡充 MCP サーバーをインストールする

DB コンテキスト拡充 MCP サーバーは、データベーススキーマから構造化された NL2SQL テンプレートを生成するためのインタラクティブなガイド付きワークフローを提供します。このサーバーはデータベース接続に MCP ツールボックス拡張機能を使用します。DB コンテキスト拡充 MCP サーバーをインストールする方法の詳細については、DB コンテキスト拡充 MCP サーバーをご覧ください。

DB コンテキスト拡充 MCP サーバーをインストールする手順は次のとおりです。

Gemini CLI をインストールしたディレクトリに、uv Python パッケージインストーラをインストールします。
```
  pip install --user pipx
  pipx ensurepath
  pipx install uv
```

DB コンテキスト拡充 MCP サーバーをインストールします。

gemini extensions install https://github.com/GoogleCloudPlatform/db-context-enrichment

このサーバーは生成に対応するために Gemini API を使用します。したがって、API キーを環境変数としてエクスポートする必要があります。API キーを確認する方法の詳細については、Gemini API キーを使用するをご覧ください。

Gemini API キーをエクスポートするには、次のコマンドを実行します。

export GEMINI_API_KEY="YOUR_API_KEY"

YOUR_API_KEY は、実際の Gemini API キーに置き換えます。

ターゲットを絞ったテンプレートを生成する

特定のクエリのペアをクエリテンプレートとしてエージェントコンテキストに追加するには、/generate_targeted_templates コマンドを使用します。テンプレートの詳細については、データエージェントの概要をご覧ください。

クエリテンプレートをエージェントコンテキストに追加する手順は次のとおりです。

Gemini CLI をインストールしたディレクトリ内で Gemini を起動します。
```
gemini
```
Gemini CLI 認証を設定します。
MCP ツールボックスとデータベース拡充拡張機能が使用可能な状態であることを確認します。
```
/mcp list
```
/generate_targeted_templates コマンドを実行します。
```
/generate_targeted_templates
```
クエリテンプレートに追加する、自然言語によるクエリを入力します。
対応する SQL クエリをクエリテンプレートに入力します。
生成されたクエリテンプレートを確認します。クエリテンプレートは、エージェントコンテキストファイルとして保存することも、既存のコンテキストファイルに追加することもできます。

my-cluster-psc-primary_postgres_templates_20251104111122.json と同様のエージェントコンテキストファイルが、コマンドを実行したディレクトリに保存されます。

コンテキストファイルとクエリテンプレートの詳細については、エージェントコンテキストをご覧ください。

特定のクエリのペアをファセットとしてエージェントコンテキストファイルに追加するには、/generate_targeted_fragments コマンドを使用します。ファセットの詳細については、データエージェントの概要をご覧ください。

ファセットをエージェントコンテキストに追加する手順は次のとおりです。

/generate_targeted_fragments コマンドを実行します。
```
/generate_targeted_fragments
```
クエリテンプレートに追加する、自然言語によるクエリを入力します。
対応する SQL クエリをクエリテンプレートに入力します。
生成されたファセットを確認します。ファセットは、エージェントコンテキストファイルとして保存することも、既存のコンテキストファイルに追加することもできます。

my-cluster-psc-primary_postgres_templates_20251104111122.json と同様のエージェントコンテキストファイルが、コマンドを実行したディレクトリに保存されます。

コンテキストファイルとファセットの詳細については、エージェントコンテキストをご覧ください。

省略可: バルクテンプレートを生成する

データベーススキーマとデータに基づいてエージェントコンテキストファイルを自動生成するには、/generate_bulk_templates コマンドを使用します。

バルクテンプレートを自動生成する手順は次のとおりです。

/generate_bulk_templates コマンドを実行します。
```
/generate_bulk_templates
```
データベーススキーマに基づくテンプレートベースの SQL 生成が行われる際は、データベース情報の確認とデータベーススキーマへのアクセス権限の付与に関連する一連の質問が表示されます。
生成されたクエリテンプレートを確認します。テンプレートを承認することも、修正の必要があるクエリのペアを更新することもできます。
クエリテンプレートに追加する、自然言語によるクエリを入力します。
対応する SQL クエリをクエリテンプレートに入力します。
生成されたクエリテンプレートを確認します。クエリテンプレートは、エージェントコンテキストファイルとして保存することも、既存のコンテキストファイルに追加することもできます。
クエリテンプレートを承認したら、新しいテンプレートファイルを作成するか、クエリのペアを既存のテンプレートファイルに追加します。クエリテンプレートは、ローカルディレクトリに JSON ファイルとして保存されます。

my-cluster-psc-primary_postgres_templates_20251104111122.json と同様のエージェントコンテキストファイルが、コマンドを実行したディレクトリに保存されます。

エージェントコンテキストファイルの詳細については、エージェントコンテキストをご覧ください。

次のステップ

データエージェントの詳細を確認する。
Cloud SQL Studio でデータエージェントを作成または削除する方法を確認する。
データエージェントを検査して呼び出す方法を確認する。

Gemini CLI を使用してコンテキストを作成する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

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

必要なロールと権限

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

環境を準備する

Gemini CLI をインストールする

MCP ツールボックスをインストールして設定する

DB コンテキスト拡充 MCP サーバーをインストールする

ターゲットを絞ったテンプレートを生成する

ターゲットを絞ったファセットを生成する

省略可: バルク テンプレートを生成する

次のステップ

Gemini CLI を使用してコンテキストを作成する

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

省略可: バルクテンプレートを生成する