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.
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.
- Abra seu agente e vá até Toolkits.
- Encontre Google Cloud Platform e clique em Add to Agent.
- 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.
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. 
