Visualizando Logs
- Como a configuracao de Log Level em cada agente controla o que e registrado
- Onde encontrar os logs no AutoTalk
- Como usar logs para solucionar problemas de comportamento do agente
Logs fornecem um registro detalhado da atividade do seu agente de IA. Eles capturam mensagens processadas, chamadas de ferramentas realizadas, respostas geradas e erros encontrados. Revisar os logs e a maneira mais rapida de entender por que um agente se comportou de determinada maneira e diagnosticar problemas.
Como os niveis de log funcionam
Cada agente tem uma configuracao de Log Level, definida no formulario principal do agente junto com o nome e o tipo de assistente. O nivel de log controla quanta informacao e registrada:
- Menor verbosidade: Apenas eventos significativos (erros, avisos) sao registrados. Adequado para agentes em producao que estao funcionando sem problemas.
- Maior verbosidade: Informacoes detalhadas sobre cada etapa do processamento sao registradas, incluindo dados de entrada/saida, parametros de chamadas de ferramentas e decisoes internas. Ideal durante configuracao, testes e depuracao.
Defina um nivel de log mais alto enquanto voce esta construindo e testando seu agente. Uma vez que o agente esteja estavel e lidando com conversas reais de clientes, reduza o nivel de log para economizar armazenamento e facilitar a identificacao de problemas genuinos.
Onde encontrar os logs
Os logs dos agentes estao disponiveis na secao Empresa do AutoTalk:
- Na barra lateral, va ate Empresa.
- Clique em Logs.
- Voce vera uma lista de entradas de log de todos os seus agentes e atividade do sistema.
- Filtre ou pesquise para encontrar entradas relacionadas a um agente especifico.
O que os logs contem
Cada entrada de log tipicamente inclui:
| Campo | Descricao |
|---|---|
| Timestamp | Quando o evento ocorreu |
| Nome do agente | Qual agente gerou a entrada |
| Tipo de evento | O tipo de evento (mensagem recebida, resposta enviada, chamada de ferramenta, erro, etc.) |
| Dados de entrada | A mensagem do cliente ou trigger que iniciou a acao |
| Dados de saida | A resposta do agente ou o resultado retornado por uma ferramenta |
| Detalhes da chamada de ferramenta | Qual ferramenta foi chamada, quais parametros foram enviados e o que a ferramenta retornou |
| Erros | Quaisquer erros ou excecoes encontrados durante o processamento |
Usando logs para solucao de problemas
Aqui estao cenarios comuns em que os logs ajudam a diagnosticar e corrigir problemas:
Agente deu uma resposta errada ou inesperada
Verifique a entrada de log para aquele turno da conversa. Observe:
- As mensagens do sistema que foram enviadas ao modelo (estavam completas e precisas?)
- O historico da conversa que foi incluido (o contexto relevante estava presente?)
- A resposta bruta do modelo (ele entendeu mal a pergunta?)
Uma chamada de ferramenta falhou
Encontre a entrada de log para a chamada de ferramenta. Verifique:
- Os parametros que o agente enviou para a ferramenta (estavam corretos?)
- A mensagem de erro retornada (indica um problema de configuracao, autenticacao ou dados?)
- Se a ferramenta foi chamada (se nao, a descricao da ferramenta pode precisar ser mais clara)
Respostas estao lentas
Compare os timestamps entre o evento de mensagem recebida e o evento de resposta enviada. Se houver um intervalo grande:
- Verifique se uma chamada de ferramenta demorou muito para completar
- Considere se o proprio modelo estava lento (isso pode acontecer com modelos maiores sob carga pesada)
- Revise se as pre-acoes estao adicionando atraso desnecessario
Agente nao esta respondendo
Verifique se existem entradas de log para a conversa. Se nao houver:
- Verifique se o agente esta atribuido ao canal correto
- Confirme que o botao de alternancia do bot esta habilitado para a conversa
- Confirme que o status do agente esta ativo
Crie o habito de revisar os logs apos implantar quaisquer alteracoes nas mensagens do sistema, ferramentas ou pre-acoes de um agente. Uma verificacao rapida das primeiras interacoes dira se tudo esta funcionando como esperado.