Arki1 Logo Google Cloud Data Agent Sprint • Codelabs
Voltar ao Hub Baixar Starter Kit
Módulo 0 Duração: 20 min

Lab 01: Setup Agêntico & O que é o AGENTS.md

Aprenda como um assistente de inteligência artificial se transforma em um agente autônomo conectado à infraestrutura do Google Cloud.

🎯 Objetivo de Negócio

No mundo real, você não recebe pastas cheias de scripts prontos: você recebe dados brutos (planilhas CSV) e precisa preparar sua ferramenta de trabalho. Neste Lab 01, você vai configurar o seu computador para trabalhar com o Google Cloud uma única vez, conectar os servidores MCP do plugin Data Agent Kit e ensinar o próprio Antigravity a criar o manual de instruções do seu projeto (AGENTS.md).

1. Etapa 1A: Configurando seu Computador e o Plugin Data Agent Kit (Feito 1 Única Vez)

Certifique-se de ter instalado o plugin Data Agent Kit na aba Extensions / Plugins do Antigravity 2.0 e aberto a pasta descompactada do seu starter_kit (que contém apenas os 3 arquivos CSV em data/). Envie o prompt abaixo para que o próprio Antigravity instale qualquer dependência ausente, autentique sua conta no navegador e configure o plugin usando a skill oficial dak-setup:

💬 Prompt 1A — Setup do Ambiente & Plugin Data Agent Kit
Olá, Antigravity! Estou preparando meu computador para trabalhar com o Google Cloud e o plugin Data Agent Kit. Por favor, execute os seguintes passos na ordem:
1. Verifique se o Node.js (versão 20+) e o Google Cloud SDK (gcloud) estão instalados. Se algum deles não estiver presente, instale-o automaticamente usando o gerenciador de pacotes do sistema (no Windows: winget install -e --id OpenJS.NodeJS.LTS e winget install -e --id Google.CloudSDK --accept-package-agreements --accept-source-agreements) e atualize a variável PATH da sessão atual.
2. Verifique se já estou autenticado no Google Cloud com Application Default Credentials (ADC). Caso não esteja, execute 'gcloud auth login --update-adc' para que eu faça o login uma única vez pelo navegador.
3. Descubra o ID do projeto disponível na minha conta ('gcloud projects list'), defina-o como projeto padrão no gcloud e habilite as APIs bigquery.googleapis.com e dataplex.googleapis.com.
4. Execute a configuração do plugin Data Agent Kit (skill dak-setup / script dak-setup.js save) para esse ID de projeto, na região 'us-central1', habilitando os serviços "BigQuery", "Knowledge Catalog" e "Cloud Storage".
🔄 Passo Obrigatório após a Etapa 1A: Clique em + New Conversation!

Importante: O Antigravity 2.0 carrega os servidores MCP do plugin Data Agent Kit no momento em que uma nova conversa se inicia. Assim que o Antigravity concluir a Etapa 1A e avisar que o Data Agent Kit foi configurado, clique no botão + New Conversation na barra lateral esquerda antes de enviar o Prompt 1B!

🔌 data-agent-kit-plugin_dak-bigquery 🔌 data-agent-kit-plugin_dak-kc

2. Etapa 1B: Criando Nosso AGENTS.md e Fazendo o Primeiro Voo via MCP

Já na Nova Conversa (com os servidores MCP ativos), vamos pedir para o próprio Antigravity criar o arquivo AGENTS.md na raiz do projeto — ensinando a ele como atuar como nosso Consultor Executivo de Dados — e validar nossa conexão com o BigQuery via MCP:

