Skip to main content
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.

​
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

​
Cloud Run

​
Cloud SQL

​
Genérico

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