IdiomaENES
RetrievalOct 7, 2026 · 6 min de lectura

Evita que tu asistente mezcle versiones de producto

Dos manuales que se diferencian en un paso son casi idénticos para un sistema de recuperación. Va a encontrar los dos, puntuarlos igual y mezclarlos en una instrucción que no sirve para ninguno.

Hernan MoyaCo-Founder
An answer that blends two product manuals, citing the Series 1 and Series 2 reset pages at once
An answer that blends two product manuals, citing the Series 1 and Series 2 reset pages at once

Un asistente que mezcla dos versiones de tu producto no está alucinando. Está haciendo exactamente lo que le pidieron, con contenido que no le dio forma de distinguirlas.

La instrucción de reinicio de la Serie 1 y la de la Serie 2 hablan de lo mismo, con las mismas palabras, y se diferencian en un paso. Para un sistema que recupera por significado, son gemelas.

La misma pregunta, con y sin el manual viejo

InteractiveLo que hay en la base de conocimiento decide la respuesta

Mira los dos puntajes del primer estado. Están a una centésima de distancia, y ningún umbral que pudieras configurar se quedaría con uno y descartaría el otro. Esto no es un problema de ajustes.

Por qué este caso es más difícil que una respuesta equivocada

Casi todas las fallas de recuperación se ven. El asistente cita algo irrelevante, alguien lo nota, y la página se corrige.

Una mezcla de versiones es invisible desde adentro. Cada pasaje recuperado es pertinente, está bien escrito y es cierto. Lo único equivocado es para qué dispositivo, plan o país era cierto, y nada en la pregunta lo decía. El cliente que sigue esa respuesta no vuelve a avisarte: concluye que las instrucciones no funcionan.

Tres soluciones que funcionan hoy

En la literatura técnica la respuesta estándar es adjuntar metadatos al indexar y filtrar por ellos al consultar. Vale la pena conocerla, y hoy no es una configuración de este producto, así que esto es lo que sí funciona con lo que existe.

  • Una base de conocimiento por versión, y un widget apuntando a cada una. Es la solución más fuerte, y coincide con cómo ya publicas tu documentación: el sitio de la Serie 2 lleva el asistente que responde desde la base de la Serie 2. Los planes incluyen 1, 5 y 25 bases de conocimiento, así que casi todos los equipos tienen lugar para una por línea de producto o por versión principal.
  • Pon la versión en el título y en la primera frase. No solo en una miga de pan o en el encabezado de la página, que no viaja con el pasaje. "Reiniciar un dispositivo Serie 2" como encabezado, y "En la Serie 2," al empezar el párrafo. Así los dos pasajes dejan de ser gemelos y el modelo tiene con qué distinguirlos.
  • Retira lo que está retirado. La pregunta que nadie hace es si el manual viejo tiene que estar ahí. Si un producto está discontinuado y sin soporte, borrar sus documentos de la base es una sola acción y elimina toda esa clase de error.
Borrar la página no es borrar el documento

Sacar una página de tu sitio no saca lo que ya se indexó. El documento sigue en la base de conocimiento hasta que alguien lo borre ahí, o hasta que una fuente conectada sincronice esa baja. Un asistente respondiendo desde una página que ya no existe es la versión más común de este problema.

Qué hacer cuando tienes que conservar las dos

A veces la versión vieja sigue con soporte y las dos tienen que responder. Tres cosas lo hacen llevadero.

La maniobra
Qué logra
Preguntar primero la versión
Una pregunta del formulario o una acción rápida convierte una consulta ambigua en una concreta
Decir la versión en cada respuesta
Escríbelo en las instrucciones: que nombre la versión a la que aplica, o que diga que no sabe cuál es
Tener una página con las diferencias
Un documento corto con lo que cambió entre versiones es el pasaje que resuelve la mayoría de estas preguntas

La tercera está subestimada. "Qué cambió en la Serie 2" es una página que nadie escribe para personas, y es justo el pasaje que permite responder bien una pregunta de versión en lugar de promediar dos manuales.

welcomeai.devCómo encuentra respuestas tu asistente: chunks, top K y el umbral

Cómo saber si tienes este problema

Toma cinco instrucciones que hayan cambiado entre versiones y hazle cada una al asistente sin decir la versión. Lee qué citó, no solo qué dijo.

Si cita la página vieja, tienes contenido que debería retirarse. Si cita las dos y la respuesta titubea, tienes una base que hay que dividir. Y si responde bien pero nunca dice de qué versión habla, tienes un cliente a punto de seguir los pasos equivocados con total confianza.

Preguntas frecuentes

Haz la prueba de las cinco preguntas esta semana. Es la forma más rápida de descubrir si tu asistente viene respondiendo con total seguridad sobre un producto que dejaste de vender hace dos años.

welcomeai.devCómo escribir documentación que una IA pueda responder
Etiquetadoversionsretrievalknowledge-basesdocumentationaccuracy
Escrito porHernan Moya

Sigue leyendo