Diagnóstico e solução de problemas
Investigue a camada correta antes de reescrever toda a configuração.
Árvore de investigação
- Contexto: workspace, agente e canal estão corretos?
- Estado: o setup aguarda resposta? O agente está suspenso? Qual é o estado efetivo?
- Entrada: há dados suficientes e válidos?
- Conhecimento: a fonte existe, está atual e foi recuperada?
- Permissão: o agente pode executar a operação?
- Ferramenta: a conexão respondeu com sucesso?
- Fluxo: a etapa permite a ação e as condições foram satisfeitas?
- Saída: o resultado foi realmente persistido/entregue?
Sintomas frequentes
| Sintoma | Investigue | Próximo passo |
|---|---|---|
| Agente criado não inicia tarefas | Setup e perguntas pendentes | Responder a pergunta específica e conferir o plano |
| Resposta inventada | Fonte, instrução e limites | Testar a recuperação e o caso sem resposta |
| Resposta correta, ação não realizada | Permissão e retorno da ferramenta | Verificar registro no sistema de destino |
| Contatos duplicados | Identificação e política de merge | Rever chave e confirmação em divergência |
| Funil não corresponde ao editor | Compilação e workflow vigente | Conferir Salvar e compilar e estado executado |
| Follow-up não para | Condição de parada e recebimento da resposta | Verificar canal e Reply-To |
| Memória errada | Escopo, origem, status e retenção | Inspecionar itens e corrigir na ferramenta disponível |
| Embed bloqueado | Origens permitidas | Cadastrar origem explícita e testar no domínio |
| QC reprovado, agente atende | Política efetiva do gate | Conferir “Apenas orienta” e decisão operacional |
| Arquivo não aparece | Filtros, origem e visibilidade | Limpar filtros e conferir Biblioteca |
| Modelo falha repetidamente | Serviço, créditos e fallback | Ler condição de erro e testar caminho de recuperação |
| Horário de rotina incorreto | Fuso e regra do agendamento | Comparar horário exibido e esperado |
Evidência útil para suporte
Registre horário com fuso, workspace, agente, canal, ação tentada, resultado esperado e observado. Acrescente screenshot do estado relevante e identificador do registro quando disponível. Evite enviar senhas, tokens e chaves em capturas.
Mude uma variável por vez
Reescrever prompt, trocar modelo e alterar a base ao mesmo tempo impede saber o que resolveu o problema. Faça a menor mudança coerente, repita o caso e verifique se outros cenários continuam funcionando.
Quando a interface diverge
Registre os dois textos e teste o comportamento real com uma ação controlada. Esta documentação já encontrou divergência no texto de origens do embed e distinção entre resultado do QC e estado de atendimento. Consulte cobertura e observações.