💬 Prompt 1B — Criar AGENTS.md & Testar Conexão MCP (Em Nova Conversa)
Olá, Antigravity! Acabei de configurar o plugin Data Agent Kit e abri esta nova conversa. Por favor, faça duas coisas:
1. Crie um arquivo 'AGENTS.md' na raiz desta pasta definindo suas regras permanentes como meu Consultor Executivo de Dados:
- Regra MCP-First: Sempre utilize as ferramentas MCP do plugin Data Agent Kit (servidor 'data-agent-kit-plugin_dak-bigquery' com 'list_dataset_ids', 'list_table_ids', 'get_table_info', 'execute_sql_readonly', 'execute_sql', e servidor 'data-agent-kit-plugin_dak-kc' com 'search_entries', 'lookup_context') passando sempre o parâmetro obrigatório 'projectId' e 'query' nas consultas SQL, evitando usar a CLI 'bq' para consultas analíticas.
- Higienização Direta em SQL: Quando eu pedir para limpar dados ou criar camadas curadas no BigQuery, crie Views SQL diretamente via MCP ('execute_sql') sem executar scripts Python externos de escaneamento.
- Formato Executivo: Apresente todas as análises com Resumo Executivo, Tabelas Formatadas e Gráficos Visuais (Mermaid), sem jargões obscuros.
- Segurança: Nunca execute comandos destrutivos (DROP, TRUNCATE, DELETE sem WHERE) sem minha confirmação explícita.
2. Em seguida, chame sua ferramenta MCP 'list_dataset_ids' do BigQuery para inspecionar nosso projeto Google Cloud ativo e me apresente um Cartão de Boas-Vindas Executivo confirmando o ID do projeto conectado, o status das ferramentas MCP e os datasets existentes.

3. O que você acabou de aprender para o seu dia a dia

  • Configuração Real da Máquina: Seu computador agora possui Node.js, gcloud e o plugin Data Agent Kit configurados globalmente.
  • Recarregamento de MCPs: Sempre que reconfigurar um plugin MCP com dak-setup, basta abrir uma + New Conversation para ativar as ferramentas.
  • Como criar um AGENTS.md do zero: Em qualquer pasta nova do seu trabalho na segunda-feira, basta pedir ao Antigravity para gerar o AGENTS.md com as regras de negócio da sua área!

🖥️ Checkpoint no Google Cloud Console

Abra o navegador no Console do Google Cloud e confira se o ID do projeto exibido no topo da página corresponde exatamente ao ID informado pelo Antigravity no chat.

Abrir Google Cloud Console →
Módulo 1 Duração: 30 min

Lab 02: Implementando o Pipeline no BigQuery

Você tem 3 arquivos CSV brutos na pasta data/. Pilote o Antigravity para criar o dataset na nuvem, ingerir os CSVs e auditar as tabelas via MCP.

🎯 Objetivo de Negócio

Arquivos CSV locais (planilhas de vendas, cadastros brutos) não têm escalabilidade nem governança. Sua missão é comandar o Antigravity para criar o dataset corporativo no BigQuery via MCP, carregar os 3 arquivos CSV da pasta data/ e auditar a integridade das tabelas criadas usando exclusivamente as ferramentas MCP do BigQuery.

1. Conhecendo as Bases Brutas (Os Únicos Arquivos do Seu Pacote)

Observe que na sua pasta data/ existem apenas os 3 arquivos CSV brutos (sem nenhum script pré-fabricado):

  • data/ecommerce_orders.csv: 1.200 transações de compras online com status de pagamento.
  • data/customers_staging.csv: 505 registros cadastrais com dados confidenciais e inconsistências.
  • data/raw_store_orders.csv: 20.112 pedidos operacionais ao longo de 120 dias.

2. Passo Prático: Ingestão e Auditoria no BigQuery

Envie o seguinte prompt no chat do Antigravity:

