Antes de começarPython intermediário e experiência escrevendo uma API.
MCP & AgentesUm agente de suporte com IA.
LAB 20APRENDA CONSTRUINDO.
UM LAB. UM PROJETO COMPLETO.
DO CONCEITO À EXECUÇÃO
É isso que você vai construir.
Classifique tickets, consulte a base e encaminhe ao humano quando a resposta exige revisão.
Você monta a base de conhecimento, a prioridade dos chamados e a política de resposta. Uma fila de revisão e um relatório de SLA ajudam a acompanhar o que o agente fez e por quê.
O helpdesk: uma base de conhecimento em Markdown indexada por seção; um simulador de tickets com gabarito; um classificador de intent por regras com confiança (e um por modelo local, em JSON validado); uma política de prioridade P1/P2/P3 com prazos de SLA e relógio injetável; uma recuperação que só confia no contexto acima de um score mínimo; um rascunho extrativo que cita artigo e seção (e um redator por modelo que é conferido); uma decisão em código que responde sozinha ou escala com motivo; uma fila humana ordenada por prazo; um relatório de SLA e uma avaliação contra o gabarito; tudo por CLI e por API.
5 minpara o demo*
49pá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
49 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 48 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 · 49 páginas
01Introdução+
Conheça um agente que classifica tickets, busca na base de conhecimento e prepara respostas citadas. Veja como casos sensíveis ou incertos chegam à fila humana.
02Ambiente Python+
Crie o ambiente virtual e instale o projeto de suporte. Execute o demo para observar tickets, triagem e encaminhamentos antes de examinar cada componente.
03Requirements explicados+
Entenda as bibliotecas da API, persistência e integração opcional com Ollama. Veja quais responsabilidades ficam explícitas no código em vez de depender de um framework de agentes.
04O mapa do sistema+
Acompanhe a triagem desde a entrada do ticket até a resposta ou o encaminhamento humano. Identifique onde classificação, busca, política e relatório se conectam.
05Suporte automatizado com humano no loop+
Diferencie intenção, prioridade, contexto confiável e confiança da resposta. Entenda por que a revisão humana precisa de fila, motivo e prazo, e como isso se relaciona ao SLA.
06Modelar a base de conhecimento+
Organize artigos Markdown por assunto e seções que respondam perguntas específicas. Construa e inspecione o índice de busca, preservando a seção que será citada no rascunho.
07Tickets, intents e prioridade+
Modele tickets, rascunhos e escalonamentos e gere casos simulados com gabarito. Classifique a intenção e aplique regras de prioridade e prazo conforme o contexto do atendimento.
08Recuperar contexto e rascunhar+
Recupere trechos da base e exija evidência suficiente antes de rascunhar. Compare o texto extrativo com a redação por modelo e confira se a resposta mantém a citação.
09Decidir: responder ou escalar+
Combine classificação, prioridade, evidência e confiança para escolher entre resposta automática e revisão. Examine os motivos que obrigam o encaminhamento, como assunto sensível ou falta de contexto.
10A fila humana e a API+
Organize escalonamentos por prazo, mostrando motivo e rascunho ao atendente. Use a CLI e a API para resolver casos e acompanhar as mudanças de estado.
11Medir: SLA e avaliação+
Calcule indicadores de prazo e compare a triagem com o gabarito. Observe o efeito da fila não atendida e confronte regras e modelos com os mesmos casos.
12Testes e verificação+
Teste base de conhecimento, classificação, política, fila e conferência dos rascunhos. Execute verificações sem rede e conheça os testes opcionais com Ollama.
13Rodar com Docker+
Empacote o agente como uma API em container com persistência dos dados. Rode demo e testes e configure a conexão ao Ollama do computador quando necessário.
14Troubleshooting+
Investigue problemas de instalação, ambiente e datas usados na simulação. Utilize os sintomas do demo e da triagem para encontrar configurações inconsistentes.
15Custos, limites e trade-offs+
Avalie custo por ticket, tempo de classificação e limites da busca e das regras. Reconheça o que falta para conectar o laboratório a um atendimento em produção.
16Próximos passos+
Explore um classificador híbrido, usando regras nos casos claros e modelo nos ambíguos. Planeje reabertura de tickets e novas extensões apoiadas pela avaliação existente.
17Checklist final+
Confira a base indexada, o classificador, as respostas citadas e os encaminhamentos. Verifique também fila humana, prazos e métricas antes de adaptar o agente ao seu suporte.
PARA COMEÇAR COM CLAREZA
Seu ponto de partida.
Conhecimento prévio
Python intermediário e experiência escrevendo uma API. Nível: Python intermediário.
Ferramentas do projeto
Python, FastAPI, SQLModel, SQLite. As instruções de instalação e as versões estão no pacote.
Custo para executar
Zero. Sem serviço, sem conta; o Ollama roda na sua máquina, e é opcional.
Tempo para aprender
4 h estimadas para ler, executar e entender. Você pode dividir o estudo em várias sessões.