Estatísticas de chamadas de ferramentas e alertas de falha
Monitore como suas ferramentas funcionam, examine chamadas com falha e defina limites de alerta.
Onde fica?
No topo da página “Ferramentas”, há três abas: “Ferramentas”, “Estatísticas de chamadas” e “Configurações de registro e alerta”. Todos os membros podem ver as estatísticas; alterar as configurações exige a função de proprietário ou administrador.
Estatísticas de chamadas
Escolha um período no topo (hoje, ontem, os últimos 7, 30 ou 90 dias, todo o período ou um período personalizado). O padrão são os últimos 7 dias.
Uma chamada conta como bem-sucedida quando sua ferramenta retorna uma resposta 2xx, mesmo que a própria resposta indique um erro. Se a nova tentativa em caso de falha estiver ativada, todas as tentativas contam como uma chamada.
- Resumo: número de chamadas bem-sucedidas e com falha, taxa de sucesso e duração média.
- Gráficos: chamadas por dia, chamadas com falha por dia e um detalhamento por ferramenta. Chamadas de teste não contam nos gráficos, mas aparecem no registro de chamadas.
- Alertas abertos: ferramentas que continuam falhando aparecem em uma única caixa no topo da página, uma por linha; o link em cada linha leva às chamadas com falha daquela ferramenta. O histórico de alertas fechados fica no fim da página.
- Registro de chamadas: filtre por ferramenta, status e origem (agente, etapa de escolha, etapa de chamada de ferramenta, teste). Clicar em uma linha mostra os detalhes do erro, o status HTTP, a duração, o tamanho da resposta, o texto de erro da ferramenta, os campos enviados (e-mails e números longos ficam ocultos) e o agente e a sessão. O corpo de uma resposta bem-sucedida não é armazenado.
As ferramentas do agente da loja (busca de produtos, status do pedido…) não são contadas aqui; você as encontra em Integrações › “Estatísticas de ações”.
Configurações de registro e alerta
- “Prazo de retenção”: por quantos dias os registros detalhados das chamadas são mantidos (1 a 30 dias, padrão 7). As contagens são permanentes; só os detalhes são excluídos ao fim do prazo.
- “Janela de tempo” e “Limite”: um alerta abre quando pelo menos o número de chamadas do limite (1 a 1000, padrão 5) falha dentro da janela de tempo (5 a 1440 minutos, padrão 15).
Quando uma chamada funciona e o número de falhas cai abaixo do limite, o alerta fecha sozinho e uma notificação de “funcionando de novo” é enviada. Uma ferramenta com alerta aberto mostra o selo “Falhando” na lista de ferramentas.
A janela de tempo e o limite também são usados no alerta de falha do fornecedor nas integrações; os alertas de integração saem com a notificação “Falha de etapa de integração”. Escolha para qual canal vão os alertas de ferramentas (Slack, Teams, Telegram, e-mail) com a notificação “Falha de ferramenta” na página “Alertas e notificações”.
Artigos relacionados
- Ferramentas: conectar o agente aos seus próprios sistemasAdicione seus próprios endpoints HTTPS que o agente chama durante uma conversa para buscar dados ao vivo ou executar uma ação.
- Alertas e notificações: qual evento vai para qual canal?Direcionar alertas de novas solicitações, créditos e erros para Slack, Teams, Telegram ou e-mail e acompanhar as entregas.
- Onde posso monitorar a saúde das ações de integração?A página “Estatísticas de ações” mostra cada tarefa que suas etapas de fluxo e o agente executam nas integrações, as falhas e os motivos.