Recomendaciones y FAQ
Recomendaciones para obtener mejores resultados de búsqueda con XEYE y respuestas a las preguntas más frecuentes.
Escribir buenos elementos
Escribe los textos como buscan tus usuarios, no como nombra las cosas tu base de datos.
Dale a cada elemento una descripción con sinónimos y contexto: es la mejora semántica más barata que existe.
Prueba con consultas reales de usuario: una errata y un sinónimo te dicen más que una coincidencia perfecta.
Trabajar con eficiencia
Importa en bloque, edita por lotes y entrena una sola vez al final.
Prueba primero en la página Búsqueda de la consola; integra por API cuando los resultados encajen.
Prueba dos o tres modelos de embeddings con consultas reales antes de elegir el que queda en uso.
Seguridad
Trata las claves API como contraseñas: solo en el servidor, una por integración, y borra las que no uses.
Mantén las listas privadas hasta que estén listas para exponerse a través de la API.
Eliminar una lista, una clave o tu cuenta es permanente: no se puede deshacer.
Preguntas frecuentes
¿Por qué mi lista no devuelve nada a través de la API?
Comprueba tres cosas: que la lista es pública, que la clave es válida y que list_name coincide exactamente con el nombre de la lista. Las listas privadas solo se pueden buscar desde la consola.
¿Editar elementos rompe la búsqueda?
No. Las búsquedas siguen usando el último entrenamiento en uso. Los elementos añadidos después de ese entrenamiento coinciden solo por texto hasta que reentrenes; los borrados dejan de aparecer al momento.
¿Cada cuánto debo reentrenar?
Cuando el contenido haya cambiado lo suficiente: después de añadir un lote de elementos o de reescribir textos y descripciones. No hace falta reentrenar tras cada pequeño cambio.
¿Qué modelo de embeddings elijo?
Empieza con el modelo por defecto. Si a los resultados les faltan matices, entrena con un modelo más grande y compara con las mismas consultas desde la página Búsqueda; deja «en uso» el que gane.
¿Puedo buscar listas privadas desde mi aplicación?
No. La API pública solo sirve listas públicas. La consola puede buscar en todas tus listas, lo que resulta útil para preparar una lista antes de hacerla pública.
¿Qué pasa si borro una clave API?
Toda integración que la use deja de funcionar de inmediato con un error 401. Crea antes la clave nueva, cambia tus integraciones y borra después la antigua.