Adios RAG, hola Gemini File Search Store

por

Integración real de Google File Search con WooCommerce

Si en el anterior artículo hablaba de cómo montar tu propio RAG para búsqueda de productos en Woocommerce, viene Google y añade una capa de abstracción para que nos olvidemos de embedings, chunks y demás, lanzando Gemini File Search, una nueva capacidad de Gemini que permite realizar búsquedas semánticas sobre datos propios de manera rápida y precisa. Es como tener un “mini Google” entrenado específicamente con tus documentos… pero totalmente integrado en cualquier proyecto.

En este post quiero mostrar un ejemplo real:
Cómo he conectado WooCommerce con Google File Search para permitir búsquedas inteligentes de productos de un WooCommerce

¿Qué es File Search?

Es una herramienta que permite a los modelos Gemini buscar en documentos privados que tú subes a un File Search Store.
Los modelos ya no responden sólo con “conocimiento general”: ahora pueden usar tus propios datos de forma controlada y con grounding fiable.

Es lo que viene siendo un RAG, para poder dar contextos muchos más grandes a los LLM, pero ahora con una capa de abstracción para que te olvides de bajar al barro.

Este es el flujo con el que lo describen desde Google en su página de documentación.

Esto abre muchas posibilidades:

  • motores de búsqueda internos
  • catálogo de ecommerce inteligente
  • soporte técnico automatizado
  • onboarding empresarial
  • chatbots conectados a tu base real de información

¿Qué hace la integración con WooCommerce?

Pues claro, ver esto y no trastearlo hubiese sido un pecado, así que manos a la obra, y a usarlo en nuestro buscador semántico en WooCommerce (yo lo uso ahí, pero puedes usarlo como referencia para conectarlo con cualqueir otra fuente de documentación que se te ocurra).

Cada producto de la tienda se convierte en un documento que Gemini puede encontrar, interpretar y recomendar.

Cuando el usuario busca algo, el sistema:

  1. Le envía la consulta al modelo gemini-2.5-flash
  2. Usa la herramienta file_search para buscar dentro del Store del sitio
  3. Obtiene los groundingChunks con la info del producto
  4. Extrae el ID del producto.
  5. Recupera la información real desde WooCommerce a partir de dicho ID.
  6. Devuelve resultados precisos, sin alucinaciones

Así si buscamos algo como: «No sé donde poner la tele», donde con la búsqueda tradicional es casi seguro que obtuvieses cero resultados, ahora el sistema consigue hacer una búsqueda semántica y devolverte el mueble para televisión que tenemos.

Ejemplo de búsqueda semántica

🔧 Flujo técnico explicado

1. Creación del File Search Store

Al activar el plugin se crea automáticamente un Store con el nombre del sitio.
Este Store será la base de datos donde se indexarán todos los productos.

POST /v1beta/fileSearchStores

Un Store es el contenedor donde tendremos distintos documentos con información. En nuestro caso será «la carpeta» donde estarán los documentos de nuestros productos (un doc por producto).

2. Sincronización de productos

Cuando un producto es nuevo

Se crea un documento usando upload resumible:

  1. Start upload
  2. Subir el contenido (texto plano estructurado)
  3. Guardar el document_id devuelto por la API

El contenido contiene:

  • nombre
  • descripción
  • precio
  • SKU
  • categorías
  • URL
  • ID

Cuando un producto se actualiza

  1. Se elimina el documento antiguo (si existe)
  2. Se crea uno nuevo con la información actualizada

Si, es raro, pero no tienen forma de actualizar un documento, así que toca hacerlo en dos pasos y supongo que consumiendo más recursos, pero … es lo que hay cuando la API no nos da la mejor de las soluciones.

3. La búsqueda «simple»

Para consultas como “mueble”, se llama a:

POST /models/gemini-2.5-flash:generateContent

Con la herramienta:

"file_search": {
  "file_search_store_names": ["{store_id}"]
}

Gemini devuelve grounding chunks con fragmentos reales de los productos.
El sistema procesa estos chunks, extrae IDs y devuelve los productos.

Lo que viene siendo una búsqueda semántica al estilo de lo que montábamos con el RAG.

Screenshot

4. Búsqueda con IA (AI-Powered Search)

Para consultas abiertas como:

“donde pongo la tele”

El modelo genera una respuesta natural y, además, devuelve grounding chunks.
Así entregamos:

  • una recomendación explicada por IA
  • productos reales recuperados con file search
  • cero alucionaciones (porque todo está anclado a documentos)

Vaya, que esta segunda búsqueda es dar una capa de verbose a la primera, que quizás esté más orientada a un chatbot o algo así, pero …. tenía que probarlo 🤓

5. Eliminación de producto

Cuando borras un producto en WooCommerce, también se borra su documento del Store, manteniendo todo consistente.

Resultado final

Con esta integración, WooCommerce obtiene:

  • búsqueda semántica instantánea
  • mejores recomendaciones
  • menos frustración para el usuario
  • IA conectada a datos reales
  • contenido totalmente generado a partir de tus productos

En resumen: una experiencia de búsqueda moderna y potente sin depender de plugins de terceros o motores externos.

Si quieres probarlo 👇🏻

Te dejo el repo del plugin en Github:

https://github.com/ablancodev/google-file-search