Cómo preparar la documentación para la IA con ChatGPT y Claude
Qué hace que un centro de ayuda sea legible para ChatGPT, Claude, Perplexity y los agentes de IA: HTML rastreable, las reglas correctas en robots.txt, artículos que responden directamente y un análisis honesto sobre llms.txt y MCP.
Berkay Akpolat15 min de lectura
Actualizado el 3 de noviembre de 2026
Para que tu documentación esté lista para la IA, empieza por lo básico que ha demostrado ser importante: los rastreadores de IA deben poder obtener tus páginas como HTML plano, tu robots.txt debe permitir el acceso a los bots de búsqueda y cada artículo debe responder a una pregunta con claridad, indicando el plan, el rol y los límites. Mantén las páginas actualizadas y añade copias en Markdown, un llms.txt y un servidor MCP para agentes de IA. Esos extras son económicos, pero su efecto medido en las respuestas de la IA es pequeño por ahora.
Esta guía es para responsables de soporte cuyos clientes ahora preguntan a ChatGPT, Perplexity o a los resúmenes de IA de Google cómo usar tu producto, y para equipos cuyos desarrolladores usan Claude Code o Cursor en tu documentación. Separa lo que tiene pruebas detrás de lo que sigue siendo una apuesta.
¿Qué significa documentación preparada para la IA?
La documentación preparada para la IA es aquella que los sistemas de IA pueden obtener, comprender y citar correctamente: documentación legible por IA para motores de respuesta y documentación para agentes de IA que actúan sobre ella. Dos tipos de lectores son importantes:
- Motores de respuesta (búsqueda de ChatGPT, Perplexity, Claude, resúmenes de IA de Google y modo IA) responden a las preguntas de tus clientes y citan páginas como fuentes.
- Agentes de IA (Claude Code, Cursor, Codex, asistentes personalizados) leen tu documentación para realizar una tarea, a menudo a través de archivos Markdown o un servidor MCP.
Ambos están creciendo rápidamente. La encuesta de 2025 de Stack Overflow descubrió que el 84% de los desarrolladores usa o planea usar herramientas de IA, y Similarweb contabilizó 1.13 mil millones de visitas de referencia desde plataformas de IA en junio de 2025, un 357% más que el año anterior, con ChatGPT enviando más del 80% de ellas. Y cuando Google muestra un resumen de IA, la gente hace menos clics: Pew Research descubrió que los usuarios hacían clic en un enlace de resultado en el 8% de las visitas con un resumen de IA, frente al 15% sin él. Si la respuesta se muestra sin necesidad de hacer clic, más vale que sea correcta, y solo es tan correcta como tu documentación. Encontrarás más cifras sobre dónde buscan ayuda los clientes en nuestras estadísticas de autoservicio del cliente.
¿Pueden los rastreadores de IA leer realmente tu centro de ayuda?
Comprueba esto primero, porque nada más importa si la respuesta es no.
¿Está el texto en el HTML? El análisis de Vercel de diciembre de 2024 sobre el tráfico de rastreadores descubrió que ninguno de los principales rastreadores de IA renderiza JavaScript, siendo el rastreador de Gemini de Google y el de Apple las excepciones. Un centro de ayuda que carga sus artículos con JavaScript del lado del cliente puede parecer vacío para los rastreadores de ChatGPT y Claude. Pruébalo:
curl -s -A "GPTBot" https://help.example.com/your-article \
| grep "a sentence from the article"Si la frase no está en la respuesta, el rastreador tampoco la ve. Las páginas renderizadas en el servidor o prerenderizadas solucionan esto.
¿Tus URLs se resuelven? En los mismos datos de Vercel, alrededor del 35% de las peticiones de los rastreadores de ChatGPT y Claude llegan a páginas 404. Mantén las redirecciones cuando muevas o cambies el nombre de los artículos y mantén el mapa del sitio actualizado. Si vas a cambiar de plataforma, sigue una lista de verificación para la migración del centro de ayuda.
¿Es la página pública? Los motores de respuesta no pueden leer páginas detrás de un inicio de sesión. Si tienes documentación privada para clientes, acepta que las respuestas de la IA provendrán de tus páginas públicas, foros y sitios de terceros.
¿Qué bots de IA debería permitir tu robots.txt?
Cada empresa de IA ejecuta bots separados para el entrenamiento y para la búsqueda. Bloquear "todos los bots de IA" también te elimina de las respuestas de la IA.
| Bot (empresa) | Qué hace | Bloquéalo si… |
|---|---|---|
| GPTBot (OpenAI) | Recopila contenido para el entrenamiento del modelo | Quieres excluirte del entrenamiento |
| OAI-SearchBot (OpenAI) | Encuentra páginas para mostrar en la búsqueda de ChatGPT | Rara vez: bloquearlo te mantiene fuera de las respuestas de búsqueda de ChatGPT |
| ChatGPT-User (OpenAI) | Obtiene una página cuando un usuario pregunta | No es práctico: las peticiones iniciadas por el usuario pueden no seguir robots.txt |
| ClaudeBot (Anthropic) | Recopila contenido para el entrenamiento | Quieres excluirte del entrenamiento |
| Claude-SearchBot, Claude-User (Anthropic) | Indexación de búsqueda y peticiones solicitadas por el usuario | Solo para salir de las respuestas de búsqueda de Claude |
| PerplexityBot (Perplexity) | Indexa páginas para citar en respuestas, no para entrenamiento | Solo para salir de las respuestas de Perplexity |
| Perplexity-User (Perplexity) | Obtiene una página cuando un usuario pregunta | No es práctico: Perplexity dice que generalmente ignora robots.txt |
| Google-Extended (Google) | Entrenamiento de Gemini y fundamentación en aplicaciones de Gemini; no Búsqueda o resúmenes de IA | Quieres excluirte del entrenamiento y la fundamentación de Gemini |
Los detalles provienen de la propia documentación de cada empresa: OpenAI, Anthropic y Perplexity. Un centro de ayuda que quiera ser citado pero no utilizado para el entrenamiento puede decir:
User-agent: GPTBot
Disallow: /
User-agent: ClaudeBot
Disallow: /
User-agent: Google-Extended
Disallow: /
User-agent: *
Allow: /
Sitemap: https://help.example.com/sitemap.xmlUn bot que tiene su propio grupo ignora las reglas de *, así que repite cualquier línea de Disallow (como /admin) en cada grupo nombrado. Bloquear Google-Extended también evita que las aplicaciones de Gemini fundamenten las respuestas en tus páginas; la Búsqueda de Google y los resúmenes de IA no se ven afectados.
Comprueba también tu CDN o firewall. Un interruptor de "bloquear bots de IA" allí puede anular un robots.txt permisivo.
¿Cómo deberías escribir los artículos de ayuda para que la IA responda correctamente?
Los motores de respuesta extraen un pasaje, no todo tu sitio. Cada pasaje tiene que sostenerse por sí mismo.
- Una tarea por artículo, nombrada como los clientes preguntan. "Cancelar o pausar tu suscripción", no "Gestión de suscripciones".
- Respuesta primero. Las dos primeras frases bajo cada encabezado deben responder a ese encabezado. Nuestra plantilla de artículo de centro de ayuda está construida de esta manera.
- Indica las condiciones. Qué plan, qué rol, qué plataforma. "Solo los administradores pueden eliminar un espacio de trabajo" es citable; "puedes eliminar un espacio de trabajo" produce respuestas incorrectas para todos los demás.
- Di lo que el producto no puede hacer. A menudo se pregunta a los asistentes "¿puedo...?" Si tu documentación solo describe lo que existe, el modelo adivina.
- Usa un nombre por cosa y defínelo una vez. Si "espacio de trabajo", "cuenta" y "organización" significan lo mismo, elige uno y mantén una página de glosario corta que defina los términos de tu producto.
- Dale a cada página metadatos limpios. Un título específico, una descripción de una línea, una fecha de última actualización y, donde corresponda, el plan o área del producto. Los motores de respuesta y tu propia búsqueda los usan para decidir qué página responde a una pregunta.
- No escondas pasos en imágenes o vídeos. Dale a cada captura de pantalla un texto alternativo real y asegúrate de que cada paso que muestra un vídeo también exista como texto.
- Cubre lo básico antes que los casos extremos. Si todavía estás construyendo el centro de ayuda, empieza por cómo construir una base de conocimientos con IA.
- Manténlo actualizado. Un artículo desactualizado es ahora una respuesta desactualizada, repetida con confianza. Nuestra guía para mantener la documentación actualizada cubre una rutina de lanzamiento tras lanzamiento, y cómo actualizar automáticamente la documentación en cada lanzamiento muestra cómo empezar desde el propio lanzamiento.
Google dice lo mismo con palabras más sencillas: para sus funciones de IA, "no hay requisitos adicionales" y no se necesitan optimizaciones especiales más allá del SEO normal. Su guía también dice que no hay requisitos para dividir tu contenido en trozos pequeños para la IA, así que no trocees los artículos en fragmentos para adaptarlos a un modelo.
¿Deberías añadir llms.txt para la documentación?
Ayuda menos de lo que sugieren los proveedores. llms.txt es un archivo Markdown en la raíz de tu sitio que enumera tus páginas más útiles con descripciones cortas. Jeremy Howard lo propuso en septiembre de 2024 como un mapa para los modelos de lenguaje.
La evidencia hasta ahora:
- Google lo ignora. La guía de Google dice que no necesitas archivos nuevos legibles por máquina, archivos de texto para IA, marcado o Markdown para aparecer en la Búsqueda de Google, y que los archivos llms.txt no ayudarán ni perjudicarán porque la Búsqueda los ignora. En 2025, John Mueller de Google comparó llms.txt con la etiqueta meta de palabras clave.
- Pocos bots lo solicitan. Ahrefs estudió 137,210 dominios y descubrió que el 97% de los archivos llms.txt recibieron cero solicitudes en mayo de 2026. Los bots de recuperación de IA realizaron solo el 1.1% de las solicitudes que llegaron (los asistentes de IA otro 2.5%); los agentes de programación como Claude Code estuvieron entre los principales lectores nombrados.
Así que: añade un llms.txt si tu plataforma de documentación lo hace gratis, especialmente si los desarrolladores usan tu documentación con agentes de programación, pero no esperes que cambie lo que ChatGPT dice sobre ti. llms-full.txt (todas las páginas en un archivo) es una convención común, no parte de la propuesta.
¿Debería tu documentación estar disponible en Markdown?
Sí, si no te cuesta nada. Los agentes que obtienen una página funcionan mejor con Markdown limpio que con HTML lleno de navegación y scripts, y la propuesta llms.txt sugiere servir cada página en la misma URL con .md añadido. Tres detalles:
- Marca las copias en Markdown como
noindex(una cabeceraX-Robots-Tagfunciona), para que los motores de búsqueda no las traten como duplicados de las páginas HTML. - Manténlas generadas desde la misma fuente que el HTML, para que nunca se desvíen.
- Deja que los agentes las encuentren: la propuesta sugiere una etiqueta
<link rel="alternate" type="text/markdown">en cada página HTML.
¿Cómo usan los agentes de IA la documentación a través de MCP?
El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a una aplicación de IA llamar a herramientas y leer datos de otros sistemas. Un servidor MCP de documentación permite a un agente buscar en tu documentación bajo demanda en lugar de depender de lo que aprendió en el entrenamiento y, con los permisos adecuados, redactar o actualizar páginas. Para una comparación de los servidores disponibles, consulta servidores MCP para documentación.
Las mismas reglas se aplican si construyes tu propio asistente sobre tu documentación (generación aumentada por recuperación, o RAG): solo puede ser tan preciso como los pasajes que recupera. Dos advertencias: otorga acceso de solo lectura a todo lo que esté orientado al cliente a menos que una persona revise las escrituras, y recuerda que MCP ayuda a los agentes que tus usuarios conectan por sí mismos. No cambia lo que dicen los motores de respuesta públicos.
¿Cómo pruebas lo que dicen los asistentes de IA sobre tu producto?
Nadie puede ver dentro de los modelos, así que prueba el resultado. Una vez al mes:
- Escribe 20 preguntas reales de clientes de tickets y búsquedas fallidas en el centro de ayuda.
- Haz cada una en ChatGPT, Perplexity, Claude y Google (Modo IA o Resúmenes de IA).
- Registra si la respuesta es correcta y qué página cita.
| Pregunta (asistente) | Lo que dijo (fuente citada) | Solución |
|---|---|---|
| ¿Cómo exporto facturas a CSV? (ChatGPT) | Parcialmente correcto: una ruta de menú antigua (una publicación de foro de 2024) | Actualiza el artículo de exportación; pon la nueva ruta en su primer párrafo |
| ¿Puedo pausar mi suscripción? (Perplexity) | Incorrecto: dice que no es posible (sin fuente) | Añade un artículo de "Pausar o cancelar" que indique los límites del plan |
- Corrige el artículo del que debería haber provenido cada respuesta incorrecta, luego vuelve a preguntar el próximo mes.
Para ver el lado del tráfico, segmenta las visitas por referente (chatgpt.com, perplexity.ai, claude.ai) y revisa los registros de tu servidor en busca de los nombres de los bots en la tabla anterior (excepto Google-Extended, que no tiene un agente de usuario propio). Google cuenta los clics de las funciones de IA en el informe de Rendimiento de Search Console, bajo el tipo de búsqueda Web.
Cómo hacer que la documentación esté lista para la IA: la lista de verificación
| Prioridad | Tarea | Evidencia |
|---|---|---|
| 1 | Texto del artículo presente en el HTML sin JavaScript | Fuerte: los principales rastreadores de IA no renderizan JS |
| 2 | robots.txt y firewall permiten la entrada de bots de búsqueda (bots de entrenamiento opcionales) | Fuerte: documentado por cada empresa de IA |
| 3 | Una tarea por artículo, respuesta primero, plan y rol declarados | Bueno: coincide con la guía de Google |
| 4 | Contenido actualizado con cada lanzamiento; sin errores 404 | Bueno: las páginas obsoletas producen respuestas incorrectas |
| 5 | Mapa del sitio actualizado | Bueno: descubrimiento estándar |
| 6 | Copia en Markdown de cada página, noindexed | Moderado: usado por agentes de programación |
| 7 | llms.txt | Débil hasta ahora: pocas solicitudes, Google lo ignora |
| 8 | Servidor MCP para agentes | Útil para usuarios de agentes; sin efecto en respuestas públicas |
| Siempre | Prueba mensual de 20 preguntas reales | Tu propia evidencia |
Cómo se construyen los centros de ayuda de Clevera para lectores de IA
Clevera es una plataforma de IA que convierte una grabación de pantalla en un video instructivo narrado, un artículo de ayuda paso a paso y una página en tu centro de ayuda alojado, en 74 idiomas. Sus centros de ayuda alojados manejan la mayor parte de la mitad técnica de la lista de verificación, en cada plan, incluido el Gratuito:
- Páginas prerenderizadas y un mapa del sitio, para que el texto del artículo esté en el HTML que obtienen los rastreadores.
llms.txt,llms-full.txty una copia.mdde cada página, bajo la configuración llms.txt y copias en Markdown ("Permite que las herramientas de IA lean tu documentación"), que está activada por defecto. En nuestro propio centro de ayuda, las copias en Markdown se sirven connoindex. Los centros de ayuda privados (Pro y superior) mantienen todo esto detrás del inicio de sesión.- Pregunta a la IA para tus lectores (activa Mostrar el asistente en Configuración → Asistente de IA; 300 respuestas al mes en el plan Gratuito). El asistente integrado responde solo desde tus páginas publicadas, vincula sus fuentes, avisa cuando la documentación no cubre una pregunta y enumera esas preguntas en Preguntas sin respuesta para que sepas qué escribir a continuación (nuestra guía sobre brechas de contenido del centro de ayuda muestra cómo trabajar en ellas).
- Agentes de IA y MCP (Pro y superior). Claude Code, Codex, Cursor, Claude o ChatGPT pueden buscar, redactar y, con derechos de publicación, actualizar tu centro de ayuda a través del servidor MCP y la API de Clevera. Un token de Asistente de soporte solo puede buscar páginas públicas publicadas.
Esta es la parte superior del llms.txt que publica nuestro propio centro de ayuda (abreviado):
# Clevera Help Center
> Clevera turns screen recordings into polished videos: record your screen
> or let the AI record a website, edit with zooms, captions and AI
> voice-overs, then share or embed the result. ...
Every page is also available as Markdown: append `.md` to its URL.
The full text of all pages is at https://help.clevera.ai/llms-full.txt.
### Getting started
- [Understand what Clevera makes](https://help.clevera.ai/docs/getting-started/what-clevera-makes.md): ...
La mitad de la escritura sigue siendo tuya, y Clevera también ayuda allí: los artículos generados a partir de una grabación de pantalla salen como pasos numerados con capturas de pantalla de lo que hay en la pantalla, y la grabación detrás de un video también puede producir su artículo escrito, para que los pasos no vivan solo en un video. Ninguna plataforma puede prometer que ChatGPT te citará, y nosotros tampoco.
Comienza gratis con un centro de ayuda alojado, o importa el actual desde Zendesk, Intercom, GitBook y otras plataformas. La configuración está en Controla quién puede leer un sitio de documentación, Configura el asistente del sitio de documentación y Conecta agentes de IA a tus sitios de documentación. La descripción general del producto está en la página de software de centro de ayuda y en nuestra publicación de lanzamiento de sitios de documentación.
Preguntas frecuentes
¿Vale la pena añadir llms.txt a un centro de ayuda?
Añádelo si tu plataforma lo genera gratis. No cuesta nada y los agentes de programación lo leen, pero Google no lo usa y los estudios muestran casi ninguna solicitud de bots de búsqueda de IA. El HTML rastreable y los artículos claros y actuales importan mucho más.
¿Cómo hago para que ChatGPT responda correctamente las preguntas sobre mi producto?
Asegúrate de que OAI-SearchBot pueda rastrear tu centro de ayuda público, que el texto del artículo esté en el HTML y que cada artículo responda una pregunta con las condiciones establecidas. Luego, prueba las preguntas reales de los clientes mensualmente y corrige las páginas detrás de las respuestas incorrectas. Esto mejora las probabilidades; nadie puede hacer que ChatGPT te cite.
¿Debería bloquear a GPTBot y ClaudeBot?
Esa es una decisión de entrenamiento, no de visibilidad. Bloquear a GPTBot y ClaudeBot mantiene tu documentación fuera del entrenamiento de modelos; no te elimina de la búsqueda de ChatGPT o Claude, que usan OAI-SearchBot y Claude-SearchBot. No bloquees esos si quieres ser citado.
¿Ayudan los datos estructurados a los Resúmenes de IA?
Google dice que no se necesita un esquema especial para las funciones de IA. Usa datos estructurados donde describan contenido visible, como lo harías para la búsqueda normal.
¿Cuál es la diferencia entre documentación lista para IA y un chatbot de IA en mi centro de ayuda?
La documentación preparada para IA ayuda a que los asistentes externos respondan desde tus páginas. Un chatbot de centro de ayuda, como Ask AI de Clevera, responde a tus lectores en tu propio sitio desde las mismas páginas. Ambos dependen de artículos claros y actualizados.
