Cómo crear una base de conocimiento: artículos, búsqueda, permisos y respuestas con IA

Una base de conocimiento es una biblioteca con búsqueda de respuestas: cómo hacer algo, cómo arreglar algo, cuál es la norma. Para crear una necesitas artículos agrupados en unas pocas categorías claras, un editor que tus redactores vayan a usar de verdad, una búsqueda que encuentre el artículo correcto a partir de las palabras que la gente escribe realmente, y una decisión sobre quién puede leer qué: el público, los clientes que han iniciado sesión o solo el personal. Un creador de apps con IA puede generar la estructura, el editor y la búsqueda en una sesión corta. Lo que hace útil una base de conocimiento es la redacción y el mantenimiento, así que diséñala desde el primer día para editarla con facilidad y para detectar artículos desactualizados.

Decide primero para quién es

Las mismas funciones sirven a sitios muy distintos:

• Centro de ayuda público: para clientes y posibles clientes. Debe ser rápido, indexable por los buscadores y estar escrito con sus propias palabras.
• Documentación solo para clientes: detrás de un inicio de sesión, para clientes de pago o socios.
• Base de conocimiento interna: políticas, procesos y guías para el personal. Debe ser privada; la búsqueda y la actualización importan más que el diseño.

Mezclar artículos públicos e internos en un mismo sitio es el origen de la mayoría de las filtraciones. Si necesitas ambos, asigna a cada artículo un ajuste de visibilidad claro, o usa dos sitios separados.

Qué necesita la app

Datos

Dos campos hacen mucho trabajo: responsable (quién mantiene el artículo preciso) y última revisión (cuándo alguien confirmó por última vez que sigue siendo cierto). Juntos permiten listar los artículos que nadie ha comprobado en seis meses.

Páginas

• Lector: inicio con búsqueda y categorías, páginas de categoría, páginas de artículo con un índice, artículos relacionados y una pregunta "¿Te ha sido útil?".
• Editor: lista de artículos con filtros (borradores, obsoletos, mal valorados), un editor con vista previa e historial de revisiones.
• Administración: categorías, usuarios y roles, e informes de las búsquedas sin resultados.

Permisos

Los lectores ven los artículos publicados a los que tienen acceso. Los editores crean y editan artículos, quizá limitados a ciertas categorías. Los administradores publican, archivan y gestionan usuarios. En una base de conocimiento interna, todos necesitan iniciar sesión; en un centro de ayuda público, solo los redactores.

Decisiones y compromisos

Editor: Markdown o texto enriquecido

Markdown es rápido, portable y encaja bien con el historial de versiones, pero a algunos redactores les resulta incómodo. Un editor de texto enriquecido con títulos, listas, imágenes, recuadros de aviso y bloques de código resulta familiar. Elijas lo que elijas, guarda el contenido en un formato que puedas exportar más adelante.

Búsqueda

La búsqueda de texto básica de la base de datos basta para unos cientos de artículos si buscas en títulos, resúmenes y contenidos, y das prioridad a las coincidencias en el título. A partir de ahí, o si importan las erratas y los sinónimos ("factura" frente a "recibo"), usa una búsqueda de texto completo de calidad o un servicio de búsqueda alojado. Nuestra guía para añadir búsqueda repasa las opciones. Registra cada consulta que no devuelva nada: es una lista gratuita de artículos que te faltan por escribir.

Respuestas con IA

Un cuadro de "haz una pregunta" que responde a partir de tus artículos es hoy habitual. Funciona recuperando los fragmentos más relevantes y pidiendo a un modelo de lenguaje que responda solo con ellos; consulta qué es RAG. Muestra siempre los artículos de origen, permite la respuesta "no lo sé" y ten en cuenta que repetirá con seguridad cualquier cosa desactualizada que haya en tus artículos. Constrúyela cuando los artículos ya estén en buen estado, no antes.

Versiones y revisión

Guarda las revisiones para ver quién cambió qué y poder volver atrás. Para contenido regulado (políticas de RR. HH., procedimientos de seguridad), añade un paso de aprobación antes de publicar un cambio.

Un primer prompt que funciona

