Monitoramento de Conversas
A própria página de Chat/Teste serve também como central de monitoramento. À esquerda, a lista de conversas exibe todas as threads ativas ou recentes em que o Agente está envolvido — sejam elas abertas pela UI, WhatsApp, SIP ou API.
1. Visão geral da lista
| Coluna | O que indica |
|---|---|
| Título / ID | Se a thread já recebeu um título automático (primeira mensagem do usuário) ele aparece; caso contrário, o id curto (thr_…). |
| Ícone de trigger | UI, API, logo do WhatsApp, ícone SIP, etc. Ajuda a identificar o canal de origem. |
| Status | Ativa, Em execução, Fechada, Pendente. |
| Tempo | Data/hora da última mensagem. |
Retenção
Para contas Free, conversas são mantidas por 7 dias e depois removidas automaticamente.
2. Acessando detalhes
Clique em qualquer item da lista para abrir o histórico completo no painel central. O comportamento varia conforme o acionador:
| Trigger | Interação via UI | Observações |
|---|---|---|
| UI | Leitura e envio de mensagens | Ambiente de teste padrão. |
| API | Leitura; envio opcional se a aplicação permitir | Útil para depuração de integrações backend. |
| Leitura somente | Evita duplicar mensagens ou violar políticas de template. | |
| SIP / WebRTC | Leitura somente | Audio em tempo real é tratado no canal de voz; UI exibe transcrições. |
Mesmo em modo somente leitura você pode:
- Encerrar a conversa (⋮ → Encerrar).
- Reabrir se necessário.
- Ver métricas de contexto, ferramentas usadas e custos na Sidebar.
3. Indicadores de status
| Status | Descrição | Ações disponíveis |
|---|---|---|
Pendente | Thread criada mas sem mensagens de usuário. | Encerrar. |
Ativa | Aguardando próxima mensagem. | Enviar (se UI/API), Encerrar. |
Em execução | Agente processando ou transmitindo resposta. | Aguardar; possível forçar Encerrar. |
Fechada | Conversa finalizada; pós‑análise executada. | Reabrir ou excluir. |
4. Casos de uso comuns
4.1 Suporte em vários canais
Filtre rapidamente por Trigger = WhatsApp para ver todos os atendimentos em curso nesse canal e o tempo de última interação.
4.2 Auditoria de custos
Abra a Sidebar de uma thread longa para conferir:
- Tokens gastos / limite do modelo.
- Ferramentas acionadas (ex.: chamadas RAG, API externas).
- Custo total acumulado.
4.3 Depurar integrações API
Se a aplicação enviou mensagens via /stream, a lista mostra atualizações de status em tempo real (Em execução). Caso algo fique travado, você pode Encerrar a thread manualmente e inspecionar o log de mensagens para identificar o passo que falhou.
4.4 Visualizar passos internos
Através da interface de monitoramento é possível ver todos os passos que o Agente executou, incluindo chamadas de ferramentas, respostas parciais e mensagens de erro. Isso ajuda a entender o fluxo de raciocínio do Agente e identificar possíveis melhorias nas instruções ou ferramentas.