mirror of
https://github.com/sipeed/picoclaw.git
synced 2026-06-12 18:08:54 +00:00
wenjie
37 lines
1.7 KiB
Markdown
37 lines
1.7 KiB
Markdown
# Depuração do PicoClaw
|
|
|
|
> Voltar ao [README](../project/README.pt-br.md)
|
|
|
|
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.
|
|
|
|
## Iniciando o PicoClaw em modo de depuração
|
|
|
|
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:
|
|
|
|
```bash
|
|
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.
|
|
|
|
## Desabilitando a truncagem de logs (logs completos)
|
|
|
|
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`.
|
|
|
|
```bash
|
|
picoclaw gateway --debug --no-truncate
|
|
|
|
```
|
|
|
|
Quando esta flag está ativa, a função de truncagem global é desabilitada. Isso é extremamente útil para:
|
|
|
|
* Verificar a sintaxe exata das mensagens enviadas ao provedor.
|
|
* Ler a saída completa de ferramentas como `exec`, `web_fetch` ou `read_file`.
|
|
* Depurar o histórico de sessão salvo na memória.
|