U
Auditoria, diagnóstico técnico e plano de ação

Proposta
Comercial

Umami Tecnologia

Análise completa do fluxo N8N, mapeamento de bugs, roadmap de correção em três fases e proposta comercial para entrega da Fase 01.

6
bugs identificados
3
agentes analisados
11
tools desconectadas
3
fases de solução
Preparado por Rafaela · Plexo Global
Para Fabíola Santana & Roberta Lopes · Umami
Data Março 2026
01 · Contexto

O que a
Umami tem
e o que falta

A plataforma tem front bem construído, fluxo conceitualmente correto e prompts bem escritos com guardrails, schema JSON e regras anti-alucinação. A base está estruturada, mas temos nodes quebrados, tools desconectadas e agentes utilizando os modelos equivocados para as tarefas designadas.

O que foi bem construído
Roteamento por Switch em next_step, rastreabilidade via Supabase (curadoria_sessoes + curadoria_eventos), 3 agentes especializados, prompts com confidence scores e validações por código.
O que está quebrado
Ferramentas de busca desconectadas nos agentes que precisam delas, modelo de IA com configuração errada para precisão técnica, campos duplicados no payload e referências de sessão com fallback ausente.
02 · Diagnóstico

Os três agentes
lado a lado

Agente 01
Dados de produto
nome · descrição · ficha HTML
Bug crítico #1
0
de 6 tools conectadas
Ferramentas
search_product
search_info
search_amazon
search_image
match_docs (regras)
match_docs_agent01
Sem internet, inventa specs do conhecimento interno.
Agente 02
Categorias
árvore taxonômica Umami
Parcialmente ok
1
de 2 tools conectadas
Ferramentas
search_tree (árvore Umami)
match_docs (regras)
Acessa a árvore real da Umami, por isso entrega os melhores resultados dos três.
Agente 03
Especificações + SEO
dimensões · voltagem · meta
Bugs #3 + #6
0.7
temperature (deveria ser 0.1)
Ferramentas — 1 de 6 ativas
match_docs_agent02
search_tree1
search_product1 / amazon1
search_info1 / image
Modelo de criatividade rodando tarefa de precisão técnica.
03 · Bugs identificados

Os seis problemas
no arquivo JSON

#1
Tools de busca desconectadas — Agente 01
6 ferramentas criadas com "ai_tool": [[]] (array vazio). O agente opera sem internet e fabrica especificações do zero.
#2
Campos duplicados no Set Normaliza
data.product.typecode e data.product.sku definidos duas vezes. Payload com valores ambíguos e comportamento imprevisível.
#3
Modelo errado no Agente 03
GPT-4o com temperature: 0.7, otimizado para criatividade, rodando tarefa de extração técnica precisa. Devia ser 0.1.
#4
registerKey nulo em nova sessão
Set Agente lê registerKey do Supabase. No primeiro acesso o retorno é vazio (sem fallback, o campo chega nulo e quebra o rastreio).
#5
Nó Code ignora EAN / GTIN
Persiste apenas 4 campos no Supabase. O código universal (o identificador mais confiável para busca) nunca é salvo nem repassado.
#6
Tools do Agente 03 também desconectadas
search_tree1, search_product1, search_amazon1, search_info1 e search_image — todos com array vazio.
Os prompts estão bem escritos, com confidence scores, regras anti-alucinação e schema estruturado. O problema está nas configurações, conexões e seleção da IA.
04 · Causa raiz

Por que o workflow não funciona

1
Varejista preenche nome, marca e código
Dados mínimos enviados ao webhook.
2
Set Normaliza duplica campos
Payload chega ao agente com typecode e sku ambíguos.
3
Nó Code não salva EAN/GTIN
O identificador mais confiável para busca web nunca chega ao agente.
4
Switch roteia corretamente para Agente 01
Único ponto do fluxo que funciona como esperado.
5
Agente 01 tenta usar as tools de busca
6 ferramentas chamadas. Nenhuma responde (arrays vazios).
6
Modelo recorre ao conhecimento interno
Gera especificações técnicas plausíveis mas fabricadas.
7
Output Parser valida só a estrutura
JSON com dados inventados passa sem erro. N8N reporta sucesso.
8
Ficha ruim exibida na Umami
Nenhum alerta. Diferença só aparece comparando com busca manual.
Por que é difícil de detectar
O N8N não reporta erro. O fluxo completa com sucesso. O Output Parser garante JSON válido (mesmo quando o conteúdo é inventado).
05 · Solução proposta

Roadmap em
três fases

01
3 semanas
correção
Prioridade imediata
Viabilidade técnica
Correção de todos os bugs, reconexão das tools ao Agente 01, ajuste de modelo e temperatura, validação com produtos reais, documentação e handoff ao vivo.
correção bugs reconexão tools ajuste modelos testes e validações documentação
02
2 semanas
estabilização
Após validação
Importação em massa + Integração contínua
Upload de planilhas em lotes de 50 com fila assíncrona, notificação por e-mail ao varejista quando o lote estiver pronto e fluxo de integração diária.
lotes assíncronos fila de status notif. e-mail integração API
03
3–4 semanas
expansão
Expansão do produto
Vitrine inteligente + Content Creation
Organização automática de vitrine por similaridade, geração de texto e briefing de imagem por produto, tokenização e hooks para redes sociais.
vitrine IA geração conteúdo social hooks tokenização
06 · Escopo técnico

O que será entregue
na Fase 01

Fase 01 — Viabilidade técnica
Entrega Descrição
Diagnóstico documentado Mapeamento completo, análise do JSON linha a linha.
✓ Este documento
Correção dos bugs críticos Campos duplicados, fallback de registerKey, nó Code com EAN/GTIN.
Reconexão das tools Todas as ferramentas de busca conectadas e testadas no Agente 01.
Ajuste de modelo por agente Modelo e temperature corretos para precisão vs. fluência por agente.
Refinamento dos prompts System messages revisados com ferramentas ativas. Prioridade de busca.
Testes com produtos reais 15-20 produtos diferentes + relatório detalhado
Documentação técnica O que foi alterado, como cada agente funciona, como expandir.
Sessão de handoff ao vivo Demonstração com produtos escolhidos por vocês. Aprovação final.
07 · Proposta comercial

Investimento
Fase 01

Investimento total
R$ 5.600
12%OFF à vista, via pix — R$4.928,00
Modelo de pagamento
①
R$ 2.800 na assinatura
Início imediato do trabalho.
②
R$ 2.800 na entrega validada
Após aprovação de vocês na sessão de testes ao vivo.
Semana 1
Correção de bugs e reconexão das tools
JSON corrigido. Primeiros testes internos.
Semana 2
Refinamento dos agentes
Modelos, temperatura e prompts ajustados.
Semana 3
Testes com produtos reais
15-20 produtos diferentes + relatório detalhado
Sem. 3
Documentação + handoff
Aprovação final com vocês.
08 · Modelo de entrega

Compromissos

Comunicação
Updates semanais
Updates pelo WhatsApp com o que foi feito, o que está pendente e eventuais bloqueios que precisem de input de vocês.
Propriedade
100% de vocês
JSON final, prompts, documentação, tudo entregue independente de continuarmos trabalhando juntas nas próximas fases.
Suporte pós-entrega
30 dias incluídos
Dúvidas sobre o fluxo entregue via WhatsApp por 30 dias sem custo adicional. Ajustes estruturais cotados separado.
Próximas fases
Sem lock-in
Fases 02 e 03 cotadas separadamente após a Fase 01 validada. Vocês podem continuar com outra pessoa ou internalizar o trabalho.