> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Cloud Platform ツールキット

> サービスアカウント接続を使用してエージェントをBigQuery、Cloud Run、Cloud SQLに接続します。

**Google Cloud Platform（GCP）ツールキット**により、エージェントはBigQuery、Cloud Run（サービスおよびHTTPトリガー関数）、Cloud SQLと対話できるようになります。認証は接続として保存されたサービスアカウントJSONキーによって処理されます。エージェントはサービスアカウントとして機能し、そのIAMロールを継承します。

## 前提条件

GCPツールキットを設定する前に、有効なGoogle Cloud接続が必要です。まだ設定していない場合は、**Settings → Connections**から作成してください。

<Info>
  接続はSettings → Connectionsで一元的に管理されます。サービスアカウントJSONは暗号化されて保存され、`client_email`とプロジェクトのみがエージェントに公開されます。
</Info>

## エージェントにツールキットを追加する

1. エージェントを開き、**Toolkits**に移動します。
2. **Google Cloud Platform**を見つけて、**Add to Agent**をクリックします。
3. **Configure**をクリックして設定パネルを開きます。

## 設定

### 接続

**Select GCP Connection**ドロップダウンを使用して、エージェントが使用するサービスアカウント接続を選択します。接続を管理または作成するには、右上の**Manage Connections**をクリックします。

### Google Cloud統合について

ツールキットを設定する際に、以下の点に注意してください。

* エージェントはサービスアカウントのIAMロールを継承します。必要なロールのみを付与してください（例：`BigQuery Data Viewer`、`Cloud Run Invoker`、`Cloud SQL Client`）。
* Cloud Run / Cloud Functionsの呼び出しでは、サービスアカウントによって署名されたOIDC IDトークンが使用されます。サービスがプライベートである場合は、`roles/run.Invoker`をサービスアカウントに制限してください。
* 以下で有効にしたツールのみがエージェントに利用可能になります。

## ツールの選択

**Select All**または**Deselect All**を使用してツールを一括管理し、または個別に有効にできます。各ツールの**Require Confirmation**を切り替えて、エージェントがそのアクションを実行する前にユーザーに確認を求めることもできます。

4つのカテゴリに分類された13のツールが利用可能です。

### BigQuery

| ツール                  | 説明                                                 |
| -------------------- | -------------------------------------------------- |
| **List Datasets**    | 接続されたサービスアカウントがアクセスできるBigQueryデータセットを一覧表示します。      |
| **List Tables**      | BigQueryデータセットのテーブルを一覧表示します。                       |
| **Get Table Schema** | カラム名、型、説明、およびテーブルメタデータを取得します。                      |
| **Run Query**        | ドライラン、パラメータ、行制限オプション付きでBigQueryに対してSQLクエリを実行します。   |
| **Insert Rows**      | ストリーミングINSERT APIを使用してBigQueryテーブルに行をストリーミング挿入します。 |

### Cloud Run

| ツール                 | 説明                                                                    |
| ------------------- | --------------------------------------------------------------------- |
| **List Services**   | リージョン内のCloud Runサービス（Gen 2）を一覧表示します。                                  |
| **Get Service**     | URLとイメージを含むCloud Runサービスの定義を取得します。                                    |
| **Invoke Service**  | サービスアカウントによって署名されたOIDC IDトークンを使用して、Cloud RunサービスのHTTPエンドポイントを呼び出します。  |
| **Invoke Function** | OIDC IDトークンを使用して、HTTPトリガーのCloud Run / Cloud Functions Gen 2関数を呼び出します。 |

### Cloud SQL

| ツール                | 説明                                                          |
| ------------------ | ----------------------------------------------------------- |
| **List Instances** | プロジェクト内のCloud SQLインスタンス（Postgres、MySQL、SQL Server）を一覧表示します。 |
| **Get Instance**   | 特定のCloud SQLインスタンスのメタデータ（エンジン、IPアドレス、バージョン）を取得します。          |
| **Execute Query**  | Pythonコネクタを使用してCloud SQLインスタンスに対してSQLクエリを実行します。             |

### 汎用

| ツール                 | 説明                                                              |
| ------------------- | --------------------------------------------------------------- |
| **Custom API Call** | 任意のGoogle Cloud REST APIに認証付きリクエストを行います。必要な操作に専用ツールがない場合に使用します。 |

## 設定の保存

**Save**をクリックして設定を適用し、**Set as Default**をクリックしてこの設定を新しいエージェントのデフォルトにします。ツールキットをエージェントから完全に削除するには、**Remove Toolkit**をクリックします。