Comment Fern crée des articles
Fern est votre agent de documentation IA qui recherche, rédige et prépare des brouillons d'articles pour votre centre d'aide. Vous lui donnez une consigne, elle s'occupe du reste.
Ce guide explique le fonctionnement du processus, les sources utilisées par Fern et comment obtenir les meilleurs résultats.
Comment ça marche
La création d'un article avec Fern suit ce flux de travail :
Donnez une consigne à Fern - Allez sur la page Fern ou appuyez sur ⌘N n'importe où dans Ferndesk. Tapez ce dont vous avez besoin (ex. : « Documenter la fonctionnalité webhooks » ou « Rédiger un guide pour la configuration SSO »).
Fern effectue des recherches - Elle analyse votre codebase, les tickets de support, les articles existants, ainsi que tous les fichiers ou liens que vous fournissez. Vous verrez un récapitulatif de ses recherches.
Fern planifie le travail - Elle crée une liste de tâches montrant chaque étape (recherche, rédaction, ajout de visuels). Cela vous donne une visibilité sur sa progression.
Fern rédige le brouillon - Elle écrit l'article complet en se basant sur ses recherches. Le brouillon apparaît dans le visualiseur de tâches avec le statut « Ready to review ».
Vous révisez et publiez - Modifiez le brouillon directement dans le visualiseur de tâches, puis publiez-le dans votre centre d'aide quand vous êtes prêt.
Fern ne publie pas automatiquement. Vous gardez toujours le contrôle final avant la mise en ligne des articles.
Quelles sources Fern utilise-t-elle ?
Fern puise dans plusieurs sources pour créer une documentation précise et complète :
Votre centre d'aide - Analyse les articles existants pour éviter les doublons et ajouter des liens pertinents
Conversations de support - Analyse les tickets provenant d'Intercom, Zendesk ou Help Scout pour identifier les questions courantes et les points de friction
Votre codebase - Parcourt les dépôts GitHub pour documenter les flux d'interface utilisateur, les routes, les points de terminaison d'API et les messages d'erreur
Fichiers et liens - Lit les PDF, fichiers texte et documentations externes que vous joignez à la consigne
Images - Analyse les captures d'écran et les diagrammes (elle ne peut pas générer d'images, seulement les décrire et les contextualiser)
Vidéos - Intègre des vidéos publiques de YouTube, Loom, Wistia ou Vimeo. Vous pouvez également télécharger des vidéos directement.
Navigation Web - Recherche des documentations externes, des journaux de modifications (changelogs) ou des documents de référence
Connectez les intégrations comme GitHub et Intercom dans les paramètres de votre espace de travail pour donner à Fern l'accès à ces sources.
Obtenir les meilleurs résultats
La qualité du résultat de Fern dépend du contexte que vous fournissez. Voici comment la préparer au mieux :
Rédigez des consignes claires et détaillées
Soyez spécifique sur ce que vous voulez. Au lieu de « Documenter les webhooks », essayez « Documenter la fonctionnalité webhooks. Couvrir les étapes de configuration, les événements disponibles, le format de la charge utile (payload) et le dépannage des erreurs courantes. »
Plus vous fournissez de détails, mieux Fern pourra rechercher et structurer l'article.
Définir des instructions globales
Allez dans Settings → Fern pour configurer la manière dont Fern rédige et effectue ses recherches :
Instructions de rédaction - Définissez votre ton préféré (ex. : « Utiliser un ton assuré et amical » ou « Écrire pour un public technique »)
Instructions de recherche - Dites à Fern ce qu'elle doit prioriser (ex. : « Parcourir systématiquement la codebase pour les flux d'interface » ou « Vérifier les tickets de support pour les problèmes courants »)
Ces paramètres s'appliquent à chaque tâche créée par Fern, vous n'avez donc pas besoin de vous répéter.
Joindre des fichiers et des liens
Si vous disposez de documents de référence (spécifications, captures d'écran, vidéos, documentation existante), joignez-les directement à votre consigne. Fern les intégrera à ses recherches.
Utiliser la Inbox Fern
Fern identifie automatiquement les lacunes dans la documentation en analysant les tendances du support et votre codebase. Consultez la page Fern pour voir ses recommandations, puis assignez des tâches directement depuis la Inbox.
Si une tâche reste bloquée ou produit des résultats inattendus, envoyez un message à Fern dans le fil de discussion de la tâche avec des commentaires comme « Continue » ou « Cette section a besoin de plus de détails sur la gestion des erreurs ». Elle peut s'autocorriger et poursuivre.
Travailler avec les brouillons
Lorsque Fern a terminé, le brouillon apparaît dans le visualiseur de tâches. Vous pouvez :
Modifier directement - Utilisez l'éditeur intégré pour affiner le contenu, ajuster la mise en forme ou ajouter des sections
Demander des modifications - Envoyez un message à Fern dans le fil de la tâche pour demander des révisions (ex. : « Ajouter une section de dépannage » ou « Raccourcir l'introduction »)
Publier quand vous êtes prêt - Enregistrez et publiez l'article dans votre collection du centre d'aide
Les brouillons restent dans le visualiseur de tâches jusqu'à ce que vous les publiiez. Rien n'est mis en ligne sans votre approbation.