Crea un centro de ayuda público para Parcelly, una app de etiquetas de envío para pequeñas tiendas online. Página de inicio con un cuadro de búsqueda grande y seis categorías (Primeros pasos, Imprimir etiquetas, Transportistas, Facturación, Devoluciones, Solución de problemas). Los artículos tienen título, resumen, contenido en Markdown con imágenes y recuadros de aviso, categoría, etiquetas, estado (borrador, publicado, archivado), responsable y fecha de última revisión. Las páginas de artículo muestran un índice, artículos relacionados y una pregunta "¿Te ha sido útil?" de sí/no con un comentario opcional. La búsqueda cubre títulos, resúmenes y contenidos, con las coincidencias en el título primero, y registra cada consulta y si devolvió resultados. Un área de edición (requiere inicio de sesión, roles de editor y administrador) lista los borradores, los artículos no revisados en 180 días y los artículos con valoraciones bajas, y guarda el historial de revisiones. Cada artículo tiene su propio título de página y meta descripción para los buscadores. Diseño limpio, sereno y legible. Pensado primero para móvil.

Pasos de construcción

1. Enumera tus primeros 20 o 30 artículos a partir de preguntas reales de soporte antes de construir nada. Esa lista da forma a las categorías.
2. Genera el sitio y comprueba la lectura en el móvil: longitud de línea, títulos, imágenes.
3. Editor y roles. Los redactores deben poder añadir y corregir artículos sin pedir ayuda a un desarrollador.
4. Búsqueda, y pruébala con las palabras que usan los clientes, incluidas las erratas.
5. Valoraciones y registro de búsquedas.
6. Informe de artículos obsoletos basado en el responsable y la fecha de última revisión.
7. Lo básico de SEO para un sitio público: títulos y descripciones únicos, URLs limpias, un mapa del sitio. Consulta SEO para webs creadas con IA.
8. Enlázalo desde tu producto y tus respuestas de soporte, y revisa cada semana el registro de búsquedas sin resultados.
9. Respuestas con IA, una vez que el contenido sea sólido.

Errores comunes

• Organizar por departamento en lugar de por lo que el lector intenta hacer.
• Artículos largos que cubren cinco tareas. Una tarea por artículo, con un título que diga qué soluciona.
• Ningún responsable por artículo. Nadie actualiza nada, y la confianza cae tras la primera respuesta incorrecta.
• Notas internas en artículos públicos. Usa visibilidades separadas y revisa antes de publicar.
• Una búsqueda que solo coincide con los títulos. Los lectores escriben síntomas, no nombres de artículos.
• Capturas de pantalla sin texto alternativo ni contexto. Quedan obsoletas rápido; describe también el paso con palabras.

Cuándo es mejor un producto ya hecho

Si tu equipo ya trabaja en una herramienta de documentación o wiki, una base de conocimiento interna allí suele ser el camino de menor resistencia; nuestra comparativa Notion frente a Confluence cubre dos opciones habituales. Si usas un producto de mesa de ayuda, su centro de ayuda integrado enlaza los artículos con los tickets y sugiere artículos a los clientes, algo difícil de replicar. Los generadores de sitios de documentación son ideales para la documentación de desarrolladores que vive junto al código.

Crea la tuya propia cuando necesites tu propia estructura o permisos (artículos por cliente, por ubicación o por rol), quieras la base de conocimiento dentro de tu producto y no en un sitio aparte, necesites pasos de revisión y aprobación que una wiki no impone, o quieras respuestas con IA sobre tu contenido sin otra suscripción. Encaja bien con una mesa de ayuda propia.

Cómo crearla con Mythex

En Mythex describes la base de conocimiento en el chat y se construye en una vista previa en directo; los artículos, las revisiones y las valoraciones se guardan en una base de datos Postgres que el agente añade cuando hace falta, y las imágenes van al almacenamiento de archivos del proyecto. El inicio de sesión de los editores usa un método de autenticación que tú eliges, ya que Mythex no incluye un inicio de sesión integrado para usuarios finales. Para las respuestas con IA, usas la clave de API de tu propio proveedor de IA guardada como secreto del proyecto, y el uso se factura en tu cuenta del proveedor, no en los créditos de Mythex (receta de IA). Las apps nuevas de Mythex usan por defecto una aplicación de una sola página en React renderizada en el cliente, que funciona peor con los buscadores; por eso, para un centro de ayuda público, pide una configuración compatible con sitios estáticos o renderizada en el servidor, como Next.js (receta de SEO).

Como punto de partida, prueba las plantillas centro de conocimiento de producto o aplicación de documentación de equipo.

Preguntas