> ## 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.

# Pesquisa de produtos

> Como funcionam os dois motores de pesquisa do Jelou Shop e quando usar cada um.

O Jelou Shop conta com dois motores de pesquisa de produtos. Ambos recebem o que o usuário digita (por exemplo, do [webview](https://docs.jelou.ai/pt/guias/integracoes/e-commerce/webview.md) ou das ferramentas do AI Agent) e devolvem os produtos mais relevantes, mas resolvem o problema de formas diferentes:

| Motor | Abordagem |
| - | - |
| **Pesquisa híbrida** | Entende o significado da consulta, além das palavras. |
| **Pesquisa por texto** | Pesquisa as palavras da consulta diretamente no catálogo. |

## Pesquisa 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 pesquisa por palavras-chave, e combina ambos os resultados em uma única ordem. Tecnicamente, o significado é representado por vetores semânticos (*embeddings*).

> [!NOTE]
>
> A pesquisa híbrida vem habilitada por padrão em todas as lojas.

### Como funciona

```mermaid theme={null}
flowchart LR
    Q["Consulta<br/>do usuário"] -->|"embeddings"| S["Pesquisa<br/>semântica"]
    Q -->|"FTS"| K["Pesquisa por<br/>palavras-chave"]
    S --> M["Combina e ordena<br/>os resultados"]
    K --> M
    M --> R["Produtos<br/>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.

## Pesquisa por texto

Pesquisa diretamente sobre a informação do catálogo, sem serviços de inteligência artificial. Antes de pesquisar, 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 pesquisa de texto completo (FTS).

> [!NOTE]
>
> Ative-a para a sua loja com a opção **Ativar pesquisa inteligente V2** na [configuração do Shop Admin](https://docs.jelou.ai/pt/guias/integracoes/e-commerce/shop-admin.md#configuração). A mudança se aplica de imediato ao webview e às ferramentas do AI Agent.

![Interruptor Ativar pesquisa inteligente V2 na configuração do Shop Admin](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/e-commerce/shop-admin/configuracion-busqueda.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=d1cf5be2a5fedd538cf909e483643f43)

Opção para ativar a pesquisa por texto na configuração do Shop Admin.

### Como funciona

```mermaid theme={null}
flowchart LR
    Q["Consulta<br/>do usuário"] --> P
    subgraph P["Prepara a consulta"]
        direction TB
        A["Acentos e<br/>maiúsculas"] ~~~ S["Sinônimos"]
        W["Palavras<br/>a ignorar"] ~~~ M["Marcas"]
    end
    P -->|"FTS"| I["Pesquisa no índice<br/>nome · SKU · categorias"]
    I --> R["Produtos ordenados<br/>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**: pesquisar `camiseta vermelha` não devolve tudo que é vermelho nem todas as camisetas, só camisetas vermelhas.
* **Leva as categorias em conta**: pesquisar `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 à pesquisa, 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 pesquisa 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

| | Pesquisa híbrida | Pesquisa por texto |
| - | - | - |
| **Como pesquisa** | 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 pesquisa** | Adicional (serviços de IA) | Sem custo adicional |
| **Consistência de resultados** | Média | Alta |

## Qual usar?

| Cenário | Motor recomendado |
| - | - |
| O usuário pesquisa por SKU, código ou nome exato | Pesquisa por texto |
| Catálogo técnico: peças, ferragens, farmácia | Pesquisa por texto |
| Prioridade em velocidade e custo | Pesquisa por texto |
| Consultas conversacionais longas de um chatbot | Pesquisa híbrida |
| Consultas descritivas: "algo para o frio", "presente para a mãe" | Pesquisa híbrida |
| O vocabulário do usuário difere muito do catálogo | Pesquisa híbrida |

Se não sabe qual convém para o seu catálogo, contate a equipe da Jelou.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.