メインコンテンツへスキップ
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 ViewerCloud Run InvokerCloud SQL Client)。
  • Cloud Run / Cloud Functionsの呼び出しでは、サービスアカウントによって署名されたOIDC IDトークンが使用されます。サービスがプライベートである場合は、roles/run.Invokerをサービスアカウントに制限してください。
  • 以下で有効にしたツールのみがエージェントに利用可能になります。

ツールの選択

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

BigQuery

Cloud Run

Cloud SQL

汎用

設定の保存

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