Antes de começarPython intermediário, SQL com SELECT e GROUP BY, e consumo de API REST.
MCP & AgentesUm agente analista de dados.
LAB 19APRENDA CONSTRUINDO.
UM LAB. UM PROJETO COMPLETO.
DO CONCEITO À EXECUÇÃO
É isso que você vai construir.
Transforme perguntas em SQL validado, com gráficos, limites de execução e auditoria.
Você cria um catálogo de dados, valida consultas e limita o acesso a uma conexão somente leitura. O agente produz gráficos e registra respostas e recusas; os backends são comparados com gabarito.
O analyst: três datasets de exemplo gerados pelo próprio repo; um catálogo por introspecção que diz ao modelo o que existe; um validador que só deixa passar SELECT sobre tabelas conhecidas, com LIMIT imposto e tempo máximo; uma conexão DuckDB só leitura e sem acesso a arquivos; um backend determinístico e outro com modelo local, os dois devolvendo um contrato em JSON; insights por regras (tendência, ponto fora da curva, participação); gráficos PNG; um trace em SQLite com auditoria das recusas; uma avaliação com gabarito que compara backends; uma API com upload de CSV.
5 minpara o demo*
61páginas de conteúdo
17seções no ebook
*Estimativa do Lab. Preparação do ambiente e downloads podem acrescentar tempo.
DUAS PARTES. O MESMO PROJETO.
Um guia para entender. Um projeto para fazer.
Leia, execute e volte ao trecho que precisar. O ritmo é seu.
O ebook visual
61 páginas em português, com diagramas, decisões de implementação e exercícios nas seções práticas.
PDF · EDIÇÃO VISUAL
O repositório completo
Código, dados de exemplo, instruções de execução e 32 testes de unidade + 2 de integração com Ollama (opcional). Inclui o ambiente Docker do projeto.
Depois da compra, o repositório do Lab é enviado por e-mail e WhatsApp para o cadastro feito na Hotmart.
CÓDIGO · TESTES · DOCUMENTAÇÃO
O CAMINHO DO LAB
Saiba onde você vai chegar.
17 seções para acompanhar o projeto, do ambiente aos próximos passos.
Edição visual · 61 páginas
01Introdução+
Conheça um agente que transforma perguntas em SQL e apresenta resultados com gráficos e rastreamento. Entenda a separação entre proposta do modelo, validação e execução somente para leitura.
02Ambiente Python+
Prepare o ambiente virtual e instale as bibliotecas do analista. Execute o demo para conferir datasets, consultas e gráficos antes de explorar a implementação.
03Requirements explicados+
Entenda as dependências da API, dos contratos, da análise SQL e dos gráficos. Veja como as bibliotecas sustentam a consulta aos dados e a apresentação das respostas.
04O mapa do sistema+
Acompanhe a pergunta desde o catálogo até a decisão, validação, execução e visualização. Localize o feedback ao modelo e o registro que permite inspecionar cada tentativa.
05Análise de dados com agentes+
Entenda por que um agente precisa conhecer tabelas, unidades e regras de negócio. Examine restrições aplicadas por código, avaliação de resultados e explicações baseadas em evidências.
06Preparar datasets locais+
Gere datasets locais com tendência, sazonalidade e valores fora da curva. Carregue-os no DuckDB e diferencie a conexão de carga da conexão usada pelo agente para leitura.
07Criar o catálogo semântico+
Monte um catálogo com tipos, estatísticas, amostras e descrições em YAML. Use esse contexto para informar ao agente o significado das colunas e as regras dos dados.
08Gerar SQL com restrições+
Transforme perguntas em decisões estruturadas com SQL e configuração de gráfico. Valide as consultas e execute apenas o que passar pelas restrições, com limites de linhas e tempo.
09Validar resultados+
Compare os resultados do agente com consultas de referência, sem exigir SQL idêntico. Inclua pedidos perigosos no gabarito e inspecione as propostas recusadas ou incorretas.
10Visualizar descobertas+
Gere insights por regras para séries temporais e comparações por categoria. Produza gráficos e apresente os resultados pela API e pela interface do laboratório.
11Limites e auditoria+
Configure limites de linhas, tempo de consulta e novas tentativas. Inspecione SQL proposto, SQL executado e decisões do validador, entendendo o alcance da auditoria.
12Testes e verificação+
Teste geração dos dados, catálogo, bloqueios do SQL e execução somente para leitura. Conheça os testes opcionais que avaliam o agente com Ollama.
13Rodar com Docker+
Suba a API em container com carga inicial dos datasets. Preserve banco, traces e gráficos na pasta compartilhada e verifique o funcionamento do ambiente.
14Troubleshooting+
Diagnostique banco ausente, conflito de acesso, configuração bloqueada e consultas interrompidas. Entenda quais mensagens indicam falhas e quais refletem restrições intencionais.
15Custos, limites e trade-offs+
Compare o backend por templates com o modelo local em latência e cobertura. Revise limites do laboratório e requisitos para consultar dados de produção com controles adequados.
16Próximos passos+
Adicione perguntas e templates ao gabarito e explore explicações geradas a partir dos insights. Evolua componentes mantendo a validação das consultas e a conferência dos resultados.
17Checklist final+
Revise datasets, catálogo semântico, validação SQL, gráficos e rastreamento. Confirme que consultas permitidas funcionam e que pedidos perigosos são recusados e registrados.
PARA COMEÇAR COM CLAREZA
Seu ponto de partida.
Conhecimento prévio
Python intermediário, SQL com SELECT e GROUP BY, e consumo de API REST. Nível: Python + SQL.
Ferramentas do projeto
Python, DuckDB, FastAPI, matplotlib. As instruções de instalação e as versões estão no pacote.
Custo para executar
Zero. Sem serviço, sem conta; o modelo opcional roda no seu computador.
Tempo para aprender
4 h estimadas para ler, executar e entender. Você pode dividir o estudo em várias sessões.