LAB 19 · MCP & Agentes

Um agente analista de dados.

Transforme perguntas em SQL validado, com gráficos, limites de execução e auditoria.

PythonDuckDBFastAPImatplotlib
61 páginas em português 4 h de estudo e prática
EBOOK + REPOSITÓRIOR$ 49,00
Pagamento viaHotmart
Comprar agora

Depois da compra, o repositório do Lab é enviado por e-mail e WhatsApp para o cadastro feito na Hotmart.

Antes de começarPython intermediário, SQL com SELECT e GROUP BY, e consumo de API REST.

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
  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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.

  9. 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.

  10. 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.

  11. 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.

  12. 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.

  13. 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.

  14. 14Troubleshooting

    Diagnostique banco ausente, conflito de acesso, configuração bloqueada e consultas interrompidas. Entenda quais mensagens indicam falhas e quais refletem restrições intencionais.

  15. 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.

  16. 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.

  17. 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.

LAB 19 · EBOOK + PROJETO

Seu próximo passo
pode ser construir.

R$ 49,00Comprar agora