メインコンテンツへスキップ
Google Cloud Platform 接続により、エージェントはサービス アカウント JSON キーを使用して GCP サービスで認証できるようになります。接続すると、エージェントはサービス アカウントに付与された IAM ロールに基づいて BigQuery、Cloud Run、Cloud SQL にアクセスできるようになります。

​
GCP 接続の追加

  1. 左側のナビゲーション メニューで [設定] → [接続] に移動します。
  2. [クラウド プラットフォーム] で、[Google Cloud Platform] カードをクリックします。
  3. [+ GCP 接続の追加] をクリックします。
  4. フォームに入力し、接続の追加 をクリックします。

​
接続フォーム

| Field | Required | Description PLACEHOLDER_13 Connection Label | Yes | A display name for this connection (e.g. PLACEHOLDER_0). PLACEHOLDER_14 Service-account JSON | Yes | Paste the contents of your service-account JSON key, or click Upload .json file to upload it directly. PLACEHOLDER_15 GCP Project ID | No | The GCP project ID. Defaults to the PLACEHOLDER_1 in the service-account JSON if left blank. PLACEHOLDER_16 Default Region | No | The default region for Cloud Run and Cloud SQL operations (e.g. PLACEHOLDER_2). PLACEHOLDER_17 BigQuery Location | No | The BigQuery dataset/job location (e.g. PLACEHOLDER_3, PLACEHOLDER_4). |
Credentials are tested against Google IAM before saving, and the key is stored encrypted in the integrations table. Only the PLACEHOLDER_5 and project are surfaced to agents.

​
サービスアカウントの JSON キーを取得する方法

  1. Google Cloud Console → Service Accounts を開きます。
  2. サービス アカウントを選択または作成し、必要なロールを付与します (例: BigQuery Data Viewer、Cloud Run Invoker、Cloud SQL Client)。
  3. [キー] タブを開き、→ キーの追加 → 新しいキーの作成 → JSON を選択します。
  4. ダウンロードした JSON を サービス アカウント JSON フィールドに貼り付けるか、ファイルを直接アップロードします。

​
接続の管理

既存の GCP 接続を表示、編集、削除するには、[設定] → [接続] に移動し、Google Cloud Platform カードをクリックします。そこから、接続を追加したり、不要になった接続を削除したりできます。
To use a GCP connection with an agent, go to the agent’s Toolkits, add the Google Cloud Platform toolkit, and select the connection from the Select GCP Connection dropdown. For more details, see Google Cloud Platform Toolkit.