💬 Prompt para o Antigravity
Siga as diretrizes do nosso AGENTS.md. Temos 3 arquivos CSV brutos na pasta 'data/' ('ecommerce_orders.csv', 'customers_staging.csv' e 'raw_store_orders.csv'):
1. Utilize sua ferramenta MCP execute_sql do BigQuery para criar o dataset 'workshop_data' (CREATE SCHEMA IF NOT EXISTS) no nosso projeto ativo;
2. Carregue os 3 arquivos CSV locais da pasta 'data/' para as tabelas 'workshop_data.ecommerce_orders', 'workshop_data.customers_staging' e 'workshop_data.raw_store_orders' no BigQuery (usando 'bq load --source_format=CSV --autodetect --replace' do Google Cloud SDK instalado ou via API);
3. Assim que a carga terminar, utilize exclusivamente suas ferramentas MCP do BigQuery (list_table_ids, get_table_info e execute_sql_readonly) para inspecionar cada tabela criada na nuvem e me apresente uma tabela executiva com nome da tabela, total exato de linhas carregadas e colunas identificadas.
🔍 Transparência Agêntica: O que Observar

Veja como esse fluxo reflete exatamente o seu dia a dia: você apenas apontou onde estão os arquivos CSV na sua pasta! O Antigravity cria o schema via MCP (execute_sql), sobe os arquivos CSV locais para o BigQuery e audita as contagens reais na nuvem via data-agent-kit-plugin_dak-bigquery:get_table_info e execute_sql_readonly:

1.200 linhas ➔ ecommerce_orders 505 linhas ➔ customers_staging 20.112 linhas ➔ raw_store_orders

🖥️ Checkpoint no BigQuery Studio

Abra o BigQuery Studio no Google Cloud Console. No painel à esquerda, expanda seu projeto e o dataset workshop_data. Clique na tabela ecommerce_orders e selecione a aba Visualização (Preview) para ver os registros reais.

Abrir BigQuery Studio →
Módulo 2 Duração: 35 min

Lab 03: Conversational Analytics & Desambiguação

Faça perguntas analíticas complexas em linguagem natural e aprenda como o agente protege a empresa contra erros conceituais de faturamento.

🎯 Objetivo de Negócio

No dia a dia corporativo, perguntar *"Qual foi o faturamento?"* pode ser perigoso: se a consulta somar pedidos cancelados ou reembolsados, o CFO tomará decisões com base em receita ilusória. Você verá como um agente de dados instruído detecta essa ambiguidade e traz a resposta precisa via BigQuery MCP.

1. A Pergunta de Negócio Ambígua

Envie o seguinte prompt no chat:

💬 Prompt para o Antigravity
Utilizando a ferramenta MCP execute_sql_readonly do BigQuery, consulte a tabela 'workshop_data.ecommerce_orders': qual foi o nosso volume total de vendas? Esclareça a diferença entre Faturamento Bruto (Gross Bookings) e Receita Líquida Realizada (Net Settled Revenue, status COMPLETED), mostrando o impacto de cancelamentos e reembolsos em uma tabela comparativa.

2. O que o Antigravity descobre

O agente inspeciona o campo order_status via MCP e revela os números exatos do negócio:

  • Gross Bookings (Volume Bruto): $967.085,62 (1.200 pedidos totais).
  • Net Settled Revenue (Receita Concretizada): $667.261,49 (839 pedidos com status COMPLETED).
  • Vazamento por Reembolso (Refunds): $103.584,59 (120 pedidos REFUNDED) e Cancelados: $67.843,49 (89 pedidos CANCELLED).

3. Análise de Pareto de Categorias com Gráfico Visual

Agora peça ao agente para descobrir quais categorias puxam as vendas e formalizar o glossário semântico:

💬 Prompt para o Antigravity
Agora analise via MCP execute_sql_readonly as categorias de produtos de 'workshop_data.ecommerce_orders'. Quais são as principais categorias por receita bruta e receita realizada? Apresente uma tabela ordenada com o percentual de representatividade de cada uma, renderize um gráfico visual Mermaid e salve as definições oficiais dessas métricas no arquivo 'semantic_glossary.yaml'.
💡 Insight de Negócio (Princípio de Pareto)

O gráfico gerado pelo agente demonstrará claramente que a categoria Electronics é responsável por cerca de 95% do volume da empresa ($919.057,85 Bruto / $633.590,30 Líquido Realizado), enquanto as demais categorias somam cerca de 5%. Esse é um achado acionável imediato para a liderança comercial!

