> ## 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 Google Cloud Platform

> Conecte seu agente ao BigQuery, Cloud Run e Cloud SQL usando uma conexão de conta de serviço.

O **Toolkit Google Cloud Platform (GCP)** permite que seu agente interaja com BigQuery, Cloud Run (serviços e funções acionadas por HTTP) e Cloud SQL. A autenticação é tratada via uma chave JSON de conta de serviço armazenada como uma conexão — o agente atua como a conta de serviço e herda suas funções IAM.

## Pré-requisitos

Antes de configurar o Toolkit GCP, você precisa de uma conexão ativa com o Google Cloud. Se ainda não configurou uma, vá até **Configurações → Conexões** para criar uma.

<Info>
  As conexões são gerenciadas centralmente em Configurações → Conexões. A JSON da conta de serviço é armazenada de forma criptografada; apenas o `client_email` e o projeto são expostos aos agentes.
</Info>

## Adicionando o Toolkit a um Agente

1. Abra seu agente e vá até **Toolkits**.
2. Encontre **Google Cloud Platform** e clique em **Add to Agent**.
3. Clique em **Configure** para abrir o painel de configuração.

## Configuração

### Conexão

Use o dropdown **Select GCP Connection** para escolher a conexão de conta de serviço que o agente usará. Para gerenciar ou criar conexões, clique em **Manage Connections** no canto superior direito.

### Sobre a Integração com Google Cloud

Leve em consideração ao configurar o toolkit:

* O agente herda as funções IAM da conta de serviço — conceda apenas as funções necessárias (por exemplo, `BigQuery Data Viewer`, `Cloud Run Invoker`, `Cloud SQL Client`).
* A invocação do Cloud Run / Cloud Functions usa tokens de ID OIDC assinados pela conta de serviço; restrinja `roles/run.Invoker` à conta de serviço quando os serviços forem privados.
* Apenas as ferramentas que você habilitar abaixo estarão disponíveis para o agente.

## Selecionar Ferramentas

Use **Select All** ou **Deselect All** para gerenciar ferramentas em massa, ou habilite-as individualmente. Você também pode alternar **Require Confirmation** por ferramenta para solicitar ao usuário antes que o agente execute essa ação.

Há 13 ferramentas disponíveis em quatro categorias.

### BigQuery

| Ferramenta           | Descrição                                                                                           |
| -------------------- | --------------------------------------------------------------------------------------------------- |
| **List Datasets**    | Lista os datasets do BigQuery acessíveis pela conta de serviço conectada.                           |
| **List Tables**      | Lista as tabelas em um dataset do BigQuery.                                                         |
| **Get Table Schema** | Inspeciona nomes de colunas, tipos, descrições e metadados da tabela.                               |
| **Run Query**        | Executa uma consulta SQL no BigQuery com execução simulada opcional, parâmetros e limite de linhas. |
| **Insert Rows**      | Insere linhas em streaming em uma tabela do BigQuery usando a API de inserção em streaming.         |

### Cloud Run

| Ferramenta          | Descrição                                                                                               |
| ------------------- | ------------------------------------------------------------------------------------------------------- |
| **List Services**   | Lista os serviços Cloud Run (Gen 2) em uma região.                                                      |
| **Get Service**     | Obtém a definição de um serviço Cloud Run, incluindo sua URL e imagem.                                  |
| **Invoke Service**  | Invoca um endpoint HTTP de um serviço Cloud Run com um token de ID OIDC assinado pela conta de serviço. |
| **Invoke Function** | Invoca uma função Cloud Run / Cloud Functions Gen 2 acionada por HTTP com um token de ID OIDC.          |

### Cloud SQL

| Ferramenta         | Descrição                                                                   |
| ------------------ | --------------------------------------------------------------------------- |
| **List Instances** | Lista as instâncias Cloud SQL (Postgres, MySQL, SQL Server) em um projeto.  |
| **Get Instance**   | Obtém metadados de uma instância Cloud SQL específica (motor, IPs, versão). |
| **Execute Query**  | Executa uma consulta SQL em uma instância Cloud SQL via o conector Python.  |

### Genérico

| Ferramenta          | Descrição                                                                                                                                                    |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Custom API Call** | Faz uma requisição autenticada para qualquer API REST do Google Cloud. Use isso quando não existir uma ferramenta dedicada para a operação que você precisa. |

## Salvando Sua Configuração

Clique em **Save** para aplicar sua configuração, ou em **Set as Default** para tornar esta configuração o padrão para novos agentes. Para remover completamente o toolkit do agente, clique em **Remove Toolkit**.