Com o Google Cloud Data Agent Kit, você trabalha com seus recursos de dados Google Cloud no ambiente de programação com agentes ou IDE preferido. Dependendo da sua configuração, instale uma extensão ou um plug-in do ambiente de desenvolvimento integrado.
O Data Agent Kit vem pré-instalado com os seguintes serviços Google Cloud:
- Cloud Shell
- Cloud Workstations
Antes de começar
Antes de instalar o Data Agent Kit, faça o seguinte:
Configurar seu ambiente local
Na máquina local, instale o ambiente de desenvolvimento integrado ou o agente de programação e o Node.js de sua preferência.
- Instale e configure seu IDE, CLI de agente ou agente de programação. Se ele já estiver instalado, atualize para a versão mais recente.
- Instale o Node.js.
Configurar o Google Cloud
- Se você ainda não tiver um, crie um projeto do Google Cloud .
- Ative o faturamento.
Funções exigidas
O Data Agent Kit notifica você quando são necessárias mais permissões para realizar uma tarefa. Você só precisa de permissões para os serviços que usa. Para uma lista completa de permissões e APIs necessárias para cada serviço no Data Agent Kit, consulte Permissões.
Instalar a extensão ou o plug-in
O processo de instalação depende do IDE ou do agente de programação que você usa.
VS Code
Para usar o Data Agent Kit no VS Code, instale a extensão:
- No ambiente de desenvolvimento integrado, clique em Extensões ou pressione
Ctrl/Cmd+Shift+X. - Pesquisar por
Google Cloud Data Agent Kit. - Clique em Instalar.
- Se solicitado, reinicie o ambiente de desenvolvimento integrado. Depois que a extensão for instalada, o ícone do Google Cloud Data Agent Kit será adicionado à barra de atividades.
Também é possível instalar a extensão no Visual Studio Marketplace.
Antigravity
Clique para abrir as instruções da ferramenta Antigravidade que você está usando.
IDE do Antigravity
Para usar o Data Agent Kit no IDE do Antigravity, instale a extensão.
- No ambiente de desenvolvimento integrado, clique em Extensões ou pressione
Ctrl/Cmd+Shift+X. - Pesquisar por
Google Cloud Data Agent Kit. - Clique em Instalar.
- Se solicitado, reinicie o ambiente de desenvolvimento integrado. Depois que a extensão for instalada, o ícone do Google Cloud Data Agent Kit será adicionado à barra de atividades.
CLI do Antigravity
Para usar o Data Agent Kit com a CLI do Antigravity, instale o plug-in. No terminal, execute o seguinte comando:
agy plugin install https://github.com/GoogleCloudPlatform/data-agent-kit-plugin
Antigravity 2.0
Para usar o Data Agent Kit com a CLI do Antigravity, instale o plug-in.
- Clique em Configurações.
- No painel Configurações, clique em Personalizações.
- Localize Build with Google Plugins e clique em Personalizar.
- Localize o Google Cloud Data Agent Kit na lista e clique em Download.
Extensão Antigravity para VS Code
Para usar o Data Agent Kit no VS Code com a extensão Antigravity para VS Code, faça o seguinte:
- Na barra de status do VS Code, clique em Antigravity - Settings.
- No painel Configurações, clique em Personalizações.
- Localize Build with Google Plugins e clique em Personalizar.
- Localize o Google Cloud Data Agent Kit na lista e clique em Download.
CLI do Claude Code
Para usar o Data Agent Kit com a CLI do Claude Code, instale o plug-in. Execute o seguinte comando no terminal:
claude plugin install data-agent-kit-starter-pack@claude-plugins-official
CLI do Codex
Para usar o Data Agent Kit com a CLI do Codex, instale o plug-in. Execute os comandos a seguir no terminal:
codex plugin marketplace add GoogleCloudPlatform/data-agent-kit-plugin
codex plugin add dak@dak-marketplace
Cursor
Para usar o Data Agent Kit no Cursor, instale a extensão.
- No ambiente de desenvolvimento integrado, clique em Extensões ou pressione
Ctrl/Cmd+Shift+X. - Pesquisar por
Google Cloud Data Agent Kit. - Clique em Instalar.
- Se solicitado, reinicie o ambiente de desenvolvimento integrado. Depois que a extensão for instalada, o ícone do Google Cloud Data Agent Kit será adicionado à barra de atividades.
IDEs baseados no VS Code
Para usar o Data Agent Kit com todos os outros ambientes de desenvolvimento integrado baseados no VS Code, instale a extensão.
- No ambiente de desenvolvimento integrado, clique em Extensões ou pressione
Ctrl/Cmd+Shift+X. - Pesquisar por
Google Cloud Data Agent Kit. - Clique em Instalar.
- Se solicitado, reinicie o ambiente de desenvolvimento integrado. Depois que a extensão for instalada, o ícone do Google Cloud Data Agent Kit será adicionado à barra de atividades.
Fazer login no Data Agent Kit
Depois de instalar a extensão ou o plug-in, faça login.
Login da extensão
Se você instalou a extensão do ambiente de desenvolvimento integrado, autentique-se no Google Cloud Data Agent Kit.
Se a caixa de diálogo fazer login não abrir automaticamente, procure um link de login do Google Cloud Data Agent Kit na barra de status perto da parte de baixo da janela do ambiente de desenvolvimento integrado e clique nele.
Outra opção é pressionar
Ctrl/Cmd+Shift+Ppara abrir a paleta de comandos, pesquisar e selecionar Google Cloud Data Agent Kit: fazer login.Siga as instruções e conclua o login.
Uma página da Web confirmando que a autenticação foi concluída é exibida.
Feche a página e volte ao IDE.
Login do plug-in
Instale e faça login na Google Cloud CLI. O plug-in Data Agent Kit usa credenciais da CLI gcloud e Application Default Credentials (ADC).
- Abra o terminal na máquina local ou no ambiente de desenvolvimento integrado.
- Se você ainda não instalou a CLI gcloud, siga as etapas em Instalar a CLI gcloud para fazer o download e instalar a CLI gcloud.
- No terminal, execute
gcloud initpara inicializar a CLI gcloud:gcloud init
- Execute o comando a seguir e siga as instruções para autenticar e
configurar as credenciais padrão do aplicativo:
gcloud auth login && gcloud auth application-default login
- Atualize a CLI gcloud para a versão mais recente:
gcloud components update
Resolver problemas
Se você tiver problemas, saia e faça login de novo. Para encontrar outros métodos de diagnóstico e resolução de erros de instalação, consulte Solução de problemas.