A pior falha de persistência não é o erro: é a gravação que não acontece e devolve
sucesso. O agente segue achando que tem memória, e o contexto evapora na próxima sessão.
Como uma gravação morre em silêncio
- Interpretador erradoO script importa um módulo que só existe no ambiente do
gateway. Rodado com o Python do sistema, ele sai sem gravar e sem mensagem.
- Path sanitizadoO script limpa o
sys.path para evitar conflito de
biblioteca e remove justamente a pasta que fornecia a dependência.
- Store erradoO leitor aponta para um banco com 0 linhas enquanto o processo
escreve em outro. Verde para sempre, indexando nada.
- Banco travadoVários processos dividem o mesmo SQLite; uma transação presa bloqueia
a escrita e a leitura.
- Serviço foraO vetor de memória não responde e o cliente trata como “sem
resultado” em vez de falha.
A regra: leia de volta
Gravação só está provada quando o dado volta. Rode a escrita, depois a leitura, e compare
o conteúdo — na mesma execução:
python3 scripts/memory_save.py --save "estado + próximo passo"
python3 scripts/memory_save.py --chat <id> --top 3 # o texto tem que estar aqui
Sem o segundo comando, você tem um código de saída, não uma memória.
Os três degraus de fallback
- Caminho normalEscrita pela API do store, com o interpretador do próprio
gateway.
- Caminho diretoEscrita no banco vetorial quando a API falha.
- Plano em discoQuando não há caminho de escrita, o estado vai para um arquivo
versionado do plano — que sobrevive à queda do serviço. E o bloqueio é reportado em uma linha, em
vez de fingir que salvou.
Separe as camadas antes de acusar
“Memória fora do ar” costuma ser três coisas diferentes: (a) a infraestrutura (o banco responde?),
(b) o interpretador que roda o plugin (tem o módulo?), (c) a ferramenta. Cada uma falha por um
motivo e as mensagens se parecem. Teste as três, nessa ordem.
Ver a skill AI Test Loop
Ver todas as skills
Quer isso montado no seu projeto? Setup guiado a partir de
R$ 1.500, com o primeiro ciclo rodado junto.
← todas as skills
Receba o próximo artigo
Sai quando eu publicar, junto com a skill grátis usada aqui. Sem spam, e o descadastro é de um clique.
Pagamento processado pelo
Stripe — nenhum dado de cartão passa por este servidor. Entrega imediata após a confirmação.
Termos, entrega e reembolso.