Aula 6 · 17 min
O que não é observado não é cultivado. Esta aula acompanha um agente de atendimento de clínica do primeiro erro até a autonomia supervisionada, e mostra o mínimo que você precisa registrar para trocar "achei que melhorou" por "melhorou de 88% para 95%".
Começar a aula
Objetivo: registrar cada execução com o mínimo de campos e transformar um erro real em regra nova, comparando o resultado antes e depois.
Role para acompanhar. Os números são do caso descrito no projeto.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
Médicos e especialidades, horários de cada um, procedimentos e duração, regras da clínica e acesso à agenda. O agente apenas sugere; o atendente aprova cada agendamento.
O agente marca 19h30 com um médico que não atende depois das 18h. A agenda mostrava "livre", mas agenda livre não é médico disponível. A falha é registrada com data, decisão, resultado e causa raiz.
"Antes de sugerir, consultar a agenda E o horário de atendimento do médico. Fora do expediente, nunca, mesmo que a agenda mostre livre." Vale da próxima execução em diante.
Das 20 interações seguintes, 18 certas. As 2 falhas viram mais duas regras: a duração do procedimento tem de caber no horário, e 15 minutos de intervalo entre consultas.
40 interações em duas semanas: 20/20 em cada uma, zero correções do atendente, tempo de resposta de 4 minutos para 45 segundos.
Com o histórico, o agente passa a confirmar sozinho. O humano recebe um relatório diário e revisa só o que o agente marcou como exceção: horário limite, paciente novo, procedimento longo.
Regras: de 5 genéricas para 14 nascidas de falhas reais. 320 execuções registradas, 7 falhas documentadas, 97,8% de acerto, versão v1.0 → v1.4. O modelo é o mesmo do primeiro dia; se a clínica trocar de modelo, o jardim continua.
O que a observabilidade mostra (exemplo do projeto, 100 execuções em cada versão).
Três padrões de erro: fora do horário do profissional (5), horário curto para o procedimento (4) e resposta ambígua sobre cancelamento (3).
Cada padrão gerou regra nova: quatro regras modificadas.
Os padrões 1 e 2 sumiram. O 3 caiu de 3 para 1 ocorrência.
Surgiu um padrão novo: dois procedimentos simultâneos pedindo o mesmo consultório. O ciclo continua.
De 88% para 95% com regras e correções. Ninguém trocou o modelo: olharam os dados e ajustaram o ambiente.
Comparar versões nos mesmos cenários. Achar padrões ("70% dos erros são procedimentos longos"). Medir o custo do erro ("cada remarcação custa R$ 150"). Decidir onde investir primeiro.
Comece com os três campos. A versão completa vem quando o volume pedir.
| data | o que foi pedido | o que foi entregue | deu certo? (sim / não / parcial) | |---|---|---|---| | | | | |
| data | versão do agente | objetivo | decisão tomada | ferramenta usada | tempo | custo | resultado | erro | intervenção humana | avaliação (correta / parcial / errada) | correção aplicada | |---|---|---|---|---|---|---|---|---|---|---|---| | | | | | | | | | | | | |
## Falha <data> O que aconteceu: Decisão que o agente tomou: Causa raiz (faltou contexto, regra, exemplo ou ferramenta?): Menor correção possível: Regra nova (texto exato que entrou no arquivo): Versão do agente: v1.0 → v1.1 Como vou saber se resolveu: próximas 20 execuções, contar acertos
Uma semana de observação.
Para a função que você escolheu, registre toda execução no EXECUCOES.md com os três campos mínimos.
Pronto quando: o arquivo tem pelo menos 10 linhas e você consegue dizer a taxa de acerto da semana (ex.: 8 de 10).
Pegue a falha que mais se repetiu na semana e preencha o modelo "da falha à regra". Coloque a regra no arquivo e suba a versão.
Pronto quando: a regra está escrita no arquivo do agente, a versão subiu (v1.0 → v1.1) e as próximas execuções estão sendo contadas para comparar.
4 perguntas.
Pergunta 1 de 4
A agenda mostrava o horário como livre e o agente marcou fora do expediente do médico. Qual foi a causa raiz?
Pergunta 2 de 4
Qual é a observabilidade mínima viável?
Pergunta 3 de 4
Na v1.1 apareceu um padrão de erro novo (conflito de consultório). Isso significa que...
Pergunta 4 de 4
Depois de 2 meses, o que a clínica tem que um concorrente não copia contratando o mesmo modelo?competência
Escolha uma alternativa. A explicação aparece depois da sua tentativa.