Neste artigo você aprende a acompanhar as execuções dos seus Agentes IA no Envia.Click para garantir qualidade e identificar problemas.
O que são execuções (runs)?
Cada vez que um Agente IA processa uma mensagem e responde, o sistema registra uma execução (run). Cada run contém:
- Status — sucesso, handoff, erro.
- Tokens — quantos tokens foram consumidos (entrada + saída).
- Latência — tempo de resposta do LLM.
- Skills chamadas — quais habilidades o agente usou.
- Erro — mensagem de erro, se houver.
Acessando os logs de execução
- No menu lateral, acesse Agentes IA → Execuções (ou clique no agente e vá em Histórico de Runs).
- Você verá a lista de execuções, da mais recente para a mais antiga.
- Clique em uma execução para ver os detalhes.
O que monitorar regularmente
| Métrica | O que indica |
|---|---|
| Taxa de handoff | % das conversas transferidas para humano — se alta, revisar o prompt |
| Tokens médios | Custo médio por resposta — otimize o prompt se muito alto |
| Erros frequentes | Credenciais vencidas, limite de API atingido |
| Latência | Tempo de resposta — valores altos podem indicar sobrecarga |
Interpretando erros comuns
Authentication error— chave de API inválida ou expirada. Atualize em Credenciais.Rate limit exceeded— limite do provedor de IA atingido. Aguarde ou troque de plano/modelo.Timeout— o LLM demorou demais. Tente um modelo mais rápido.
Próximos passos
- Boas práticas e limites — saiba quando não usar IA.
- Configurando o LLM (BYOK) — atualize credenciais se estiver com erros de autenticação.