Guía
Cómo dar a tu bot de soporte y a tus agentes de IA una única fuente de verdad para la documentación de producto
Elige un documento canónico para cada dato del producto —especificaciones, límites, planes, políticas—, publícalo en un enlace permanente en un formato de texto que las herramientas de IA lean bien y dirige a tu bot de soporte, tus agentes internos y los rastreadores de IA públicos a ese enlace en lugar de a copias. Mantenlo versionado y actualízalo en el mismo sitio, para que todos los bots respondan a partir del mismo contenido vigente y comprobado.
Por qué los bots dan respuestas distintas
Un bot de soporte responde a partir de lo que se le ha dado: una exportación del centro de ayuda, una ficha técnica antigua en PDF, una página de la wiki que alguien copió el año pasado. Los asistentes públicos responden con lo que hayan encontrado en la web. Cuando el mismo dato está en cinco sitios, cada bot elige uno distinto.
El resultado es un bot que cita un límite retirado, un precio del año pasado o una función que solo existe en un plan, y un cliente que se lo cree.
Decide cuál es la fuente de verdad
Cualquier otra copia —diapositivas, correos de onboarding, presentaciones de ventas— debe enlazar al documento canónico en lugar de repetir su contenido.
| Tipo de dato | Documento canónico | Responsable |
|---|---|---|
| Especificaciones y límites | Ficha técnica por producto | Producto |
| Planes y precios | Documento de planes | Marketing de producto / finanzas |
| Políticas (reembolsos, SLA, datos) | Documento de política | Legal / soporte |
| Guías y resolución de problemas | Artículos del centro de ayuda | Soporte / documentación |
| Cambios de versión | Registro de cambios | Producto |
Escribe documentación a partir de la cual los bots respondan correctamente
- Un dato, un lugar, una redacción. No repitas los límites en tres artículos.
- Escribe los límites y las cifras con unidades y alcance: «Hasta 10 GB por espacio de trabajo en el plan Team».
- Indica a qué plan, versión o región se aplica cada afirmación.
- Pon fecha a los datos que cambian y marca claramente las funciones obsoletas.
- Usa encabezados y tablas reales; evita las capturas de pantalla de ajustes o tablas.
- Pon al principio de cada documento un breve resumen que responda a la pregunta más frecuente.
Conecta los bots a la fuente
- Configura la fuente de conocimiento de tu bot de soporte con los documentos canónicos, preferiblemente en Markdown o JSON en lugar de PDF.
- Publica un índice del Data Room (llms.txt) que enumere tus documentos canónicos, para que las herramientas de IA externas puedan descubrirlos.
- Vuelve a sincronizar el bot cada vez que cambie un documento canónico, o haz que lea el enlace en vivo.
- Revisa las transcripciones del bot en busca de respuestas que no se remonten a un documento canónico.
Cómo encaja The Papers
The Papers publica cada documento canónico como una versión IA en una URL permanente: una página para personas, Markdown con front matter (URL canónica, versión, estado, preparación para IA) y JSON con bloques, métricas y procedencia por página. Un índice del Data Room en /{room}/llms.txt y /{room}/index.md enumera todos los documentos.
Antes de publicar, cada número, fecha y periodo debe coincidir con la fuente, y las matizaciones como «hasta» siguen unidas a su cifra. Al actualizar un documento se conservan su URL y su historial de versiones, así que el bot y los asistentes públicos siempre leen la versión vigente. La analítica muestra qué agentes de IA, rastreadores y herramientas leen cada documento y en qué formato.
Los documentos públicos pueden listarse y ser indexables, y un dominio personalizado como ai.yourcompany.com mantiene el Data Room en tu propia dirección. Es adecuado para tus documentos de referencia clave; no está pensado para la conversión masiva de un archivo completo sin comprobación de fidelidad documento a documento.
Preguntas frecuentes
- ¿Debería ser el propio centro de ayuda la fuente de verdad?
- Para las guías prácticas, a menudo sí. Para datos concretos como límites, planes y políticas, es más fácil mantener correcto un único documento canónico al que enlacen los artículos de ayuda.
- ¿Qué formato debería leer un bot de soporte?
- Los formatos de texto como Markdown o JSON facilitan la recuperación y son menos propensos a errores que los PDF. The Papers publica ambos para cada documento.
- ¿Cómo encuentran nuestros documentos los asistentes de IA públicos?
- Haz que los documentos canónicos sean públicos e indexables, y enuméralos en un índice llms.txt para que las herramientas y los rastreadores de IA puedan descubrirlos.
- ¿Qué pasa con los enlaces cuando cambia un documento?
- Con The Papers, la URL no cambia y se conserva el historial de versiones, así que no se rompe nada que enlace a él.
Dale a cada bot y agente los mismos datos de producto vigentes en un único enlace permanente.
Guías relacionadas
- Una única fuente de verdad para los agentes de IA: por qué un enlace es mejor que un adjunto
- ¿Qué es llms.txt y cómo usarlo para tus documentos?
- Cómo hacer que las listas de precios y las fichas técnicas sean legibles por la IA de un comprador
- The Papers: el data room legible por IA para founders de startups que comparten sus decks con inversores