Saltar al contenido principal
El Toolkit de Google Cloud Platform (GCP) le permite a su agente interactuar con BigQuery, Cloud Run (servicios y funciones activadas por HTTP) y Cloud SQL. La autenticación se maneja a través de una clave JSON de cuenta de servicio almacenada como una conexión — el agente actúa como la cuenta de servicio y hereda sus roles IAM.

Prerrequisitos

Antes de configurar el Toolkit GCP, necesita una conexión de Google Cloud activa. Si aún no ha configurado una, vaya a Configuración → Conexiones para crear una.
Las conexiones se gestionan centralizadamente en Configuración → Conexiones. La clave JSON de la cuenta de servicio se almacena encriptada; solo el client_email y el proyecto se muestran a los agentes.

Agregar el Toolkit a un Agente

  1. Abra su agente y vaya a Toolkits.
  2. Encuentre Google Cloud Platform y haga clic en Agregar al Agente.
  3. Haga clic en Configurar para abrir el panel de configuración.

Configuración

Conexión

Use el menú desplegable Seleccionar Conexión GCP para elegir la conexión de cuenta de servicio que el agente usará. Para gestionar o crear conexiones, haga clic en Gestionar Conexiones en la esquina superior derecha.

Sobre la Integración de Google Cloud

Tenga en cuenta lo siguiente al configurar el toolkit:
  • El agente hereda los roles IAM de la cuenta de servicio — otorgue solo los roles requeridos (por ejemplo, BigQuery Data Viewer, Cloud Run Invoker, Cloud SQL Client).
  • La invocación de Cloud Run / Cloud Functions usa tokens OIDC ID firmados por la cuenta de servicio; restrinja roles/run.Invoker a la cuenta de servicio cuando los servicios sean privados.
  • Solo las herramientas que habilite a continuación estarán disponibles para el agente.

Selección de Herramientas

Use Seleccionar Todo o Desseleccionar Todo para gestionar herramientas de forma masiva, o habilítelas individualmente. También puede activar Requerir Confirmación por herramienta para solicitar al usuario antes de que el agente ejecute esa acción. Hay 13 herramientas disponibles en cuatro categorías.

BigQuery

Cloud Run

Cloud SQL

Genérico

Guardar la Configuración

Haga clic en Guardar para aplicar su configuración, o en Establecer como Predeterminado para hacer que esta configuración sea la predeterminada para nuevos agentes. Para eliminar completamente el toolkit del agente, haga clic en Eliminar Toolkit.