Cómo crea artículos Fern
Fern es su agente de documentación con IA que investiga, escribe y redacta borradores de artículos para su centro de ayuda. Usted le da 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:
Dé una instrucción a Fern: vaya a la página de Fern o presione ⌘N en cualquier lugar de Ferndesk. Escriba lo que necesita (p. ej., "Documentar la función de webhooks" o "Escribir una guía para la configuración de SSO").
Fern investiga: escanea su código base, tickets de soporte, artículos existentes y cualquier archivo o enlace que usted proporcione. Verá 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 le 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 revisar".
Usted revisa y publica: edite el borrador directamente en el visor de tareas y publíquelo en su centro de ayuda cuando esté listo.
Fern no publica automáticamente. Usted siempre tiene 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:
Su centro de ayuda: busca en los artículos existentes para evitar duplicados y añadir enlaces pertinentes.
Conversaciones de soporte: analiza tickets de Intercom, Zendesk o Help Scout para identificar preguntas frecuentes y puntos críticos.
Su código base: navega por los repositorios de GitHub para documentar flujos de IU, rutas, puntos finales de API y mensajes de error.
Archivos y enlaces: lee archivos PDF, archivos de texto y documentación externa que usted adjunte 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 puede subir vídeos directamente.
Navegación web: investiga documentación externa, registros de cambios o materiales de referencia.
Conecte integraciones como GitHub e Intercom en la configuración de su espacio de trabajo para dar acceso a Fern a estas fuentes.
Cómo obtener los mejores resultados
La calidad de los resultados de Fern depende de cuánto contexto proporcione. A continuación le indicamos cómo prepararla para el éxito:
Escriba instrucciones claras y detalladas
Sea específico sobre lo que desea. En lugar de "Documentar webhooks", intente con "Documentar la función de webhooks. Incluir pasos de configuración, eventos disponibles, formato de carga útil y solución de errores comunes".
Cuanto más detalle proporcione, mejor podrá Fern investigar y estructurar el artículo.
Establezca instrucciones globales
Vaya a Configuración → Fern para configurar cómo Fern escribe e investiga:
Instrucciones de redacción: establezca su tono preferido (p. ej., "Usar un tono seguro y amable" o "Escribir para audiencias técnicas").
Instrucciones de investigación: dígale a Fern qué priorizar (p. ej., "Navegar siempre por el código base para flujos de IU" o "Revisar tickets de soporte para problemas comunes").
Estos ajustes se aplican a cada tarea que Fern crea, por lo que no tendrá que repetirse.
Adjunte archivos y enlaces
Si tiene materiales de referencia (documentos de especificaciones, capturas de pantalla, vídeos, documentación existente), adjúntelos directamente a su instrucción. Fern los incorporará a su investigación.
Use auditorías
Fern identifica automáticamente las lagunas en la documentación mediante auditorías. Visite la página de Fern para ver los resultados de la auditoría y asigne tareas directamente para redactar los artículos necesarios.
Si una tarea se queda atascada o produce resultados inesperados, envíe un mensaje a Fern en el hilo de la tarea con comentarios como "Continúa" 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. Usted puede:
Editar directamente: use el editor integrado para refinar el contenido, ajustar el formato o añadir secciones.
Solicitar cambios: envíe un mensaje a Fern en el hilo de la tarea para solicitar revisiones (p. ej., "Añadir una sección de solución de problemas" o "Hacer la introducción más corta").
Publicar cuando esté listo: guarde y publique el artículo en la colección de su centro de ayuda.
Los borradores permanecen en el visor de tareas hasta que los publica. Nada se hace público sin su aprobación.