> For the complete documentation index, see [llms.txt](https://academy.gopersonal.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.gopersonal.ai/guia-de-usuario/go-search/configuraciones/todos-los-ajustes/tus-productos.md).

# Antes de buscar: tus productos

El grupo **0 · Antes de buscar: tus productos** reúne lo que el buscador usa cuando procesa tu catálogo en cada entrenamiento: qué campos se buscan y se filtran, cómo se ordenan y unifican los valores de los filtros, y los datos que la plataforma calcula sola a partir de tus productos.

Como indica la pantalla, esta parte **se usa al entrenar; los cambios se ven en el próximo entrenamiento**. La sección 0.4 muestra cuándo fue el último.

Cada sección tiene el botón **Preguntar a Calvin**, que abre **Pedile a Calvin** con una pregunta sobre esa sección y cómo está configurada en tu tienda.

## 0.1 Campos de tus productos y para qué se usa cada uno

Etiqueta: **Lo ajustás vos**

<figure><img src="https://1714366366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuYUYzfG5fXW0akjkg1XQ%2Fuploads%2Fgit-blob-fe10b736f384253ef380f190b2b9d34da70d8819%2F10-campos.png?alt=media" alt="Tabla Campos de tus productos con las columnas de cada uso"><figcaption></figcaption></figure>

Una tabla con una fila por cada campo de tu catálogo y una columna por cada uso. Marcas la casilla de los usos que quieres para cada campo.

La lista incluye siempre los campos **Id**, **Nombre**, **SKU**, **Descripción**, **Categoría**, **Marca** y **Precio**, más los atributos de producto de tu proyecto. Debajo del nombre visible de cada campo aparece su nombre en el catálogo.

| Columna                                  | Qué hace                                                                                                                                                                                           |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Se busca acá**                         | Si alguien escribe algo que está en este campo, el producto aparece. El número indica el orden en que se arma el texto de búsqueda.                                                                |
| **Sirve para filtrar**                   | La IA puede usar el campo como filtro cuando la búsqueda lo nombra. Por ejemplo, “remera talle M” filtra Talle = M.                                                                                |
| **Filtro lateral (nombre visible)**      | El campo aparece como filtro al costado de los resultados. Al marcarlo se habilita una caja de texto para escribir el nombre que ve el cliente.                                                    |
| **Se guarda para mostrar y para reglas** | El dato viaja con cada resultado: se puede mostrar en la tarjeta del producto o usar en reglas para subir y bajar productos. Por ejemplo, guardar el stock permite la regla “sin stock, al final”. |
| **Tiene varios valores**                 | El campo trae una lista separada por `\|` y cada valor se trata por separado. Por ejemplo, con “vegano\|sin tacc”, filtrar por “vegano” encuentra el producto.                                     |

Cada columna tiene un ícono de ayuda con esta misma explicación.

### Ordenar los campos y los filtros laterales

Debajo de la tabla hay dos listas, con flechas **Subir** y **Bajar** para mover cada elemento:

* **Orden de los campos de búsqueda**: los campos marcados en **Se busca acá**, en el orden en que se arma el texto de búsqueda.
* **Orden de los filtros laterales en pantalla**: los campos marcados como **Filtro lateral**, en el orden en que los ve el cliente.

### Agregar un campo que no está en la lista

En **Agregar un campo que no está en la lista** puedes escribir el nombre de un campo y hacer clic en **Agregar**. El campo se suma a la tabla marcado en **Se guarda para mostrar y para reglas**, y después puedes marcarle otros usos.

Si un campo que ya estaba configurado no aparece en tu catálogo, se conserva en la tabla con la marca **no está en el catálogo**, para que no se pierda al guardar.

### Guardar

Haz clic en **Guardar campos**. Solo se guardan las columnas que cambiaste; si no cambiaste nada, se muestra **No hay cambios para guardar**.

Los cambios de esta tabla se aplican en el próximo entrenamiento. Los cambios en **Se busca acá** vuelven a procesar todo el catálogo en ese entrenamiento.

*Ejemplo:* si “Marca” está marcada en **Se busca acá**, buscar el nombre de una marca trae sus productos.

## 0.2 Valores de los filtros: orden y valores unificados

Etiquetas: **Lo ajustás vos** y **Aprendido**

<figure><img src="https://1714366366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuYUYzfG5fXW0akjkg1XQ%2Fuploads%2Fgit-blob-d57855e4b64d12cd6e1393ad923845a7d14d0be7%2F11-valores.png?alt=media" alt="Valores de los filtros: orden de valores y unificar valores escritos distinto"><figcaption></figcaption></figure>

Define en qué orden aparecen las opciones de cada filtro lateral y qué valores escritos de forma distinta se juntan en uno solo. Tiene dos partes.

### Orden de valores

Una tabla con los filtros laterales configurados en 0.1, con las columnas **Etiqueta de Visualización**, **Nombre del Campo** y **Orden de valores**. El botón de la columna **Orden de valores** muestra el orden actual de ese filtro; al hacer clic se abre la ventana **Orden de valores** con estas opciones:

* **Automático**: números en orden numérico y alfabético para el resto. Si el campo se llama talle o size, ordena los talles (XS, S, M, L…).
* **Alfabético**: de la A a la Z, sin tratar las letras como talles (los números siguen en orden numérico).
* **Por talle**: números primero y luego XXS, XS, S, M, L, XL…, aunque el campo no se llame talle.
* **Personalizado**: arrastras los valores en el orden que quieras. También puedes usar **Mover al principio** y **Mover al final** en cada valor, o partir de **Ordenar A-Z** u **Ordenar por talle** y ajustar desde ahí. Los valores que aparezcan más adelante en el catálogo se agregan al final.

En las opciones que no son **Personalizado**, la ventana muestra una **Vista previa del orden**. Los valores que se listan son los del último entrenamiento del buscador. Si un filtro todavía no tiene valores, aparecen después de entrenar el buscador con ese filtro configurado.

Haz clic en **Guardar** en la ventana para aplicar el orden.

Si todavía no tienes filtros laterales, la tabla no aparece: primero configúralos en la columna **Filtro lateral (nombre visible)** de 0.1.

*Ejemplo:* **Por talle** muestra XS · S · M · L · XL en lugar de L · M · S · XL · XS.

### Unificar valores escritos distinto

Junta en un solo valor lo que es lo mismo escrito de otra forma. Corre al entrenar, en tres pasos:

1. Una regla fija junta los valores que solo cambian en mayúsculas, tildes o puntuación.
2. Entre los que quedan, busca pares parecidos.
3. La IA decide solo los casos dudosos. Solo se vuelve a consultar por valores que aparezcan en el catálogo y no se hayan revisado.

Opciones:

* **Unificar valores al entrenar**: activa o desactiva la unificación.
* **Campos**: los campos filtrables en los que se unifican valores. Puedes elegirlos de la lista o escribirlos (por ejemplo, marca, autor, editorial).
* **Confianza mínima (0 a 1)**: un número entre 0 y 1 que fija la confianza mínima para juntar dos valores.
* **Usar IA para los dudosos**: si está desmarcado, no se usa el paso 3.

Cuando ya hay valores unificados, debajo se indica cuántos se unificaron hasta el momento. Haz clic en **Guardar** para guardar los cambios, que se aplican en el próximo entrenamiento.

*Ejemplo:* “Bio Forma” y “BIOFORMA” los junta la regla fija (paso 1); “Sara J. Mass” → “Sarah J. Maas” lo decide la IA (paso 3).

## 0.3 Lo que se calcula solo a partir de tu catálogo

Etiquetas: **Aprendido** y **Automático**

<figure><img src="https://1714366366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuYUYzfG5fXW0akjkg1XQ%2Fuploads%2Fgit-blob-fa108ac7a260fccff750ecfa6023a49bfbc26dae%2F12-calculado.png?alt=media" alt="Sección 0.3 con Instrucciones de Palabras Clave, Campos Extendidos y Perfil de la tienda"><figcaption></figcaption></figure>

Datos que la plataforma arma sola en cada entrenamiento: atributos que asigna la IA, palabras clave de cada producto y más. Puedes guiar a la IA en algunos de ellos y ver el resultado de los demás. La sección muestra, en este orden, **Instrucciones de Palabras Clave**, **Campos Extendidos**, **Perfil de la tienda** y los datos que calcula el buscador.

*Ejemplo:* con un atributo “Dieta: Vegana, Sin TACC…”, buscar “galletitas sin tacc” filtra por Dieta aunque el catálogo no tenga ese campo.

### Instrucciones de Palabras Clave

Un texto con instrucciones para la extracción de palabras clave de los productos. Escribe las instrucciones y haz clic en **Guardar**.

El botón **Regenerar keywords de imágenes** vuelve a generar las palabras clave de todas las imágenes del catálogo con las instrucciones guardadas. Pide confirmación y la regeneración se aplica en el próximo entrenamiento.

### Campos Extendidos

Campos personalizados y sus valores posibles. En cada entrenamiento, la IA asigna a cada producto el valor que le corresponde, y el buscador puede usar ese atributo aunque no exista en tu catálogo.

Para crear uno, haz clic en **Nuevo Campo Extendido** y completa:

* **Nombre del Atributo** (obligatorio): por ejemplo, temporada.
* **Valores** (obligatorio, al menos uno): escribe cada valor y presiona Enter.
* **Descripción para clasificación (opcional)**: explica qué significa cada valor para tu marca, para que la IA clasifique los productos con más precisión. Por ejemplo: “casual: ropa del día a día. formal: oficina/eventos. fiesta: salidas nocturnas, vestidos elegantes”.

Al hacer clic en **Confirmar**, el campo se guarda. En la tabla puedes editar cada campo con el ícono de edición o eliminarlo con el de la papelera. No puede haber dos campos extendidos con el mismo nombre.

Los atributos se asignan a los productos en el próximo entrenamiento.

### Perfil de la tienda

Rubro, país y forma de hablar de la tienda. La IA lo usa para entender los productos y escribir sus palabras clave. Se completa solo en el primer entrenamiento; aquí puedes verlo y corregirlo.

* **Usar el perfil para describir los productos**: al activarlo, el próximo entrenamiento vuelve a describir todos los productos con IA una vez. Si cambias el perfil después, solo afecta a los productos que se agreguen o se modifiquen.
* **Rubro**: Moda, Calzado, Ropa interior, Belleza, Hogar y deco, Electro y tecnología, Óptica, Librería, Juguetería, Deportes, Multirrubro u Otro. Es obligatorio para guardar cambios en el perfil.
* **País** y **Forma de hablar**.
* **Resumen de la tienda**.
* **Atributos clave**: por ejemplo, talle, color, material.
* **Líneas de producto**: para cada línea escribe la **Línea** y **Para quién es**, y haz clic en **Agregar**. Con **Quitar** la eliminas.
* **Notas para la IA**.

Haz clic en **Guardar**. Solo se guardan los datos que cambiaste.

*Ejemplo:* con país Argentina, “remera” y “polera” se entienden igual.

### Datos que calcula el buscador

Estos bloques llevan la etiqueta **Automático** y son solo de consulta: no tienen nada para editar.

| Bloque                            | Qué muestra                                                                                                                                                                                                                                                                                                                                                                                        |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tipo y familia de producto**    | Cada producto recibe un tipo y una familia que agrupa tipos parecidos; se usa para entender qué tipo de producto piden. Muestra cuántas **familias**, **tipos de producto** y **tipos sin familia** hay, y los nombres de las familias. Se calcula cuando está activa la opción de elegir filtros por familia de producto (paso 8). Ejemplo: “shaker” y “vaso mezclador” caen en la misma familia. |
| **Vocabulario de la tienda**      | Las palabras que existen en tu catálogo, que son las que usa la corrección de errores de tipeo. Muestra cuántas **palabras** tiene y cuándo se **armó**. Se arma cuando se activa la corrección de errores de tipeo (paso 4). Ejemplo: “colagneo” se corrige porque “colágeno” está en el vocabulario.                                                                                             |
| **Valores reales de cada filtro** | Cuántos valores existen para cada campo filtrable. La IA solo puede elegir filtros entre estos valores. Ejemplo: si nadie vende un sabor, la IA nunca filtra por ese sabor.                                                                                                                                                                                                                        |
| **Popularidad de cada producto**  | Cuánto se ve y se vende cada producto. Alimenta los órdenes “Más vendidos” y “Populares” y se puede usar en reglas para subir y bajar productos. Se actualiza cada 6 h. Muestra **productos con datos**, cuántos **con ventas** y cuándo se **actualizó**.                                                                                                                                         |

Si un bloque todavía no tiene información, se indica con un mensaje como **Todavía no hay datos.**

## 0.4 Estado del entrenamiento

Etiqueta: **Automático**

<figure><img src="https://1714366366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuYUYzfG5fXW0akjkg1XQ%2Fuploads%2Fgit-blob-5fa7216d9f8188df5572e5b8e26c7da2c0596ee7%2F13-entrenamiento.png?alt=media" alt="Estado del entrenamiento con fecha, productos en el buscador y estado del índice"><figcaption></figcaption></figure>

Muestra cuándo se procesó tu catálogo por última vez y qué hizo. Es solo de consulta:

* **último entrenamiento**: fecha y hora.
* **productos en el buscador**: cuántos productos quedaron disponibles para buscar.
* **productos en el catálogo procesado**: cuántos productos se procesaron.
* **estado del índice**: **Al día** o **Hay diferencias**.

{% hint style="info" %}
Los cambios de este grupo (campos, atributos, filtros laterales) y los sinónimos se aplican en el próximo entrenamiento. El resto de los ajustes rige al guardar.
{% endhint %}

*Ejemplo:* si hoy agregas un campo de búsqueda, el buscador lo usa después del próximo entrenamiento.
