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:
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".
+ 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!
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:
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,gcloude o plugin Data Agent Kit configurados globalmente. - Recarregamento de MCPs: Sempre que reconfigurar um plugin MCP com
dak-setup, basta abrir uma+ New Conversationpara ativar as ferramentas. - Como criar um
AGENTS.mddo zero: Em qualquer pasta nova do seu trabalho na segunda-feira, basta pedir ao Antigravity para gerar oAGENTS.mdcom 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 →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:
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.
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:
🖥️ 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.
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:
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 pedidosCANCELLED).
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:
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'.
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!
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:
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 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:
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!
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:
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/(servidorserver.mjsem Node.js nativo, templateindex.htmle estilosstyle.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
8080e fornece o link de acesso.
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:
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:
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.