🖥️ Checkpoint no BigQuery Studio

Vá até a aba Histórico de Consultas (Query History) no BigQuery Studio e observe as consultas SQL geradas e executadas pelo Antigravity em tempo real, sem você ter precisado escrever uma linha de código SQL!

Módulo 3 Duração: 35 min

Lab 04: Governança, PII & Mascaramento Dinâmico

Audite riscos de privacidade (LGPD/GDPR) e crie uma camada de dados curada com mascaramento dinâmico no BigQuery.

🎯 Objetivo de Negócio

Dados expostos de clientes (como CPF/SSN e telefone) geram multas regulatórias e riscos de segurança da informação. Sua meta é comandar o agente para auditar os dados brutos de clientes em customers_staging e implementar uma visualização curada e segura (customers_curated) com mascaramento dinâmico.

1. Auditoria de Privacidade e Dados Sensíveis via Catálogo & BigQuery MCP

Envie o seguinte prompt no chat do Antigravity:

💬 Prompt para o Antigravity
Nossa área de Governança e Compliance precisa de um diagnóstico na tabela 'workshop_data.customers_staging'.
1. Pesquise o ativo no Knowledge Catalog via ferramenta MCP search_entries (query: 'customers_staging system=BIGQUERY type=TABLE') e inspecione seus metadados;
2. Via ferramenta MCP execute_sql_readonly do BigQuery, identifique quais colunas contêm dados sensíveis/PII (documentos fiscais, telefones, e-mails) e audite as 6 regras de qualidade contratual (IDs duplicados, contagens negativas de pedidos, datas de cadastro futuras > 2025-12-31, códigos de país inválidos XX/ZZ e e-mails nulos);
3. Apresente um relatório executivo de governança listando todas as vulnerabilidades encontradas.
🔍 O que o Antigravity Detecta

O agente consulta o Knowledge Catalog (data-agent-kit-plugin_dak-kc:search_entries) e o BigQuery (execute_sql_readonly), identificando que tax_identifier, phone_number e email_address estão em texto aberto e descobrindo 49 anomalias contratuais (5 IDs duplicados, 8 contagens de pedidos negativas, 6 datas no futuro, 12 países inválidos e 18 e-mails ausentes).

2. Remediação: Criando a View Curada com Mascaramento

Agora ordene ao agente que crie a camada protegida via MCP:

💬 Prompt para o Antigravity
Excelente diagnóstico. Utilizando a ferramenta MCP execute_sql do BigQuery, implemente a view curada 'workshop_data.customers_curated' que:
1. Desduplica os registros por customer_id mantendo o cadastro mais recente;
2. Aplica mascaramento seguro nas colunas PII ('tax_identifier', 'phone_number' e 'email_address');
3. Filtra registros com contagens negativas, datas futuras ou países inválidos ('XX', 'ZZ').
Ao concluir, consulte 5 registros da view via MCP execute_sql_readonly e apresente uma tabela 'Antes vs Depois' comprovando que os dados sensíveis foram protegidos.

🖥️ Checkpoint no BigQuery Studio & Knowledge Catalog

No BigQuery Studio, execute: SELECT * FROM `workshop_data.customers_curated` LIMIT 10. Verifique que os registros inválidos e duplicados foram higienizados e que nenhuma pessoa não autorizada consegue ver CPFs ou telefones em texto aberto!

Módulo 4 & Capstone Duração: 40 min

Lab 05: Data App Gerencial com Agente Integrado

Crie e publique uma aplicação web interativa que entrega um dashboard executivo e um assistente de dados integrado para tomadores de decisão.

🎯 Objetivo de Negócio

Insights analíticos geram valor real quando chegam às mãos de gestores e tomadores de decisão. Neste desafio final, você comandará o Antigravity para criar um aplicativo web completo na sua pasta de trabalho: com um painel de indicadores (KPIs de vendas e governança) e um agente de dados conversacional onde qualquer gestor pode digitar perguntas e receber gráficos e respostas analíticas.

