Propriedades personalizadas
Visão Geral
As propriedades personalizadas permitem que você capture atributos específicos do seu negócio que não cabem nos campos padrão do produto (preço, marca, categoria). Uma propriedade personalizada tem um tipo de dado —número, texto, caixa, data ou opções múltiplas— e é atribuída a cada produto com seu próprio valor. É o que permite ao agente IA filtrar com precisão perguntas como "produtos com menos de 10 kg", "de cor azul", "resistentes à água" ou "lançados depois de 2024".
Como Acessar
- Navegue até Catálogo de Vendas > Configurações > Propriedades personalizadas (
/sales/settings#properties). - Também disponível na rota direta
/sales/properties. - Função necessária: Administrador.
Visão Geral da Interface
A tela exibe:
- Lista de propriedades definidas — Tabela com nome, tipo de dado, quantidade de produtos que a usam e ações (editar/excluir).
- Botão Adicionar propriedade — Abre o formulário para definir uma nova.
- Se a propriedade é do tipo Opções múltiplas, você verá também a lista de opções disponíveis.
Uma vez definida a propriedade, você atribui valores a cada produto a partir da página de detalhe do produto (não a partir desta tela).
Tipos de dado
A Aurora suporta cinco tipos. Escolha o tipo de acordo com como você quer que o agente filtre.
Número
Para grandezas com unidade implícita: peso, volume, voltagem, quantidade. Habilita filtros do tipo "maior que", "menor que" ou "entre X e Y".
Exemplos: Peso (kg), Voltagem (V), Capacidade (L), Quantidade de páginas.
Texto
Para etiquetas livres. Habilita filtros de correspondência exata e de "contém". Útil quando os valores são muito variados para listá-los como opções.
Exemplos: Material principal, Descrição técnica, Origem, Modelo do fabricante.
Caixa (booleano)
Uma propriedade sim/não. Habilita filtros do tipo "sim" ou "não".
Exemplos: Resistente à água, Apto para vegetarianos, Sem glúten, Garantia estendida incluída.
Data
Para datas relevantes do produto. Habilita filtros do tipo "antes de", "depois de" ou "entre duas datas".
Exemplos: Data de lançamento, Data de validade, Início da promoção.
Opções múltiplas
Uma propriedade com uma lista fechada de valores pré-definidos. Habilita filtros de correspondência exata e de "qualquer um de". É a melhor opção quando os valores se repetem em muitos produtos e você quer que o agente os reconheça sem ambiguidade.
Exemplos: Cor (Vermelho, Azul, Verde, Preto…), Tamanho (PP, P, M, G, GG), Estilo, Tipo de tecido.
Funcionalidades e Ações
Criar uma propriedade personalizada
O que faz: Define um novo atributo que você poderá atribuir aos produtos.
Passos:
- Clique em Adicionar propriedade.
- Digite um Nome descritivo (por exemplo, "Peso", "Cor", "Resistente à água").
- Escolha o Tipo de dado (Número, Texto, Caixa, Data, Opções múltiplas).
- Se escolheu Opções múltiplas, adicione a lista de opções disponíveis (uma por linha ou no editor).
- Se escolheu Número ou Data, você pode definir uma faixa sugerida ou uma unidade de medida.
- Clique em Salvar.
Notas importantes:
- O nome é o que o agente IA usa internamente para mapear perguntas do cliente. Escolha nomes claros e consistentes ("Peso" melhor que "Pso" ou "Peso do produto").
- Uma vez criada, não recomendamos mudar o tipo de dado —os valores atribuídos ficariam inconsistentes. Se precisa mudar, crie uma propriedade nova.
Atribuir um valor a um produto
O que faz: Define o valor da propriedade para um produto específico.
Passos:
- Abra o detalhe do produto (
/sales/products/:id). - Vá para a seção Propriedades personalizadas.
- Para cada propriedade definida no catálogo, você verá um campo ou seletor adequado ao tipo.
- Atribua o valor e salve.
Editar uma propriedade
O que faz: Muda o nome ou (se aplicável) as opções disponíveis.
Passos:
- Na lista de propriedades, clique em Editar.
- Ajuste o nome ou (para opções múltiplas) adicione/remova opções.
- Salve.
Notas importantes:
- Renomear uma propriedade não quebra os valores já atribuídos.
- Remover uma opção de Opções múltiplas que já está em uso requer que nenhum produto a tenha atribuída.
Excluir uma propriedade
O que faz: Apaga a propriedade e os valores atribuídos a produtos.
Passos:
- Na lista de propriedades, clique em Excluir.
- Confirme.
Notas importantes:
- Esta ação exclui os valores atribuídos em todos os produtos. Não pode ser desfeita.
Como o agente IA as usa
Quando um cliente faz uma pergunta, o agente IA observa os nomes e tipos das suas propriedades personalizadas e constrói filtros estruturados conforme apropriado:
- "Produtos com menos de 10 kg" → filtro Peso < 10 (se Peso for do tipo Número).
- "De cor azul" → filtro Cor = Azul (se Cor for do tipo Opções múltiplas com Azul como opção).
- "Resistentes à água" → filtro Resistente à água = Sim (se a propriedade for do tipo Caixa).
- "Lançados depois de 2024" → filtro Data de lançamento > 2024-01-01 (se for do tipo Data).
- "Com material algodão" → filtro Material contém "algodão" (se for do tipo Texto).
Se o cliente não menciona um atributo, o agente não o adiciona como filtro automaticamente —não assume contexto que o cliente não forneceu. Isto preserva a qualidade dos resultados.
Notas Importantes
- Poucas e bem nomeadas funciona melhor que muitas e vagas. Uma dezena de propriedades claras é preferível a 50 difusas.
- As Opções múltiplas são o tipo mais confiável para cores, tamanhos, estilos: o agente as reconhece sem ambiguidade quando o cliente as menciona.
- Os valores numéricos devem estar na mesma unidade por propriedade. Não misture "10 kg" com "10000 g" na mesma propriedade —escolha uma unidade e mantenha-a.
Perguntas Frequentes
P: Que tipo escolho para "cor"? R: Opções múltiplas com sua paleta fechada. Garante que o agente diferencie "vermelho" de "vermelho escuro" se você os listar como opções distintas.
P: Posso atribuir vários valores de uma opção múltipla ao mesmo produto? R: Sim, em propriedades do tipo Opções múltiplas você pode atribuir mais de uma opção ao mesmo produto quando aplicável (por exemplo, várias cores disponíveis).
P: As propriedades são importadas via CSV? R: Sim. A importação suporta colunas mapeadas para propriedades personalizadas. Consulte Importação do catálogo.
P: O agente IA conhece todas as propriedades automaticamente? R: Sim, quando o catálogo está ativado para o agente, ele recebe a lista de propriedades, seus tipos e (para opções múltiplas) os valores disponíveis. Você não precisa configurar isso em cada agente.