> ## Documentation Index > Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt > Use this file to discover all available pages before exploring further. # Busca de produtos > Como funcionam os dois motores de busca do Jelou Shop e quando usar cada um. O Jelou Shop conta com dois motores de busca de produtos. Ambos recebem o que o usuário digita (por exemplo, do [webview](/pt/guias/integracoes/e-commerce/webview) ou das ferramentas do AI Agent) e devolvem os produtos mais relevantes, mas resolvem o problema de formas diferentes: | Motor | Abordagem | | ------------------- | ------------------------------------------------------ | | **Busca híbrida** | Entende o significado da consulta, além das palavras. | | **Busca por texto** | Busca as palavras da consulta diretamente no catálogo. | ## Busca híbrida Usa inteligência artificial para entender o **significado** do que o usuário digita e compará-lo com o de cada produto do catálogo. Em paralelo também busca por palavras-chave, e combina ambos os resultados em uma única ordem. Tecnicamente, o significado é representado por vetores semânticos (*embeddings*). A busca híbrida vem habilitada por padrão em todas as lojas. ### Como funciona ```mermaid theme={null} flowchart LR Q["Consulta
do usuário"] -->|"embeddings"| S["Busca
semântica"] Q -->|"FTS"| K["Busca por
palavras-chave"] S --> M["Combina e ordena
os resultados"] K --> M M --> R["Produtos
relevantes"] ``` Ao entender o *significado* da consulta, encontra produtos mesmo que o usuário não use as palavras exatas do catálogo: "algo para o frio" pode devolver jaquetas e casacos mesmo que nenhum mencione "frio". ### Vantagens * Entende linguagem natural e intenção de compra, não só palavras exatas. * Encontra produtos mesmo quando o usuário usa vocabulário diferente do catálogo. * Reduz as respostas sem resultados em consultas gerais ou descritivas. ### Limitações * É mais lenta: cada consulta passa por serviços de inteligência artificial antes de devolver resultados. * Tem um custo adicional por consulta (serviços de IA). * É menos precisa com códigos exatos, como os SKU. * A ordem dos resultados é menos previsível: duas consultas parecidas podem ordenar diferente. ## Busca por texto Busca diretamente sobre a informação do catálogo, sem serviços de inteligência artificial. Antes de buscar, limpa e prepara a consulta, e depois a compara com o nome, o SKU, as categorias e a descrição de cada produto. Tecnicamente, apoia-se na busca de texto completo (FTS). Ative-a para a sua loja com a opção **Ativar busca inteligente V2** na [configuração do Shop Admin](/pt/guias/integracoes/e-commerce/shop-admin#configuração). A mudança se aplica de imediato ao webview e às ferramentas do AI Agent. Interruptor Ativar busca inteligente V2 na configuração do Shop Admin ### Como funciona ```mermaid theme={null} flowchart LR Q["Consulta
do usuário"] --> P subgraph P["Prepara a consulta"] direction TB A["Acentos e
maiúsculas"] ~~~ S["Sinônimos"] W["Palavras
a ignorar"] ~~~ M["Marcas"] end P -->|"FTS"| I["Busca no índice
nome · SKU · categorias"] I --> R["Produtos ordenados
por relevância"] ``` Pontos-chave: * **Ignora acentos e maiúsculas**: `cafe` encontra `café`. * **Entende singular e plural**: `camiseta` encontra `camisetas`. * **Todos os termos devem coincidir**: buscar `camiseta vermelha` não devolve tudo que é vermelho nem todas as camisetas, só camisetas vermelhas. * **Leva as categorias em conta**: buscar `camiseta` encontra produtos da categoria "Camisetas" mesmo que o nome do produto não a mencione. * **Sinônimos próprios da sua loja**: você pode ensinar que `tv` = `televisor`. * **Palavras a ignorar**: descarta palavras que só adicionam ruído à busca, como "quero" ou "barato". * **Reconhece as marcas da sua loja**: você pode registrar suas marcas para que sejam detectadas na consulta e usadas ao filtrar os resultados. * **Tolerância a erros de digitação** (opcional): `Xioami` encontra `Xiaomi`. ### Vantagens * Muito rápida e de baixo custo: não depende de serviços externos. * Precisa: excelente para SKU, nomes de produto e catálogos com vocabulário técnico. * Resultados consistentes: a mesma busca sempre devolve os mesmos produtos. * Personalizável por loja: sinônimos, palavras a ignorar e marcas. ### Limitações * Só encontra o que está escrito: se o termo não aparece no nome, SKU, categoria ou descrição do produto (nem nos sinônimos configurados), não há resultados. * Não entende consultas descritivas como "algo para o frio" ou "presente para a mãe". * O vocabulário particular dos seus clientes pode exigir configurar sinônimos. ## Comparação | | Busca híbrida | Busca por texto | | ------------------------------ | -------------------------------- | -------------------------- | | **Como busca** | Por significado e palavras-chave | Pelas palavras do catálogo | | **Entende linguagem natural** | Sim | Não | | **Sinônimos** | Automáticos | Configuráveis por loja | | **Acentos e plurais** | Sim | Sim | | **Erros de digitação** | Tolerante | Tolerância opcional | | **SKU / código exato** | Regular | Excelente | | **Velocidade** | Mais lenta (usa serviços de IA) | Muito rápida | | **Custo por busca** | Adicional (serviços de IA) | Sem custo adicional | | **Consistência de resultados** | Média | Alta | ## Qual usar? | Cenário | Motor recomendado | | ---------------------------------------------------------------- | ----------------- | | O usuário busca por SKU, código ou nome exato | Busca por texto | | Catálogo técnico: peças, ferragens, farmácia | Busca por texto | | Prioridade em velocidade e custo | Busca por texto | | Consultas conversacionais longas de um chatbot | Busca híbrida | | Consultas descritivas: "algo para o frio", "presente para a mãe" | Busca híbrida | | O vocabulário do usuário difere muito do catálogo | Busca híbrida | Se não sabe qual convém para o seu catálogo, contate a equipe da Jelou.