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

# Búsqueda de productos

> Cómo funcionan los dos motores de búsqueda de Jelou Shop y cuándo usar cada uno.

Jelou Shop cuenta con dos motores de búsqueda de productos. Ambos reciben lo que escribe el usuario (por ejemplo, desde el [webview](/guides/integraciones/e-commerce/webview) o las herramientas del AI Agent) y devuelven los productos más relevantes, pero resuelven el problema de formas distintas:

| Motor                  | Enfoque                                                         |
| ---------------------- | --------------------------------------------------------------- |
| **Búsqueda híbrida**   | Entiende el significado de la consulta, además de las palabras. |
| **Búsqueda por texto** | Busca las palabras de la consulta directamente en el catálogo.  |

## Búsqueda híbrida

Usa inteligencia artificial para entender el **significado** de lo que escribe el usuario y compararlo con el de cada producto del catálogo. En paralelo busca también por palabras clave, y combina ambos resultados en un solo orden. Técnicamente, el significado se representa mediante vectores semánticos (*embeddings*).

<Note>
  La búsqueda híbrida viene habilitada por defecto en todas las tiendas.
</Note>

### Cómo funciona

```mermaid theme={null}
flowchart LR
    Q["Consulta<br/>del usuario"] -->|"embeddings"| S["Búsqueda<br/>semántica"]
    Q -->|"FTS"| K["Búsqueda por<br/>palabras clave"]
    S --> M["Combina y ordena<br/>los resultados"]
    K --> M
    M --> R["Productos<br/>relevantes"]
```

Al entender el *significado* de la consulta, encuentra productos aunque el usuario no use las palabras exactas del catálogo: "algo para el frío" puede devolver chaquetas y abrigos aunque ninguno mencione "frío".

### Ventajas

* Entiende lenguaje natural e intención de compra, no solo palabras exactas.
* Encuentra productos aunque el usuario use vocabulario distinto al del catálogo.
* Reduce las respuestas sin resultados en consultas generales o descriptivas.

### Limitaciones

* Es más lenta: cada consulta pasa por servicios de inteligencia artificial antes de devolver resultados.
* Tiene un costo adicional por consulta (servicios de IA).
* Es menos precisa con códigos exactos, como los SKU.
* El orden de los resultados es menos predecible: dos consultas parecidas pueden ordenarse distinto.

## Búsqueda por texto

Busca directamente sobre la información del catálogo, sin servicios de inteligencia artificial. Antes de buscar, limpia y prepara la consulta, y luego la compara contra el nombre, el SKU, las categorías y la descripción de cada producto. Técnicamente, se apoya en la búsqueda de texto completo (FTS).

<Note>
  Actívala para tu tienda con la opción **Activar búsqueda inteligente V2** en la [configuración de Shop Admin](/guides/integraciones/e-commerce/shop-admin#configuración). El cambio aplica de inmediato al webview y a las herramientas del AI Agent.
</Note>

<Frame caption="Opción para activar la búsqueda por texto en la configuración de Shop Admin.">
  <img src="https://mintcdn.com/jelouai/_wI44Mvyq_90IbBI/assets/images/integraciones/e-commerce/shop-admin/configuracion-busqueda.png?fit=max&auto=format&n=_wI44Mvyq_90IbBI&q=85&s=e733d2efa270a222c498bc211b41c374" alt="Interruptor Activar búsqueda inteligente V2 en la configuración de Shop Admin" width="1200" height="170" data-path="assets/images/integraciones/e-commerce/shop-admin/configuracion-busqueda.png" />
</Frame>

### Cómo funciona

```mermaid theme={null}
flowchart LR
    Q["Consulta<br/>del usuario"] --> P
    subgraph P["Prepara la consulta"]
        direction TB
        A["Acentos y<br/>mayúsculas"] ~~~ S["Sinónimos"]
        W["Palabras<br/>a ignorar"] ~~~ M["Marcas"]
    end
    P -->|"FTS"| I["Busca en el índice<br/>nombre · SKU · categorías"]
    I --> R["Productos ordenados<br/>por relevancia"]
```

Puntos clave:

* **Ignora acentos y mayúsculas**: `cafe` encuentra `café`.
* **Entiende singulares y plurales**: `camiseta` encuentra `camisetas`.
* **Todos los términos deben coincidir**: buscar `camiseta roja` no devuelve todo lo rojo ni todas las camisetas, solo camisetas rojas.
* **Tiene en cuenta las categorías**: buscar `camiseta` encuentra productos de la categoría "Camisetas" aunque el nombre del producto no la mencione.
* **Sinónimos propios de tu tienda**: puedes enseñarle que `tv` = `televisor`.
* **Palabras a ignorar**: descarta palabras que solo agregan ruido a la búsqueda, como "quiero" o "barato".
* **Reconoce las marcas de tu tienda**: puedes registrar tus marcas para que las detecte en la consulta y las use al filtrar los resultados.
* **Tolerancia a errores de escritura** (opcional): `Xioami` encuentra `Xiaomi`.

### Ventajas

* Muy rápida y de bajo costo: no depende de servicios externos.
* Precisa: excelente para SKU, nombres de producto y catálogos con vocabulario técnico.
* Resultados consistentes: la misma búsqueda siempre devuelve los mismos productos.
* Personalizable por tienda: sinónimos, palabras a ignorar y marcas.

### Limitaciones

* Solo encuentra lo que está escrito: si el término no aparece en el nombre, SKU, categoría o descripción del producto (ni en los sinónimos configurados), no hay resultados.
* No entiende consultas descriptivas como "algo para el frío" o "regalo para mamá".
* El vocabulario particular de tus clientes puede requerir configurar sinónimos.

## Comparación

|                                | Búsqueda híbrida                 | Búsqueda por texto            |
| ------------------------------ | -------------------------------- | ----------------------------- |
| **Cómo busca**                 | Por significado y palabras clave | Por las palabras del catálogo |
| **Entiende lenguaje natural**  | Sí                               | No                            |
| **Sinónimos**                  | Automáticos                      | Configurables por tienda      |
| **Acentos y plurales**         | Sí                               | Sí                            |
| **Errores de escritura**       | Tolerante                        | Tolerancia opcional           |
| **SKU / código exacto**        | Regular                          | Excelente                     |
| **Velocidad**                  | Más lenta (usa servicios de IA)  | Muy rápida                    |
| **Costo por búsqueda**         | Adicional (servicios de IA)      | Sin costo adicional           |
| **Consistencia de resultados** | Media                            | Alta                          |

## ¿Cuál usar?

| Escenario                                                       | Motor recomendado  |
| --------------------------------------------------------------- | ------------------ |
| El usuario busca por SKU, código o nombre exacto                | Búsqueda por texto |
| Catálogo técnico: repuestos, ferretería, farmacia               | Búsqueda por texto |
| Prioridad en velocidad y costo                                  | Búsqueda por texto |
| Consultas conversacionales largas desde un chatbot              | Búsqueda híbrida   |
| Consultas descriptivas: "algo para el frío", "regalo para mamá" | Búsqueda híbrida   |
| El vocabulario del usuario difiere mucho del catálogo           | Búsqueda híbrida   |

Si no sabes cuál conviene para tu catálogo, contacta al equipo de Jelou.
