Comment Fern crée des articles
Fern est votre agent de documentation IA qui recherche, écrit et rédige des ébauches d'articles pour votre centre d'aide. Donnez-lui une instruction, 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 instruction à Fern - Allez sur la page Fern ou appuyez sur ⌘N n'importe où dans Ferndesk. Tapez ce dont vous avez besoin (par ex., "Documenter la fonctionnalité webhooks" ou "Rédiger un guide pour la configuration SSO").
Fern effectue des recherches - Elle analyse votre code source, vos tickets de support, vos 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 de la visibilité sur sa progression.
Fern rédige l'article - Elle écrit l'article complet en se basant sur ses recherches. Le brouillon apparaît dans le gestionnaire de tâches avec le statut "Prêt pour révision".
Vous révisez et publiez - Modifiez le brouillon directement dans le gestionnaire 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 que les articles ne soient mis en ligne.
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 d'Intercom, Zendesk ou Help Scout pour identifier les questions fréquentes 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, les fichiers texte et la documentation externe que vous joignez à l'instruction
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 vos 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 produit par Fern dépend du contexte que vous fournissez. Voici comment la préparer au succès :
Rédigez des instructions 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 Paramètres → Fern pour configurer la manière dont Fern écrit et recherche :
Instructions de rédaction - Définissez votre ton préféré (par ex., "Utiliser un ton assuré et amical" ou "Écrire pour un public technique")
Instructions de recherche - Indiquez à Fern ce qu'elle doit prioriser (par ex., "Toujours parcourir le codebase pour les flux UI" 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 avez des documents de référence (spécifications, captures d'écran, vidéos, documentation existante), joignez-les directement à votre instruction. Fern les intégrera à ses recherches.
Utiliser la boîte de réception Fern
Fern identifie automatiquement les lacunes de documentation en analysant les tendances du support et votre codebase. Consultez la page Fern pour voir ses recommandations, puis attribuez des tâches directement depuis la boîte de réception.
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 nécessite plus de détails sur la gestion des erreurs". Elle peut se corriger et poursuivre son travail.
Travailler avec les brouillons
Lorsque Fern a terminé, l'ébauche apparaît dans le gestionnaire 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 (par 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 gestionnaire de tâches jusqu'à ce que vous les publiiez. Rien n'est mis en ligne sans votre approbation.