OneTrace.pro Centro de ayuda

Búsqueda con IA

La búsqueda con IA entiende una consulta escrita con palabras normales: «zapatillas de running impermeables por menos de 100 euros, pero no de Contoso», «un regalo para un corredor», «una bolsa para un portátil de 15 pulgadas». La IA convierte la consulta en filtros del catálogo (categorías, marcas, características, precio y exclusiones) y la búsqueda de productos muestra los productos según esos filtros. Encima de los productos aparecen un breve consejo de la IA y chips para afinar: «más barato», «de mujer», «otro color». Los resultados normales aparecen de inmediato, como siempre, y los resultados de la IA los sustituyen cuando el análisis está listo. Si la IA no responde, se mantienen los resultados normales.

La búsqueda con IA forma parte de la búsqueda de productos: se necesitan el rastreador, el catálogo y el widget de búsqueda o un plugin de tienda. La IA se paga según el consumo con el saldo del proyecto y funciona en un plan de pago; consulte Pago y límites.

Cómo activarla

En la página Sitio web → Búsqueda de productos, en el bloque Búsqueda con IA, elija Cuándo usar la IA. La elección se guarda de inmediato.

Bloque «Búsqueda con IA»: modo, respuesta sobre los productos, comprobación del beneficio y análisis de la consulta

Modo Cuándo analiza la IA la consulta
Desactivada nunca: la búsqueda funciona como siempre
Automática una consulta descriptiva, de tres palabras o más o una pregunta; las consultas cortas («zapatillas», «nike») se buscan como siempre
Interruptor solo cuando el cliente ha pulsado «Preguntar a la IA»
Siempre cada consulta

En los modos Automática e Interruptor, el visitante tiene el botón Preguntar a la IA, junto a la ordenación de los resultados y como fila en la capa de sugerencias: con él, la IA analiza también una consulta corta.

  • Respuesta breve de la IA sobre los productos: una o dos frases sobre lo encontrado: qué encaja mejor y en qué rango de precio. Desactívela si solo necesita los filtros.
  • Comprobar el beneficio de la IA: la mitad de los visitantes recibe la búsqueda normal y el informe compara los clics y las compras de ambos grupos; consulte Comprobación del beneficio de la IA.

Comprobar el análisis

El campo Comprobar el análisis muestra lo que la IA entendió de la consulta: el texto que se busca, las categorías, las marcas, las características, el precio, las exclusiones, el orden y las sugerencias para afinar. Escriba una consulta como la escribiría un cliente y pulse Analizar. El análisis se cobra igual que en el sitio web; un nuevo análisis de la misma consulta sale gratis de la caché: debajo del resultado se indica «Desde la caché, sin llamar al modelo».

Si la IA no encontró en la consulta nada del catálogo, la búsqueda se hará por el texto, y así se indica debajo del campo. Es una señal para añadir al catálogo las categorías o características que buscan los clientes.

Qué ve el cliente

  1. El cliente escribe una consulta y los resultados normales aparecen de inmediato.
  2. Encima de los productos aparece «La IA está eligiendo productos…». Al cabo de uno o dos segundos, los resultados de la IA sustituyen a los normales.
  3. La respuesta de la IA se va escribiendo a medida que responde el modelo, bajo el título «Consejo de la IA».
  4. Los chips La IA entendió: muestran los filtros aplicados: categoría, marcas, características, precio y exclusiones con el signo «−». Un chip se puede quitar: los resultados se actualizan de inmediato, sin llamar al modelo.
  5. Para afinar hay chips y el campo «Precise: más barato, otro color…». Lo que se precisa continúa la consulta anterior: «más barato» después de «zapatillas de running Northwind» mantiene la marca y baja el precio.
  6. Preguntar en el chat abre el chat del sitio web con la consulta del cliente, si el chat está conectado.
  7. Búsqueda normal devuelve los resultados normales hasta que cambie la consulta.

Si el catálogo no tiene lo que se pidió, la IA relaja los filtros: primero quita las características y las exclusiones, luego el precio y después busca por el texto original. En ese caso, encima de los productos se indica «No hay coincidencias exactas: se muestran productos similares.».

