Voltar para Central de Manuais
# Manual Troubleshooting Agentes ## Cenário 1: agente retorna zero e o relatório não Passos: 1. validar nome com LIKE e variações de grafia 2. validar período no campo de data correto 3. remover filtro mais restritivo e reexecutar 4. validar status excluídos 5. validar joins de entidade (grupo -> cliente -> coleta -> cte) 6. validar resolução robusta de coleta para CTE por cliente/grupo: `COALESCE(ct.id_coleta, r.id_coleta, cte_pai.id_coleta)` ## Cenário 2: lentidão ou timeout - reduzir período (ex.: 12 meses -> 3 meses) - limitar escopo por cliente/grupo - usar agregação mensal antes de detalhamento ## Cenário 3: resultado inconsistente entre agentes - forçar "modo paridade de relatório" - exigir metodologia na resposta - repetir query base do playbook ## Cenário 4: sem dados ML - executar treino: - inadimplência - forecast faturamento - validar tabelas ML e registros por `referencia_data` ## Escalonamento - se divergência persistir após checklist, abrir chamado técnico com: - prompt usado - período - SQL retornado - número esperado (relatório)