Toolkit de Google Cloud Platform
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
- Abra su agente y vaya a Toolkits.
- Encuentre Google Cloud Platform y haga clic en Agregar al Agente.
- 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.Invokera 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
| Herramienta | Descripción |
|---|---|
| Listar Conjuntos de Datos | Enumera los conjuntos de datos de BigQuery accesibles para la cuenta de servicio conectada. |
| Listar Tablas | Enumera las tablas en un conjunto de datos de BigQuery. |
| Obtener Esquema de Tabla | Inspecciona nombres de columnas, tipos, descripciones y metadatos de la tabla. |
| Ejecutar Consulta | Ejecuta una consulta SQL contra BigQuery con ejecución de prueba opcional, parámetros y límite de filas. |
| Insertar Filas | Inserta filas por streaming en una tabla de BigQuery usando la API de inserción por streaming. |
Cloud Run
| Herramienta | Descripción |
|---|---|
| Listar Servicios | Enumera los servicios Cloud Run (Gen 2) en una región. |
| Obtener Servicio | Obtiene la definición de un servicio Cloud Run incluyendo su URL e imagen. |
| Invocar Servicio | Invoca un endpoint HTTP de un servicio Cloud Run con un token OIDC ID firmado por la cuenta de servicio. |
| Invocar Función | Invoca una función activada por HTTP de Cloud Run / Cloud Functions Gen 2 con un token OIDC ID. |
Cloud SQL
| Herramienta | Descripción |
|---|---|
| Listar Instancias | Enumera las instancias de Cloud SQL (Postgres, MySQL, SQL Server) en un proyecto. |
| Obtener Instancia | Obtiene metadatos de una instancia de Cloud SQL específica (motor, IPs, versión). |
| Ejecutar Consulta | Ejecuta una consulta SQL contra una instancia de Cloud SQL a través del conector Python. |
Genérico
| Herramienta | Descripción |
|---|---|
| Llamada API Personalizada | Realiza una solicitud autenticada a cualquier API REST de Google Cloud. Use esto cuando no exista una herramienta dedicada para la operación que necesita. |
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.