Configurar e definir configurações

Neste documento, descrevemos como configurar as definições iniciais depois de instalar a extensão do IDE do Google Cloud Data Agent Kit.

Observação: se você estiver usando o plug-in do Data Agent Kit com uma CLI ou agente de programação compatível, use comandos de linguagem natural para configurar as definições.

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 do Google Cloud

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

1. Para abrir o editor de configurações da Data Cloud, clique no ícone Google Cloud Data Agent Kit 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 obrigatórios

1. Para abrir o editor de configurações da Data Cloud, clique no ícone Google Cloud Data Agent Kit 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 o Data Agent Kit, 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 Google Cloud Data Agent Kit 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 Google Cloud Data Agent Kit 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 mostrados.
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 Google Cloud Data Agent Kit 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 Google Cloud Data Agent Kit 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 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. 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 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.

Revisar as habilidades do agente

O Data Agent Kit vem com habilidades do agente que podem ser usadas nos seus fluxos de trabalho.

1. Para abrir o editor de configurações da Data Cloud, clique no ícone Google Cloud Data Agent Kit 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 você instala a extensão. 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 do 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 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 seus notebooks é uma capacidade poderosa e deve ser ativada com cautela. Reinicie 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 de novo. Para encontrar outros métodos de diagnóstico e resolução de erros de configuração, consulte Resolver problemas do Data Agent Kit.

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

• Transformar dados usando o Data Agent Kit
• Reduzir os riscos de injeção de comando
• Teste um codelab que usa o Data Agent Kit