Consultar os logs do Opa! IA
Caminho: Menu lateral → Opa! IA → Analytics → Logs
Visão geral
Os logs do Opa! IA registram cada chamada feita à inteligência artificial: qual assistente e qual modelo foram usados, quanto custou, quanto tempo levou e se deu certo. Eles servem para auditar o consumo e para entender por que um assistente respondeu de determinada forma.
Esta página explica o que cada coluna mostra e o que aparece no detalhe de uma operação.
O que aparece na lista
Cada linha é uma operação com a IA. As colunas são:
| Coluna | O que mostra |
|---|---|
| Protocolo | O protocolo do atendimento em que a IA atuou. |
| Data | Quando a operação aconteceu. |
| Assistente | O assistente inteligente que fez a operação. |
| Tipo | O tipo da operação com a IA. |
| Modelo | O modelo de IA usado. |
| Custo | O valor consumido pela operação, com seis casas decimais, porque cada chamada costuma custar frações de centavo. |
| Duração | O tempo que a operação levou, em milissegundos (ms). |
| Status da operação | O resultado da chamada à IA. Aparece Success, em verde, quando deu certo. Quando falha, aparece a mensagem de erro, em vermelho. |
| Status do log | O resultado do registro da operação nos logs, também em verde (Success) ou em vermelho (mensagem de erro). |
Como consultar
- Acesse Opa! IA → Analytics → Logs.
- Use a busca para localizar uma operação, por exemplo pelo protocolo do atendimento.
- Abra os filtros para refinar por Data ou por Assistente inteligente.
- Clique no botão de sincronizar para atualizar a lista com as operações mais recentes.
- Clique em uma linha para abrir o Detalhe da operação.
O que aparece no detalhe da operação
A janela Detalhe da operação mostra, no topo, o tipo da operação. Nas operações de conversa com o assistente, ela traz:
- Requisição: as mensagens enviadas à IA, incluindo as instruções do assistente e o histórico da conversa, e as ferramentas disponíveis.
- Resposta: o que a IA devolveu, como a mensagem para o cliente e as chamadas de ferramenta (por exemplo, uma transferência ou uma consulta à base do conhecimento).
Se a operação não tiver detalhe registrado, aparece Nenhum detalhe de operação registrado.
A requisição inclui as mensagens trocadas com o cliente e as instruções do assistente. Libere o acesso ao Opa! IA só para quem precisa auditar essas informações. Veja Criar e configurar um grupo de permissão.
Quando consultar os logs
- Consumo acima do esperado: procure, na coluna Custo, as operações mais caras e veja qual assistente e qual modelo geraram esse valor.
- Resposta inesperada do assistente: abra o detalhe da operação para ver as instruções e o histórico que a IA recebeu, e ajuste o assistente. Veja Como estruturar o prompt do assistente.
- Falha de uma operação: localize o Status da operação em vermelho, leia a mensagem de erro e compare com o horário do problema.
Boas práticas
- Use o protocolo para ligar a operação ao atendimento que o cliente reclamou.
- Combine os logs com o painel de Performance do Opa! IA para ir do número geral ao caso específico.
- Ajuste o assistente a partir do que a IA realmente recebeu, não do que você imagina que ela recebeu.