Assistente IA no cadastro de produto
Tem produto novo para cadastrar mas e difícil pensar em descrição boa, NCM correto e atributos úteis? Esse assistente faz uma proposta a partir de uma descrição curta.
Onde fica
Na tela de Cadastrar produto, no topo, você vê um botao Assistente IA com ícone de robo.
Funciona em produto novo (criando do zero) e em produto existente (para complementar).
Como usar
1. Abrir o assistente
- Va em Produtos > Novo produto.
- Digite ao menos uma descrição básica no campo Descrição (ex.: "Café Pilao tradicional 500g").
- Clique em Assistente IA.
2. Refinar o pedido
Um modal abre com:
- A descrição básica que você digitou (editavel).
- Campos opcionais para dar mais contexto:
- Categoria (se já sabe a qual pertence).
- Marca / fabricante.
- Unidade (UN, KG, L, CX, etc.).
- Observações livres (ex.: "produto de torrefacao média, embalagem a vacuo, codigo do fornecedor XYZ").
Quanto mais contexto, melhor a sugestao.
3. Gerar
Clique em Gerar sugestao. Em 5 a 10 segundos a IA devolve:
| Campo | O que a IA propoe |
|---|---|
| Descrição curta | Versão limpa de 60 caracteres |
| Descrição completa | Texto rico de 300-500 caracteres com beneficios, modo de uso, especificacoes |
| NCM sugerido | Codigo + descrição oficial Receita |
| CEST (se aplicavel) | Codigo + descrição |
| Unidade | Se você não informou |
| Grupo / categoria | Sugestao com base no catalogo existente |
| Marca / fabricante | Sugestao se conseguiu identificar |
| Atributos | Lista de chave/valor (ex.: "Tipo: tradicional", "Peso liquido: 500g", "Embalagem: a vacuo") |
| Palavras-chave | Termos úteis para busca interna |
4. Revisar e aplicar
Cada sugestao vem com checkbox ao lado. Você:
- Mantem o que gostou.
- Desmarca o que não quer.
- Edita inline o que precisa ajustar.
- Clica em Aplicar selecionados.
Os campos vão para o formulario do produto. Salve normal.
Sempre revise NCM e CEST
A IA da uma sugestao de NCM/CEST baseada na descrição — pode acertar muito ou errar. Para tributação, confirme com seu contador ou consulte o NCM oficial no portal da Receita Federal antes de usar produtos com cargas tributárias altas.
Exemplo prático
Você vai cadastrar uma cerveja nova.
O que você digita:
- Descrição básica: "Cerveja Heineken long neck 330ml"
O que a IA devolve:
| Campo | Sugestao |
|---|---|
| Descrição curta | "Cerveja Heineken Lager Long Neck 330ml" |
| Descrição completa | "Cerveja premium da marca Heineken, estilo Pilsen Lager, com 5% de teor alcoólico. Embalagem long neck de 330ml, ideal para consumo individual. Produção holandesa..." |
| NCM | 2203.00.00 — Cervejas de malte |
| CEST | 03.011.00 — Cerveja sem alcool / com alcool |
| Unidade | UN |
| Categoria sugerida | Bebidas > Cervejas |
| Marca | Heineken |
| Fabricante | Heineken Brasil |
| Atributos | Tipo: Lager / Volume: 330ml / Teor alcoólico: 5% / Embalagem: Long neck |
Você aprova/edita, clica Aplicar, e o formulario fica preenchido. Falta só confirmar preço, custo e estoque inicial.
Limites e cuidados
- A IA não busca a internet em tempo real. Ela trabalha com o conhecimento do modelo. Para produtos muito novos ou regionais, pode errar.
- A IA não garante NCM correto para fins fiscais. Sempre revise com seu contador, principalmente para regimes especiais (ST, Monofasico, Pis/Cofins concentrado).
- A descrição completa pode soar generica se você não deu contexto. Quanto mais detalhe na entrada, mais especifica a saída.
- Atributos são sugeridos automaticamente, mas você decide quais ficam. Atributos demais poluem o cadastro.
Custom dicas
- Coloque codigo do fornecedor ou EAN nas observações — a IA tenta inferir produtos conhecidos pelo codigo.
- Diga público-alvo se for relevante ("infantil", "pet", "diabetico").
- Se um produto tem caractereística importante para venda (organico, vegano, importado), mencione — vai para a descrição completa.
Onde não usar
- Produtos com tributação especifica (medicamentos, combustiveis, armas) — sempre validar manualmente.
- Produtos que você já tem cadastrados similares — copie de um existente ao inves.
- Serviços (a IA esta calibrada para produtos fisicos).
Auditoria
Aplicações desse assistente não geram log de auditoria porque são só sugestoes que você aprovou e aplicou num cadastro novo. O log normal de criacao de produto registra a criacao, mas não distingue se foi via IA ou digitado manualmente.
Se quiser saber depois "esse cadastro foi assistido por IA?", a única pista e olhar o histórico do produto — produtos cadastrados via IA costumam ter descrições mais completas que produtos manuais.
Configuração técnica
A funcionalidade requer chave de acesso da OpenAI configurada no tenant pelo time do Manto. Por padrão usa o modelo gpt-4o-mini. Para tenants que precisam de qualidade maior, da pra subir para gpt-4o mediante solicitacao (custo maior).