docs/operations/debug.pt-br.md
Voltar ao README
O PicoClaw realiza múltiplas interações complexas nos bastidores para cada requisição que recebe — desde o roteamento de mensagens e avaliação de complexidade, até a execução de ferramentas e adaptação a falhas de modelo. Poder ver exatamente o que está acontecendo é crucial, não apenas para solucionar problemas potenciais, mas também para realmente entender como o agente opera.
Para obter informações detalhadas sobre o que o agente está fazendo (requisições LLM, chamadas de ferramentas, roteamento de mensagens), você pode iniciar o gateway do PicoClaw com a flag de depuração:
picoclaw gateway --debug
# or
picoclaw gateway -d
Neste modo, o sistema formata os logs de forma detalhada e exibe prévias dos prompts do sistema e dos resultados de execução das ferramentas.
Por padrão, o PicoClaw trunca strings muito longas (como o Prompt do Sistema ou resultados JSON grandes) nos logs de depuração para manter o console legível.
Se você precisar inspecionar a saída completa de um comando ou o payload exato enviado ao modelo LLM, pode usar a flag --no-truncate.
Nota: Esta flag só funciona quando combinada com o modo --debug.
picoclaw gateway --debug --no-truncate
Quando esta flag está ativa, a função de truncagem global é desabilitada. Isso é extremamente útil para:
exec, web_fetch ou read_file.