Culpa: Motor de Reprodução Determinístico de Código Aberto para Depuração de Agentes de IA

Culpa é um mecanismo de reprodução determinística de código aberto projetado especificamente para depurar sessões de agentes de IA. O problema central que ele aborda é a natureza não determinística dos agentes LLM—quando eles falham, você não consegue reproduzir a falha exata simplesmente executando novamente a sessão.

Como Funciona

A ferramenta grava cada chamada LLM junto com o contexto completo de execução durante uma sessão do agente. Quando você precisa depurar uma falha, ela reproduz a sessão usando as respostas gravadas como stubs em vez de fazer novas chamadas de API. Isso torna a reprodução totalmente determinística e não custa nada, pois não acessa as APIs reais.

Recursos Principais

• Modo Proxy: Funciona com ferramentas como Claude Code e Cursor sem exigir alterações de código
• SDK Python: Disponível para desenvolvedores que constroem seus próprios agentes
• Suporte a API: Compatível com APIs da Anthropic e OpenAI
• Capacidade de Fork: Você pode fazer fork em qualquer ponto de decisão gravado, injetar uma resposta diferente e ver o que teria acontecido

Benefícios Práticos

Como a reprodução usa respostas gravadas em vez de fazer chamadas reais de API, as sessões de depuração não geram custos de API. A natureza determinística das reproduções torna possível reproduzir e analisar falhas de forma confiável que, de outra forma, seriam impossíveis de recriar devido à aleatoriedade inerente nas respostas LLM.

O projeto está buscando ativamente feedback, especialmente de desenvolvedores que constroem fluxos de trabalho de agentes. O criador observa que é um calouro de Ciência da Computação e está buscando melhorar a ferramenta.