1. Criando a Aplicação Web Executiva

Envie o seguinte prompt no chat do Antigravity:

💬 Prompt para o Antigravity
Chegamos ao grande final do nosso workshop! Quero construir um Data App executivo em nossa pasta 'workspace/app'.
O app deve conter:
1. Dashboard Gerencial: Cards com KPIs principais extraídos do BigQuery (Faturamento Líquido Realizado de $667.261,49, Clientes Curados, Taxa de Reembolso e SLA de Governança 100%) e gráficos limpos;
2. Agente de Dados Integrado: Uma interface de busca/chat onde o gestor pode clicar em sugestões ou digitar perguntas de negócio (ex.: 'Qual categoria vendeu mais?', 'Quais anomalias operacionais ocorreram nas lojas?') e ver respostas analíticas com gráficos e a query BigQuery associada;
3. Servidor leve sem dependências externas: Utilizando apenas a standard library do Node.js ('node workspace/app/server.mjs' na porta 8080, separando 'index.html' e 'style.css' sem estilos inline).
Por favor, crie os arquivos necessários em 'workspace/app' e inicie o servidor localmente para que eu possa testar no navegador!

2. O que o Antigravity faz

  • Cria a estrutura do Data App em workspace/app/ (servidor server.mjs em Node.js nativo, template index.html e estilos style.css).
  • Implementa o dashboard de KPIs executivos conectado à inteligência validada via MCP no workshop.
  • Implementa o mecanismo conversacional com botões de sugestões de perguntas para gestores.
  • Inicia o servidor web local na porta 8080 e fornece o link de acesso.
🌐 Testando o seu Data App

Abra seu navegador no endereço: http://localhost:8080.
Experimente clicar nos botões de perguntas sugeridas (como *"Sales Last Quarter"* ou *"Category Pareto Breakdown"*) ou digitar sua própria pergunta para interagir com o agente de dados diretamente na interface web!

3. Passo Bônus: Deploy em 1 Linha no Google Cloud Run

Se desejar compartilhar sua aplicação com sua organização, comande o Antigravity com o prompt abaixo para realizar o deploy direto no Google Cloud Run:

💬 Prompt para o Antigravity (Deploy Cloud Run)
Por favor, prepare um Dockerfile minimalista em 'workspace/app' e execute o deploy do nosso aplicativo no Google Cloud Run com o comando:
gcloud run deploy data-agent-executive-app --source workspace/app --region us-central1 --allow-unauthenticated
Ao finalizar, me forneça a URL pública do nosso app no ar!

🎉 Parabéns! Você concluiu o Data Agent Sprint!

Você aprendeu o ciclo agêntico completo: desde a configuração real do computador e criação do seu próprio AGENTS.md até a análise conversacional no BigQuery, governança de dados sensíveis e publicação de um Data App executivo.

4. Pós-Workshop: Como Usar no Dia a Dia com Sua Conta Real da Empresa

O seu computador já está 100% configurado com Node.js, gcloud e o plugin Data Agent Kit! Para sair da conta temporária de estudante do workshop e passar a trabalhar nos dados e projetos reais da sua empresa, basta enviar o prompt abaixo no Antigravity e depois abrir uma + New Conversation:

💬 Prompt Pós-Workshop — Trocar para Minha Conta Corporativa Real
Antigravity, concluí o workshop e agora quero trocar a conexão da conta de laboratório para a minha conta corporativa real. Por favor:
1. Execute 'gcloud auth login --update-adc' para que eu faça login no navegador com meu e-mail corporativo;
2. Liste os projetos disponíveis na minha conta corporativa ('gcloud projects list') para eu escolher qual projeto usar;
3. Reconfigure o plugin Data Agent Kit (skill dak-setup / script dak-setup.js save) para o meu projeto corporativo ativo.
Retornar ao Hub do Workshop