Si el visitante eligió por su cuenta filtros u orden en los resultados, la IA no sobrescribe su elección: el orden elegido se aplica sobre los resultados de la IA, y los filtros propios del visitante devuelven los resultados normales.

Cómo analiza la IA la consulta

  • Solo el catálogo. La IA recibe las categorías, las marcas y los valores de características de su catálogo y elige entre ellos. Todo lo que no está en el catálogo se descarta: la IA no inventa una marca ni una talla.
  • Idioma. La consulta se puede escribir en cualquier idioma: la IA traduce el texto que se busca al idioma del catálogo y escribe las sugerencias para afinar en el idioma del cliente.
  • Caché. El análisis de una consulta se guarda 7 días: la misma consulta en el mismo idioma se analiza sin el modelo y gratis. Cada noche se analizan por adelantado las consultas populares del sitio de los últimos 30 días (hasta 100 consultas por proyecto), por lo que las consultas frecuentes se responden al instante.
  • La respuesta sobre los productos se escribe solo a partir de las fichas de los productos encontrados: nombre, marca, precio, disponibilidad y características. Una frase con un número que no está en las fichas (precio, descuento, plazo) se elimina. La respuesta lista para la misma consulta y los mismos productos se guarda un día.
  • El orden de los productos sigue siendo el de la búsqueda: el aprendizaje a partir de los clics, los intereses del visitante y la búsqueda por sentido también funcionan en los resultados de la IA; consulte Cómo se buscan los productos.

Plugins de tiendas

Los plugins de WooCommerce y Magento 2 y el módulo de 1C-Bitrix en el modo de búsqueda de productos muestran los resultados de la IA en la página de búsqueda de la tienda. El tema de la tienda muestra los productos como siempre y, encima, el rastreador muestra el bloque de la IA: el consejo, los chips «La IA entendió:», las sugerencias para afinar y «Búsqueda normal». Quitar un chip o afinar la consulta abre la misma página de búsqueda con parámetros nuevos.

El plugin espera el análisis como máximo 2,5 segundos. Las consultas populares se analizan por la noche y se abren de inmediato; una consulta descriptiva nueva se abre entre 1 y 2 segundos más lenta de lo habitual. Si el análisis no llega a tiempo, la tienda muestra los resultados normales. Se necesitan WooCommerce 1.18.0, Magento 2 1.15.0 o 1C-Bitrix 1.14.0 o posteriores.

Página de resultados propia

Si la página de resultados es propia, obtenga los resultados de la IA en el rastreador:

const result = await cdp.searchAi(q, { perPage: 24 });

if (result.ai) {
  // result.items — productos, result.ai.understood — chips «La IA entendió», result.ai.refinements — sugerencias para afinar,
  // result.ai.relaxed — filtros relajados, result.ai.state — análisis para la siguiente solicitud
  await cdp.searchAiAnswer(q, result.items.slice(0, 6).map((item) => item.id), (text) => { answer.textContent = text; });
} else {
  // La consulta no necesita la IA, la IA no está disponible o no llegó a tiempo: muestre los resultados normales de cdp.search(q)
}

Opciones de cdp.searchAi: previous, el result.ai.state de la respuesta anterior junto con la frase para afinar («más barato»); state, el análisis sin el chip quitado (resultados sin llamar al modelo); asked: true, el visitante pulsó «Preguntar a la IA»; además, sort, page y perPage. El análisis espera la respuesta del modelo hasta 8 segundos. Se necesita el rastreador 1.37.0.

Los servidores pueden hacer la misma solicitud con una clave de escritura: POST https://cdp.onetrace.pro/api/v1/search/ai; en el SDK de PHP, search()->ai(). La lista completa de parámetros está en la referencia de la API: https://cdp.onetrace.pro/api/v1/openapi.json.

Informe

Mientras la búsqueda con IA está activada, debajo del informe de consultas de la página Sitio web → Búsqueda de productos se muestra el informe Búsqueda con IA del mismo período.

Informe «Búsqueda con IA»: proporción de búsquedas, caché, velocidad, relajación, errores, costo y beneficio de la IA

