El contenido compatible con GenAI es una documentación estructurada para que las herramientas de IA puedan analizarlo, fragmentar, recuperarlo y resumirlo con precisión para responder a las consultas de los usuarios. Esta guía cubre las mejores prácticas para escribir contenido que funcione igual de bien para lectores humanos y sistemas de IA como Eddy AI.
Optimizar para motores generativos (GEO)
La Optimización de Motores Generativos (GEO) es la práctica de estructurar el contenido para que los sistemas de IA puedan recuperarlo, sintetizarlo y citarlo con precisión al responder a las consultas de los usuarios.
- A diferencia del SEO, que ayuda a que el contenido se posicione en los resultados de búsqueda, GEO determina si tu contenido es seleccionado y citado en respuestas generadas por IA.
- Para la documentación, esto significa escribir en un lenguaje claro y factual, usando terminología coherente y manteniendo cada sección centrada en una sola idea.
- Las prácticas de esta guía sirven tanto a los objetivos GEO como al SEO simultáneamente.
Qué hace que el contenido esté listo para GEO:
- Fragmentación semántica — Cada sección cubre una idea, por lo que la IA puede extraerla sin necesidad de contexto circundante.
- Lenguaje directo y factual — los motores de IA prefieren contenido que exponga los hechos claramente por encima de lo que oculta o sobreexplica.
- Capacidad de citación — Es más probable que se citen puntos de datos concretos, términos definidos y afirmaciones autorizadas en respuestas generadas por IA.
- Terminología consistente — Los sistemas de IA construyen relaciones con entidades a partir de tu contenido. Cambiar entre sinónimos debilita esas señales.
GEO y SEO no están en conflicto. El contenido estructurado para GEO también rinde mejor en la búsqueda tradicional. Las mejores prácticas de esta guía sirven a ambos objetivos simultáneamente.
Escribe primero para los humanos
- Usa un tono claro y conversacional. Esto mejora tanto la implicación del lector como la comprensión de la IA.
- Escribe en lenguaje claro y reserva los términos técnicos para situaciones donde sean necesarios, y defíneos claramente en el primer uso.
- Utiliza la segunda persona ("tú") al guiar a los usuarios a través de tareas o solucionar problemas de contenido.
- Evita frases robóticas o demasiado formales.
El contenido que se lee de forma natural es más fácil de interpretar y resumir con precisión para la IA.
Utiliza encabezados claros y jerárquicos
- Utiliza los encabezados H1, H2 y H3 para definir la estructura del contenido.
- Escribe encabezados descriptivos que reflejen el tema real. Utiliza "Gestionar proyectos en Document360" en lugar de un "Resumen" genérico.
- Evita repetir el mismo encabezado en secciones dentro de un artículo.
- Incluye de forma natural palabras clave relevantes en los encabezados para apoyar la indexación y la búsqueda por IA.
Los encabezados bien estructurados ayudan a Eddy AI a agrupar tu contenido con mayor precisión, haciendo que la recuperación y el resumen sean más fiables.
Escribe párrafos cortos y enfocados
- Mantén frases cortas y directas, idealmente por debajo de 20 palabras.
- Limita cada párrafo a una sola idea o tarea. Esto ayuda a herramientas de IA como Eddy AI a extraer y resumir información clave con mayor precisión.
- Evita explicaciones de relleno o de fondo dentro del contenido didáctico. Enlace a contenido de apoyo en su lugar.
- Mantén las secciones individuales concisas, idealmente por debajo de 500 tokens (~375 palabras) para mejorar la resumen y recuperación de la IA.
Utiliza listas y tablas para contenido estructurado
Listas:
- Usa viñetas para información agrupada como características o comparaciones.
- Utiliza listas numeradas para pasos secuenciales.
- Mantén listas entre 3 y 7 elementos, paralelas en estructura y autónomas.
Tablas:
- Utiliza tablas para datos estructurados como parámetros, ajustes o descripciones de campos.
- Etiqueta todas las columnas de forma descriptiva.
- Rellena todas las celdas. Evita marcadores de posición como "Y", "N", guiones o iconos.
- No incluyas imágenes, emojis ni símbolos dentro de las celdas. Si son inevitables, añade una descripción siempre que sea posible.
Añadir fragmentos de código con contexto
- Utiliza código limpio y consistentemente indentado con comentarios en línea significativos. Los comentarios ayudan a las herramientas de GenAI a entender la lógica, la intención y el comportamiento variable, especialmente en ejemplos de uso o guías.
- Aplica resaltado de sintaxis o etiquetas de idioma (
```javascript,```json) cuando sea compatible. - Mantén los bloques de código copiables. Evita los números de línea o el estilo decorativo.
- Para el API o producto, incluye una breve declaración de contexto explicando qué hace el código.
Incluye texto alternativo descriptivo para las imágenes
- Escribe texto alternativo que describa lo que muestra la imagen y por qué es relevante, especialmente si la imagen contiene datos, una captura de pantalla de la interfaz o instrucciones paso a paso.
- Añade pies de foto o contexto para facilitar la interpretación.
- Evita etiquetas vagas como "captura de pantalla" o "imagen del gráfico".
Utiliza texto ancla descriptivo para los enlaces
- Escribe texto ancla que explique al lector y a la IA qué cubre el artículo enlazado.
Por ejemplo, "Aprende a gestionar espacios de trabajo privados" en lugar de "Haz clic aquí." - Prioriza los enlaces internos entre artículos relacionados para ayudar a la IA a entender las relaciones temáticas.
Aplica las mejores prácticas de SEO y metadatos
- Utiliza palabras clave de forma natural en los encabezados, subtítulos y abridores de secciones. Evita el relleno de palabras clave.
- Redacta una metadescripción concisa para cada artículo que incluya las palabras clave principales. Esto ayuda a las herramientas de IA a entender el tema y mejora la precisión de la indexación.
- Sé coherente con la terminología. Utiliza términos aprobados por glosarios de forma constante para mantener la relevancia en la búsqueda.
Utiliza términos de glosario empresarial de forma consistente
- Utiliza los términos del glosario aprobados exactamente como se definen. Evita sinónimos o variaciones salvo que se indique explícitamente.
- Define o enlaza términos desconocidos en cuanto te lo menciones.
- Aplica abreviaturas y siglas estándar de forma constante en todos los artículos. No cambies arbitrariamente entre formas expandidas y abreviadas.
Incluye una sección de preguntas frecuentes
Un formato de preguntas y respuestas es una de las estructuras más efectivas para la recuperación de IA. Cada FAQ es una unidad autónoma y buscable que Eddy AI puede mostrar de forma independiente.
- Añade entre 5 y 10 preguntas y respuestas relevantes al tema del artículo.
- Busca preguntas a partir de tickets de soporte, comentarios de clientes o consultas sobre productos.
- Mantén cada respuesta concisa y autoconclusiva. Las respuestas deben entenderse sin necesidad de consultar el resto del artículo.
Monitorizar contenido generado por IA
- Si usas herramientas como el agente de escritura con IA u otros generadores de contenido impulsados por IA, revisa y refina siempre el resultado antes de publicarlo.
- Revisa si hay pensamientos incompletos, hechos alucinados o frases antinaturales que puedan afectar la credibilidad o usabilidad de tu contenido.
- Asegúrate de que el contenido esté alineado con los estándares de tu documentación, la guía de estilo y los términos del glosario.
Probar e iterar
Después de publicarlo, pregunta a Eddy AI las preguntas que tu artículo debería responder. Si las respuestas son incompletas o inexactas, revisa con más contexto, encabezados más claros o definiciones explícitas. Revisa las dudas sin respuesta con regularidad y actualiza el contenido en consecuencia.
Antes de publicar, repasa la lista de comprobación de contenido compatible con Gen AI. Para redactar con ayuda de IA, utiliza la Plantilla de Prompt de Escritura de GenAI.