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

# Conexão com Google Cloud Platform

> Conecte uma conta de serviço do GCP para acesso ao BigQuery, Cloud Run e Cloud SQL.

A conexão com **Google Cloud Platform** permite que seus agents se autentiquem com serviços do GCP usando uma chave JSON de conta de serviço. Uma vez conectados, os agents podem acessar BigQuery, Cloud Run e Cloud SQL com base nas funções IAM concedidas à conta de serviço.

## Adicionando uma Conexão GCP

1. Vá para **Configurações → Conexões** no menu de navegação à esquerda.
2. Em **Plataformas em Nuvem**, clique no cartão **Google Cloud Platform**.
3. Clique em **+ Adicionar Conexão GCP**.
4. Preencha o formulário e clique em **Adicionar Conexão**.

## Formulário de Conexão

| Campo                        | Obrigatório | Descrição                                                                                                                          |
| ---------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Rótulo da Conexão**        | Sim         | Um nome de exibição para esta conexão (por exemplo, `GCP Produção`).                                                               |
| **JSON da Conta de Serviço** | Sim         | Cole o conteúdo da sua chave JSON de conta de serviço, ou clique em **Fazer upload de arquivo .json** para carregá-la diretamente. |
| **ID do Projeto GCP**        | Não         | O ID do projeto GCP. O padrão é o `project_id` na JSON da conta de serviço se deixado em branco.                                   |
| **Região Padrão**            | Não         | A região padrão para operações do Cloud Run e Cloud SQL (por exemplo, `us-central1`).                                              |
| **Localização do BigQuery**  | Não         | A localização do dataset/job do BigQuery (por exemplo, `US`, `EU`).                                                                |

<Note>
  As credenciais são testadas contra o Google IAM antes de salvar, e a chave é armazenada criptografada na tabela de integrações. Apenas o `client_email` e o projeto são expostos aos agents.
</Note>

## Como Obter uma Chave JSON de Conta de Serviço

1. Abra o [Google Cloud Console → Contas de Serviço](https://console.cloud.google.com/iam-admin/serviceaccounts).
2. Escolha ou crie uma conta de serviço e conceda as funções necessárias (por exemplo, `BigQuery Data Viewer`, `Cloud Run Invoker`, `Cloud SQL Client`).
3. Abra a aba **Chaves** → **Adicionar chave** → **Criar nova chave** → selecione **JSON**.
4. Cole o JSON baixado no campo **JSON da Conta de Serviço**, ou faça upload do arquivo diretamente.

## Gerenciando Conexões

Para visualizar, editar ou remover conexões GCP existentes, vá para **Configurações → Conexões** e clique no cartão **Google Cloud Platform**. De lá, você pode adicionar conexões adicionais ou excluir as que não são mais necessárias.

<Info>
  Para usar uma conexão GCP com um agent, vá até as **Toolkits** do agent, adicione o toolkit **Google Cloud Platform** e selecione a conexão no menu suspenso **Selecionar Conexão GCP**. Para mais detalhes, consulte [Toolkit Google Cloud Platform](/gcp-toolkit).
</Info>