Indicador Qué muestra
Búsquedas con IA y Proporción de todas las búsquedas cuántos resultados mostró la IA y qué parte de las búsquedas del sitio representan
Desde la caché la proporción de resultados sin llamar al modelo, gratuitos e instantáneos
Análisis: p50 / p95 cuánto tarda el modelo en analizar la consulta en la mitad y en el 95 % de las búsquedas
Primeras palabras de la respuesta cuánto tarda el cliente en ver el comienzo del consejo de la IA
Relajadas la proporción de búsquedas sin coincidencias exactas en las que la IA quitó algunos filtros
Errores análisis a los que el modelo no respondió; en esos casos el cliente vio los resultados normales
Costo por 1000 búsquedas cuánto se cargó al saldo por la búsqueda con IA, calculado por cada 1000 búsquedas

Debajo de los indicadores se indica cuántos refinamientos se hicieron sin el modelo, cuántas respuestas de la IA hubo y cuánto se cargó en el período. La tabla muestra las consultas que analizó la IA, con el número de productos encontrados y la proporción de búsquedas relajadas: las consultas con una proporción alta de relajación muestran lo que falta en su surtido.

Comprobación del beneficio de la IA

Active Comprobar el beneficio de la IA para saber si la IA ayuda a vender. Los visitantes a los que les correspondería la IA se reparten por igual en dos grupos: uno recibe la búsqueda con IA y el otro, la búsqueda normal. Cada visitante permanece siempre en su grupo. Quien pulsa por su cuenta «Preguntar a la IA» o afina la consulta recibe la IA en cualquier grupo. Las búsquedas del grupo de búsqueda normal no se pagan como IA.

En el informe, el bloque Beneficio de la IA compara los grupos:

  • Clic en los resultados en 30 minutos: la proporción de búsquedas tras las cuales el visitante hizo clic en un producto de los resultados de esa consulta;
  • Compra en los 7 días posteriores a la búsqueda: la proporción de búsquedas tras las cuales el mismo cliente compró algo. Se muestra si en la configuración de recomendaciones hay un evento de compra; consulte Recomendaciones y catálogo de productos.

El veredicto funciona como en otras comparaciones de variantes: mientras hay pocos datos, el informe lo indica; cuando la diferencia es estadísticamente significativa, nombra al ganador. Si la búsqueda normal es mejor, revise el análisis de las consultas frecuentes en el campo Comprobar el análisis. Los clics en los resultados los registra el widget de búsqueda; en la página de búsqueda de los plugins, el tema de la tienda no registra los clics, por lo que allí solo se comparan las compras. Después de desactivar la comprobación, el informe muestra los resultados del período en que funcionó.

Pago y límites

Cada análisis y cada respuesta de la IA cuestan según la cantidad de texto (tokens) que procesó el modelo, más el margen de la plataforma. El importe se descuenta del saldo del proyecto; en el historial del saldo aparece como «Búsqueda con IA». El análisis desde la caché, quitar un chip, las páginas siguientes y el cambio de orden no usan el modelo y son gratuitos. El modelo lo elige la plataforma; el análisis de una consulta suele costar una fracción de centavo.

  • La búsqueda con IA funciona en un plan de pago con búsqueda de productos. En el periodo de prueba, sin dinero en el saldo o al alcanzar el límite de gasto, la IA no se activa y los clientes ven la búsqueda normal.
  • Una solicitud a la IA es una búsqueda más dentro del límite mensual del plan; consulte Límite de búsquedas. El widget busca a la vez los resultados normales y los de la IA, por lo que una consulta descriptiva en el widget cuenta dos veces; en los plugins de tiendas, una vez. Las consultas que no necesitaron la IA o para las que no estaba disponible, y las búsquedas del grupo de búsqueda normal en la comprobación del beneficio, no se cuentan por segunda vez.
  • Un visitante puede llamar al modelo como máximo 10 veces por minuto y 100 veces al día; por encima de eso, ve los resultados normales. Las respuestas desde la caché no cuentan para estos límites.
  • Desde una misma dirección, no más de 30 llamadas al modelo por minuto y 300 al día para todas las funciones de IA del sitio; el servidor de la tienda con el plugin y la clave secreta no tiene este límite. Cuánto puede gastar la IA del sitio al día lo fija el presupuesto diario: cuando se agota, funciona la búsqueda normal hasta la medianoche.