Configurar e definir configurações

Visualizar

Este produto está sujeito aos "Termos da Oferta Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço e aos Termos Adicionais para Produtos de 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.

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, conclua 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 do Data Cloud, clique no ícone Google Cloud Data Agent Kit na barra de atividades.
2. Expanda 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.

Analisar os papéis necessários

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

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

   A coluna Acesso indica se você é um principal em um papel necessário.

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 do Data Cloud, clique no ícone Google Cloud Data Agent Kit na barra de atividades.
2. Expanda Configurações e clique em Configurações.
3. Selecione BigQuery.
4. Selecione uma região do BigQuery.
5. Clique em Salvar.

Conferir os ambientes de execução sem servidor para Apache Spark

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

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

1. Para abrir o editor de configurações do Data Cloud, clique no ícone Google Cloud Data Agent Kit na barra de atividades.
2. Expanda 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 sem servidor para Apache Spark

1. Para abrir o editor de configurações do Data Cloud, clique no ícone Google Cloud Data Agent Kit na barra de atividades.
2. Expanda 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 programador

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. Expanda 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 ao projeto e à região selecionados 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 do Data Agent Kit para VS Code vem com habilidades de agente que podem ser usadas nos fluxos de trabalho.

1. Para abrir o editor de configurações do Data Cloud, clique no ícone Google Cloud Data Agent Kit na barra de atividades.
2. Expanda 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ê recebe uma solicitação de consentimento para a instalação automática. Em outros casos, é necessário instalar o software manualmente.

Orquestração de Pipelines

Para trabalhar com a Orquestração de Pipelines no seu ambiente de desenvolvimento integrado, instale o seguinte:

• CLI dbt
• CLI 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 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 avançado e precisa ser ativado com cuidado. É 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 fazer login novamente. Para encontrar outros métodos de diagnóstico e resolução de erros de configuração, consulte Resolver 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 bug.
2. No formulário que é aberto, documente o problema e clique em Enviar.

A seguir

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