FT-REPORTS-INSIGHTS-LLM· 1.0.0Roadmap
Insights IA em /relatorios — narrativa executiva do período
Card no topo de /relatorios com narrativa LLM em linguagem comum. Em 2-3 linhas você entende o que merece atenção.
Atualizado em 5/18/2026
O que é
No topo de
/relatorios/empresa/[id] aparece um card "Insight IA" com narrativa em PT/EN/ES gerada por Anthropic Sonnet 4.6. Lê os números agregados do período (volume, taxa de sucesso, top parceiros, erros por categoria, comparativo vs período anterior) e escreve 2-3 linhas focando no que merece ação.Exemplo: "Volume cresceu 23% no período, mas Walmart concentrou 3x mais erros que a média — provavelmente schema desatualizado. Outras 4 integrações estáveis."
Como gerar
Primeira vez: botão "Gerar primeiro insight" no empty state do card.
Depois: botão "Regenerar" pequeno no header do card.
Rate limit: 1 geração manual por tenant em 24h. Tenta de novo no mesmo dia → HTTP 429 com mensagem amigável.
Idiomas
Narrativa gerada em PT/EN/ES na mesma chamada (Sonnet retorna JSON estruturado com 3 chaves). Economia de 3x vs gerar separadamente. UI mostra no locale atual do usuário.
Custo
- ~$0.04 por geração (Sonnet, ~1500 input + ~600 output tokens × 3 idiomas em 1 chamada)
- Cap por tenant: ~$1.20/tenant/mês (1 manual/dia × 30 dias)
- Logado em
ai_usage_events(feature = "reports-insights")
Armazenamento
Tabela
ai_insights_cache:
- Uma row por geração (histórico preservado)
- UI mostra a mais recente (
ORDER BY generated_at DESC LIMIT 1) - Campos:
narrative_pt,narrative_en,narrative_es,model,input_tokens,output_tokens,cost_usd,dimensions_hash(SHA-256 dos inputs pra dedup) - RLS: leitura pelo user do tenant + super_admin/support
Não tem ainda (follow-up)
- Cron noturno gerando automaticamente todo dia — hoje só manual
- Períodos customizáveis (default fixo 30d)
- Histórico de narrativas — só vê a mais recente
Estilo do prompt
System prompt instrui Sonnet a:
- Máximo 2-3 frases
- Liderar com observação mais acionável (não com volume genérico)
- Citar nomes específicos (parceiro, categoria) quando relevante
- Sem jargão técnico
- Sem mencionar "SLA" como promessa contratual
- JSON estruturado puro, sem markdown
Histórico de versões
- 1.0.0
Narrativa LLM no topo de /relatorios — diferencial vendável vs iPaaS genéricos. Cliente abre report e em 2-3 linhas entende o que merece atenção, ideal pra mandar pra diretoria. Stack: tabela ai_insights_cache (com narrative_pt/en/es + audit + RLS), helper generateInsights() que chama Anthropic Sonnet 4.6 (3 idiomas em 1 chamada, economia 3x), endpoint /api/reports/regenerate-insights com rate limit 1/24h/tenant + telemetria em ai_usage_events, componente AiInsightsCard cliente com empty state CTA + botão regenerar + erro inline. Custo ~$0.04/geração, cap ~$1.20/tenant/mês. PR #61.
5/18/2026 · new