Retro — aprender com os erros
O Retro é o ciclo de aprender-com-os-erros do Makion. Revê sessões passadas, encontra onde o agente errou e propõe melhorias concretas — uma regra apertada, um exemplo melhor ou um relatório de erro para o suporte da Makion. Você revê cada proposta e decide. O Retro é uma superfície de superadmin.
Chega até ele de duas formas:
- Abra o subseparador Propostas do Admin chat.
- Escreva
/retro since=YYYY-MM-DDno Admin chat para analisar sessões a partir de uma data dada.
O que é uma proposta#
O Makion transforma cada erro que encontra numa proposta de um de quatro tipos:
| Tipo | O que faz | Para onde vai |
|---|---|---|
| Correção de regra | Adiciona ou altera uma regra base para que o erro não se repita. | Aplicada a este servidor. |
| Correção de conhecimento | Adiciona ou corrige um ficheiro da base de conhecimento (um padrão ou exemplo). | Aplicada a este servidor. |
| Defeito de código | O problema está no próprio Makion, não na sua configuração. | Enviado para o suporte da Makion. |
| Descartar | Não vale a pena agir — ruído ou caso único. | Fechado sem alteração. |
O que cada proposta mostra#
Cada proposta é sustentada por evidência para que a possa avaliar rapidamente:
- Sintoma — o que correu mal, de forma observável.
- Causa raiz — porque aconteceu.
- Evidência — o detalhe da sessão que sustenta o diagnóstico.
- Um aviso de possível duplicata quando se assemelha a uma regra existente ou a uma proposta anterior.
- A alteração exata — explicitada antes de aprovar, p. ex. "Vai adicionar esta regra…" ou "Vai substituir o conteúdo por…" — para que nada seja aplicado às cegas.
Agir sobre uma proposta#
| Ação | O que faz |
|---|---|
| Aprovar e aplicar | Aplica a alteração a este servidor. As alterações são versionadas e reversíveis — pode revertê-las. |
| Aprovar e enviar ao suporte | Envia a proposta ao suporte da Makion (usado para defeitos de código). |
| Rejeitar | Recusa a proposta; indica um motivo, que é conservado. |
| Medir efeito | Compara as contagens de correções antes → depois da alteração, para que veja se uma correção realmente ajudou. |
Aprovar uma correção de regra ou de conhecimento é reversível e versionado, pelo que é seguro experimentar uma e mais tarde Medir efeito. Se os números não melhorarem, reverta-a.
Filtrar a fila#
Um filtro de estado limita a lista a Pendente / Aplicada / Enviada / Rejeitada / Todas, para que possa trabalhar as propostas novas ou rever o que já tratou.
Como o Retro se encaixa na metodologia#
O Retro é o ciclo de retroação sobre a Methodology: as regras base e a base de conhecimento que escreve à mão são refinadas ao longo do tempo por propostas extraídas de trabalho real. As correções aplicadas aterram nas mesmas regras base e base de conhecimento que o agente lê em cada execução — consulte Configuring projects para saber como essas camadas orientam o agente.
Para onde ir a seguir#
- Admin chat — onde vive o subseparador Propostas.
- Methodology — as regras e a base de conhecimento que as propostas refinam.
- Audit trail — o registo do que o agente fez de facto.