IdiomaENES
GuidesOct 9, 2026 · 7 min de lectura

Cómo escribir documentación que una IA pueda responder

La recuperación no lee tu página. Lee un pedazo, elegido por una máquina que no recuerda el encabezado de seis párrafos más arriba. Escribir para eso cambia algunos hábitos, no tu manual de estilo.

Hernan MoyaCo-Founder
Four retrieved passages for one question, the short single-topic page scoring far above the long page
Four retrieved passages for one question, the short single-topic page scoring far above the long page

En toda empresa hay un documento que responde todo y no le sirve a nadie. Tres mil palabras escritas a lo largo de dos años, con la regla de devoluciones en el párrafo once y su excepción en el diecinueve.

Una persona se las arregla con eso, porque una persona saltea. Un asistente no, porque nunca ve el documento. Ve un pedazo, elegido por una máquina que buscaba una cosa puntual.

La unidad es el fragmento, no la página

Antes de responder nada, tus documentos se parten en fragmentos y se indexan. Después una pregunta recupera unos pocos de esos fragmentos, y el modelo escribe la respuesta con lo que volvió. Nada más de la página viaja con ellos.

Esta es la misma respuesta guardada de dos formas.

InteractiveLa misma respuesta, guardada de dos formas

Los mismos datos, la misma empresa, el mismo asistente. La diferencia está por completo en cómo se ordenó el texto antes de que alguien preguntara nada.

Seis hábitos que hacen el trabajo

Ninguno es reescribir todo. Son decisiones que tomas mientras escribes igual.

  • Una página, una pregunta. Una página llamada "Pedidos" guarda once respuestas mal. Once páginas cortas guardan una bien cada una, y además son más fáciles de mantener para las personas.
  • Encabezados que se leen como preguntas. Es la señal más fuerte que lleva un fragmento, y sobrevive al corte. "Cambiar la dirección de entrega" le gana a "Modificaciones de dirección y otros cambios".
  • Repite el sujeto. Un pasaje que empieza con "Puedes cambiarla dentro de las 2 horas" perdió qué era "la". Vuelve a escribir el sustantivo, aunque suene redundante dos líneas debajo del encabezado.
  • La regla y su excepción, juntas. Si la excepción está tres párrafos más abajo, caen en fragmentos distintos y la respuesta pierde una de las dos.
  • Números con su unidad y su alcance. "2 horas desde que se hace el pedido", no "2 horas".
  • Escribe las respuestas incómodas. Las que nadie publicó: qué pasa si llegas tarde, quién paga qué, qué no van a hacer. Son justamente las que la gente le pregunta a un asistente, porque no las encontró.

Qué hacer con los formatos que se resisten

Los PDF largos, las tablas y los instructivos hechos solo de capturas son donde el buen contenido va a volverse imposible de encontrar.

El formato
Qué pasa
Qué hacer
Un manual PDF de 90 páginas
Se parte por longitud, así que las secciones cortan a mitad de frase
Deja el PDF para las personas y publica las veinte respuestas principales como páginas
Una tabla ancha
Las filas se separan de sus encabezados y los valores pierden sentido
Agrega una frase debajo que enuncie la regla que la tabla codifica
Pasos como capturas de pantalla
No hay nada que recuperar, porque no hay palabras
Escribe los pasos como texto y deja las imágenes al lado
Una página de enlaces
Se recupera como un menú del que nadie puede responder
Di qué hay detrás de cada enlace, en una frase
El tamaño del fragmento no es tu primer problema

Existe una configuración real para el tamaño de los fragmentos, y vale la pena ajustarla cuando tu contenido ya tenga sentido. En ese orden. Una página mal estructurada no mejora con 400 tokens en lugar de 800: simplemente se rompe en otros lugares.

welcomeai.devCómo mejorar la recuperación cambiando el tamaño de los chunks

Cómo saber si funcionó

No releyendo tus documentos. Haciéndole al asistente tus veinte preguntas reales y leyendo qué recuperó, no solo qué dijo.

Tres patrones te dicen qué corregir. Una respuesta correcta desde un fragmento con puntaje bajo significa que el contenido existe con la forma equivocada. El mismo fragmento volviendo para preguntas distintas significa que esa página hace demasiados trabajos. Y una respuesta segura que cita una página desactualizada significa que tu problema no es de escritura: es que nadie se hace cargo de actualizarla.

welcomeai.devBuscador Ask AI para tu documentación

Preguntas frecuentes

Elige una página que intente responder todo, pártela en las cuatro preguntas que de verdad responde, y hazle esas cuatro al asistente. Los puntajes te dicen el resto.

welcomeai.devCómo construir una base de conocimiento con IA para tu empresa
Etiquetadodocumentationchunkingretrievalwritingknowledge-base
Escrito porHernan Moya

Sigue leyendo