Cómo crea artículos Fern
Fern es tu agente de documentación con IA que investiga, escribe y redacta borradores de artículos para tu centro de ayuda. Tú le das una instrucción y ella se encarga del resto.
Esta guía explica cómo funciona el proceso, qué fuentes utiliza Fern y cómo obtener los mejores resultados.
Cómo funciona
La creación de un artículo con Fern sigue este flujo de trabajo:
Dale una instrucción a Fern - Ve a la página de Fern o pulsa ⌘N en cualquier lugar de Ferndesk. Escribe lo que necesites (por ejemplo, "Documenta la función de webhooks" o "Escribe una guía para la configuración de SSO").
Fern investiga - Escanea tu código base, los tickets de soporte, los artículos existentes y cualquier archivo o enlace que proporciones. Verás un desglose de lo que está investigando.
Fern planifica el trabajo - Crea una lista de tareas que muestra cada paso (investigación, redacción, adición de elementos visuales). Esto te permite ver su progreso.
Fern redacta el artículo - Escribe el artículo completo basándose en su investigación. El borrador aparece en el visor de tareas con el estado "Listo para revisión".
Tú revisas y publicas - Edita el borrador directamente en el visor de tareas y, después, publícalo en tu centro de ayuda cuando esté listo.
Fern no publica automáticamente. Siempre tienes el control final antes de que los artículos se publiquen.
Qué fuentes utiliza Fern
Fern extrae información de múltiples fuentes para crear documentación precisa y completa:
Tu centro de ayuda - Busca en los artículos existentes para evitar duplicados y añadir enlaces relevantes
Conversaciones de soporte - Analiza los tickets de Intercom, Zendesk o Help Scout para identificar preguntas frecuentes y puntos de dificultad
Tu código base - Explora los repositorios de GitHub para documentar flujos de interfaz de usuario, rutas, puntos finales de API y mensajes de error
Archivos y enlaces - Lee archivos PDF, archivos de texto y documentación externa que adjuntes a la instrucción
Imágenes - Analiza capturas de pantalla y diagramas (no puede generar imágenes, solo describirlas y contextualizarlas)
Vídeos - Inserta vídeos públicos de YouTube, Loom, Wistia o Vimeo. También puedes subir vídeos directamente.
Navegación web - Investiga documentación externa, registros de cambios o materiales de referencia
Conecta integraciones como GitHub e Intercom en la configuración de tu espacio de trabajo para dar acceso a Fern a estas fuentes.
Cómo obtener los mejores resultados
La calidad de lo que genera Fern depende de cuánto contexto proporciones. Aquí tienes cómo prepararla para el éxito:
Escribe instrucciones claras y detalladas
Sé específico con lo que quieres. En lugar de "Documentar webhooks", prueba con "Documenta la función de webhooks. Incluye los pasos de configuración, eventos disponibles, formato de la carga útil y resolución de errores comunes".
Cuantos más detalles proporciones, mejor podrá Fern investigar y estructurar el artículo.
Establece instrucciones globales
Ve a Configuración → Fern para configurar cómo escribe e investiga Fern:
Instrucciones de redacción - Establece tu tono preferido (por ejemplo, "Usa un tono seguro y amable" o "Escribe para audiencias técnicas")
Instrucciones de investigación - Dile a Fern qué priorizar (por ejemplo, "Busca siempre en el código base flujos de interfaz de usuario" o "Revisa los tickets de soporte para problemas comunes")
Estas configuraciones se aplican a cada tarea que crea Fern, por lo que no tienes que repetirte.
Adjunta archivos y enlaces
Si tienes materiales de referencia (documentos de especificaciones, capturas de pantalla, vídeos, documentación existente), adjúntalos directamente a tu instrucción. Fern los incorporará a su investigación.
Utiliza auditorías
Fern identifica automáticamente las lagunas en la documentación mediante auditorías. Visita la página de Fern para ver los hallazgos de las auditorías y, a continuación, asigna tareas directamente para redactar los artículos necesarios.
Si una tarea se queda atascada o produce resultados inesperados, envía un mensaje a Fern en el hilo de la tarea con comentarios como "Sigue adelante" o "Esta sección necesita más detalles sobre el manejo de errores". Ella puede corregirse y continuar.
Trabajar con borradores
Cuando Fern termina, el borrador aparece en el visor de tareas. Puedes:
Editar directamente - Usa el editor integrado para perfeccionar el contenido, ajustar el formato o añadir secciones
Pedir cambios - Envía un mensaje a Fern en el hilo de la tarea para solicitar revisiones (por ejemplo, "Añade una sección de resolución de problemas" o "Haz la introducción más corta")
Publicar cuando esté listo - Guarda y publica el artículo en la colección de tu centro de ayuda
Los borradores permanecen en el visor de tareas hasta que los publiques. Nada se hace público sin tu aprobación.
Después de publicar
Si tienes activados los idiomas de traducción gestionados automáticamente, las traducciones de los artículos recién publicados se ponen en cola de forma automática. Aparecen poco después de la publicación, en lugar de instantáneamente.