> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Toolkit de Google Cloud Platform

> Conecte su agente a BigQuery, Cloud Run y Cloud SQL usando una conexión de cuenta de servicio.

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.

<Info>
  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.
</Info>

## 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

| 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**.