Un agente de soporte con IA basado en RAG (generación aumentada por recuperación) no se inventa las respuestas: encuentra el pasaje más relevante de tu documentación y responde a partir de él. Es decir, el techo de calidad de tu soporte con IA es exactamente la calidad de tu documentación.
La buena noticia: la documentación que funciona bien para la recuperación por IA es la misma que funciona bien para humanos impacientes. Esto es lo que realmente marca la diferencia.
1. Escribe títulos con forma de respuesta
La recuperación funciona por significado, pero empieza por la estructura. Una sección titulada "Facturación" no coincide con nada concreto. Una sección titulada "¿Cómo cancelo mi suscripción?" coincide con las palabras exactas que escribe un usuario frustrado a medianoche.
Revisa tus títulos: si no te imaginas a un usuario escribiéndolo como pregunta, reescríbelo como una.
2. Un tema por sección
Los documentos se dividen en fragmentos antes de indexarse. Una sección que trata de golpe reembolsos, cambios de plan y facturas se convierte en un fragmento confuso que coincide a medias con todo y no responde del todo a nada.
Mantén las secciones cortas y con un único propósito. Si un párrafo empieza con "Además,", probablemente quiere ser su propia sección.
3. Usa las palabras que usan tus usuarios
Tú dices "espacio de trabajo", tus usuarios dicen "cuenta". Tú dices "credenciales de autenticación", ellos dicen "contraseña". La búsqueda semántica cubre parte de esa distancia, pero cada paso de traducción cuesta precisión.
Toma el vocabulario directamente de correos de soporte reales: son un corpus gratuito de cómo expresan las cosas tus usuarios de verdad.
4. Indica límites y precios como hechos, en un solo lugar
Las preguntas más peligrosas para un agente de IA son las que tienen que ver con números: precios, cuotas, plazos. Si tus precios aparecen en cuatro sitios con tres valores distintos, la IA acabará citando el desactualizado.
Mantén una única sección de referencia para precios y límites, y actualízala en cuanto algo cambie. En el resto de sitios, enlaza a ella en lugar de repetirla.
5. No escondas respuestas en capturas de pantalla
El texto dentro de las imágenes es invisible para la recuperación. Una captura de tu página de ajustes con una flecha señalando el botón de exportar no responde a nada; la frase "Ve a Ajustes → Datos → Exportar para descargar tus datos en CSV" lo responde para siempre.
Las capturas están bien como ilustración. Solo asegúrate de que las palabras también existan como palabras.
6. Deja que los huecos te digan qué escribir después
Nunca podrás predecir todas las preguntas de antemano, y no te hace falta. El informe de huecos de conocimiento de Resply enumera las preguntas que la IA no pudo responder con seguridad, ordenadas por la frecuencia con que aparecen.
Así la documentación deja de ser un juego de adivinanzas y se convierte en un ciclo de mejora: revisa los huecos cada semana, escribe una vez la respuesta que falta y observa cómo esa pregunta desaparece de tu bandeja de entrada. Veinte minutos a la semana bastan para que la tasa de resolución de la IA siga subiendo.
Nada de esto requiere un redactor técnico. Secciones cortas, preguntas reales como títulos, el vocabulario de tus usuarios y un vistazo semanal a los huecos: ese es todo el manual.