Cómo Fern crea artículos
Fern es tu agente de documentación con IA que investiga, redacta y prepara artículos para tu centro de ayuda. Tú le das una indicación y ella se encarga del resto.
Esta guía explica cómo funciona el proceso, qué fuentes usa Fern y cómo obtener los mejores resultados.
Cómo funciona
Crear un artículo con Fern sigue este flujo de trabajo:
Dale a Fern una indicación - Ve a la página de Fern o pulsa ⌘N en cualquier parte de Ferndesk. Escribe lo que necesitas (por ejemplo, "Documenta la función de webhooks" o "Escribe una guía para la configuración de SSO").
Fern investiga - Ella revisa tu base de código, 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 - Ella crea una lista de tareas pendientes que muestra cada paso (investigación, redacción, añadir elementos visuales). Esto te da visibilidad sobre su progreso.
Fern redacta el artículo - Ella escribe el artículo completo basándose en su investigación. El borrador aparece en el visor de tareas con el estado "Ready to review".
Tú revisas y publicas - Edita el borrador directamente en el visor de tareas y, cuando esté listo, publícalo en tu centro de ayuda.
Fern no publica automáticamente. Siempre tienes el control final antes de que los artículos se publiquen.
Qué fuentes usa Fern
Fern toma información de varias 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 tickets de Intercom, Zendesk o Help Scout para identificar preguntas frecuentes y puntos de fricción
Tu base de código - Revisa tus repositorios de GitHub conectados para documentar flujos de interfaz, rutas, endpoints de API y mensajes de error. Si tienes varios repositorios conectados, Fern puede centrarse en un repositorio o rama concreta cuando sea necesario.
Archivos y enlaces - Lee PDFs, archivos de texto y documentación externa que adjuntes a la indicación
Imágenes - Analiza capturas de pantalla y diagramas (no puede generar imágenes, solo describirlos y darles contexto)
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 a Fern acceso a estas fuentes.
Obtener los mejores resultados
La calidad del resultado de Fern depende de cuánto contexto proporciones. Así puedes prepararla para el éxito:
Escribe indicaciones claras y detalladas
Sé específico sobre lo que quieres. En lugar de "Documentar webhooks", prueba con "Documenta la función de webhooks. Cubre los pasos de configuración, los eventos disponibles, el formato del payload y cómo solucionar errores comunes".
Cuanto más detalle proporciones, mejor podrá Fern investigar y estructurar el artículo.
Configura instrucciones globales
Ve a Configuración → Fern para definir cómo escribe e investiga Fern:
Instrucciones de redacción - Define el tono que prefieras (por ejemplo, "Usa un tono seguro y cercano" o "Escribe para audiencias técnicas")
Instrucciones de investigación - Indica a Fern qué debe priorizar (por ejemplo, "Consulta siempre la base de código para los flujos de interfaz" o "Revisa los tickets de soporte en busca de problemas comunes")
Estos ajustes se aplican a cada tarea que crea Fern, así que no tienes que repetirlo.
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 indicación. Fern los incorporará a su investigación.
Usa auditorías
Fern identifica automáticamente lagunas de documentación mediante auditorías. Visita la página de Fern para ver los hallazgos de auditoría y luego 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" o "Esta sección necesita más detalle 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 refinar 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 solución de problemas" o "Haz más corta la introducción")
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 publica sin tu aprobación.
Las tareas muy largas pueden mostrar un separador Context compacted en el hilo. Es un comportamiento automático que mantiene la tarea en ejecución. Puedes desplegar el separador para revisar el resumen, y el borrador continúa normalmente. Consulta Context compaction in task threads para obtener más detalles.
Después de publicar
Si tienes activadas las traducciones gestionadas automáticamente, las traducciones de los artículos recién publicados se ponen en cola automáticamente. Aparecen poco después de la publicación, no al instante.