Configurar e definir configurações

Visualizar

Este produto está sujeito aos "Termos da Pré-GA" nos Termos Gerais de Serviço dos Termos Específicos de Serviço e aos Termos Adicionais para Produtos Pré-lançamento de IA Generativa. Os produtos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições das fases de lançamento.

VS Code

• VS Code
• Antigravity

Este documento descreve como configurar as definições iniciais depois de instalar a extensão do Google Cloud Data Agent Kit para o Visual Studio Code.

Antes de começar

Antes de começar, siga as etapas em Instalar a extensão.

Importante: no seu ambiente de desenvolvimento integrado, o Google Cloud Data Agent Kit e a Google Cloud CLI precisam ser configurados para usar a mesma conta de usuário, projeto, região e conta de faturamento.

Configurar o projeto e a região Google Cloud

Se você ainda não configurou o projeto e a região, siga estas etapas.

1. Para abrir o editor de configurações da Data Cloud, clique no ícone Kit do agente de dados do Google Cloud na barra de atividades.
2. Abra Configurações e clique em Configurações.
3. Selecione Comum.
4. Selecione o ID do projeto e a região. O ID do projeto precisa corresponder ao ID especificado na CLI gcloud.
5. Clique em Salvar.

Revisar os papéis necessários

1. Para abrir o editor de configurações da Data Cloud, clique no ícone Kit do agente de dados do Google Cloud na barra de atividades.
2. Abra Configurações e clique em Configurações.

3. Acesse Comum > Permissões necessárias.

   A coluna Acesso indica se você é um principal em uma função obrigatória.

4. Para receber as permissões necessárias para usar a extensão do Data Agent Kit para VS Code, peça ao administrador para conceder a você os papéis correspondentes do Identity and Access Management (IAM) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Configurar a região do BigQuery

1. Para abrir o editor de configurações da Data Cloud, clique no ícone Kit do agente de dados do Google Cloud na barra de atividades.
2. Abra Configurações e clique em Configurações.
3. Selecione BigQuery.
4. Selecione uma região do BigQuery.
5. Clique em Salvar.

Ver tempos de execução sem servidor para Apache Spark

1. Para abrir o editor de configurações da Data Cloud, clique no ícone Kit do agente de dados do Google Cloud na barra de atividades.
2. Abra Configurações e clique em Configurações.
3. Selecione Apache Spark. Todos os ambientes de execução sem servidor do projeto são exibidos.
4. Para conferir uma configuração de ambiente de execução sem servidor, clique no nome dela.

Criar um ambiente de execução sem servidor para Apache Spark

1. Para abrir o editor de configurações da Data Cloud, clique no ícone Kit do agente de dados do Google Cloud na barra de atividades.
2. Abra Configurações e clique em Configurações.
3. Selecione Apache Spark.
4. Clique em Criar.
5. Preencha os campos e clique em Salvar.

Excluir um ambiente de execução do Serverless para Apache Spark

1. Para abrir o editor de configurações da Data Cloud, clique no ícone Kit do agente de dados do Google Cloud na barra de atividades.
2. Abra Configurações e clique em Configurações.
3. Selecione Apache Spark.
4. No ambiente de execução sem servidor que você quer excluir, clique em "Ações" e em Excluir.

Configurar o Scheduler

1. Para abrir o editor de configurações do Google Cloud Data Agent Kit, clique no ícone Google Cloud Data Agent Kit na barra de atividades.
2. Abra Configurações e clique em Configurações.
3. Clique em Programador.
4. Selecione um projeto e uma região. O projeto e a região não precisam corresponder aos que você selecionou na guia "Comum".
5. Selecione um ambiente do Serviço gerenciado para Apache Airflow para configurar fluxos de trabalho.
6. Clique em Salvar.

Analisar as habilidades do agente

A extensão Data Agent Kit para VS Code vem com habilidades de agente que podem ser usadas nos seus fluxos de trabalho.

1. Para abrir o editor de configurações da Data Cloud, clique no ícone Kit do agente de dados do Google Cloud na barra de atividades.
2. Abra Configurações e clique em Configurações.
3. Clique em Habilidades.
4. Para ler o Markdown que define uma habilidade, clique no título dela.

Instalar dependências

Algumas operações do Google Cloud Data Agent Kit exigem a instalação de software adicional depois que a extensão é instalada. Em alguns casos, você precisa dar consentimento para a instalação automática. Em outros casos, é necessário instalar o software manualmente.

Orquestração de pipelines

Para trabalhar com Orquestração de Pipelines no seu IDE, instale o seguinte:

• CLI dbt
• CLI do Dataform

Notebooks

Quando você tenta uma operação que exige o seguinte, o ambiente de desenvolvimento integrado pede seu consentimento e instala o software para você:

• BigQuery DataFrames (versão 2.36 ou mais recente)
• Anywidget
• BigQuery ML

Para permitir que o agente execute células de código nos seus notebooks, ative a configuração google.datacloud.executeCellToolForNotebookMCP nas configurações do ambiente de desenvolvimento integrado. Essa configuração ativa a ferramenta execute_cell para o Protocolo de Contexto de Modelo (MCP) do Notebook.

Importante: permitir que o agente execute células de código nos notebooks é um recurso poderoso que deve ser ativado com cautela. É necessário reiniciar o ambiente de desenvolvimento integrado depois de mudar essa configuração.

Resolver problemas

Se você tiver problemas, tente sair do Google Cloud Data Agent Kit e da CLI gcloud e faça login novamente. Para encontrar outros métodos de diagnóstico e resolução de erros de configuração, consulte Solução de problemas da extensão do Data Agent Kit para VS Code.

Informar um problema

Para informar um problema, faça o seguinte:

1. No menu do Google Cloud Data Agent Kit na barra de atividades, clique em Informar um bug.
2. No formulário que abrir, documente o problema e clique em Enviar.

A seguir

• Transforme dados usando a extensão do Data Agent Kit para VS Code.