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

​
前提条件

GCPツールキットを設定する前に、有効なGoogle Cloud接続が必要です。まだ設定していない場合は、Settings → Connectionsから作成してください。
接続はSettings → Connectionsで一元的に管理されます。サービスアカウントJSONは暗号化されて保存され、client_emailとプロジェクトのみがエージェントに公開されます。

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

  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 TablesBigQueryデータセットのテーブルを一覧表示します。
Get Table Schemaカラム名、型、説明、およびテーブルメタデータを取得します。
Run Queryドライラン、パラメータ、行制限オプション付きでBigQueryに対してSQLクエリを実行します。
Insert RowsストリーミングINSERT APIを使用してBigQueryテーブルに行をストリーミング挿入します。

​
Cloud Run

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

​
Cloud SQL

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

​
汎用

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

​
設定の保存

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