Documentação / Diagnóstico do agente
Diagnóstico do agente
Identifique a etapa que falhou e confirme a correção com um novo teste.
Comece pela execução que apresentou o problema. Anote agente, horário, canal, pergunta e resultado esperado. Isso ajuda a separar falha de áudio, instruções, ferramenta e configuração.
Voz e conexão
| Sintoma | Primeiro passo |
|---|---|
| Microfone bloqueado | Permita o microfone para a origem e use HTTPS ou localhost |
| Conecta, mas você não ouve | Confira saída de áudio, volume e outro dispositivo |
| Transcrição incorreta | Teste ambiente silencioso e confira idioma/STT |
| Responde durante uma pausa | Revise fim de turno |
| Encerra cedo | Confira inatividade, duração disponível e ferramenta de encerramento |
Compare voz com um teste por texto. Se texto responde corretamente e voz não, investigue o áudio antes de reescrever todas as instruções.
Ferramentas e documentos
Se o agente não consulta a API, confirme que a ferramenta está associada ao agente, possui descrição clara e recebeu os parâmetros necessários. Se executa e falha, revise URL, timeout, credencial e resposta do serviço.
Se não encontra informação em documentos, confirme o processamento e a associação do arquivo ao agente. Faça uma pergunta cuja resposta esteja explicitamente no documento. Um arquivo enviado ao workspace não garante que esteja selecionado nas configurações do agente.
Telefonia
Em chamadas recebidas, confira número, provedor e agente associado. Verifique a configuração de telefonia antes de investigar o prompt.
Versão e resultado
Se uma mudança não aparece em novas conversas, confira a versão publicada.
Confirme a correção
Altere uma coisa por vez e repita o mesmo cenário. Guarde o identificador da execução com erro e da execução corrigida. Ao pedir suporte, envie esses identificadores e o passo que falhou, sem chaves de API ou credenciais.