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.
Fonctionnement
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 (par exemple, "Documenter la fonctionnalité webhooks" ou "Rédiger un guide pour la configuration SSO").
Fern effectue des recherches - Elle scanne votre base de code, vos tickets d'assistance, 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 le brouillon - Elle rédige 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 lorsqu'il est 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 s'appuie sur plusieurs sources pour créer une documentation précise et complète :
Votre centre d'aide - Parcourt les articles existants pour éviter les doublons et ajouter des liens pertinents
Conversations d'assistance - Analyse les tickets d'Intercom, Zendesk ou Help Scout pour identifier les questions fréquentes et les points de friction
Votre base de code - 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 à 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 - Effectue des recherches dans la documentation externe, les journaux de modifications ou les documents de référence
Connectez des 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 travail 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éfinissez des instructions globales
Allez dans Paramètres → 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é (par exemple, "Utiliser un ton assuré et amical" ou "Écrire pour un public technique")
Instructions de recherche - Dites à Fern ce qu'elle doit prioriser (par exemple, "Toujours parcourir la base de code pour les flux d'interface utilisateur" ou "Vérifier les tickets d'assistance 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 consigne. Fern les intégrera dans ses recherches.
Utilisez les audits
Fern identifie automatiquement les lacunes dans votre documentation grâce aux audits. Consultez la page Fern pour voir les résultats d'audit, puis assignez directement des tâches pour rédiger les articles nécessaires.
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 un commentaire comme "Continue" ou "Cette section nécessite plus de détails sur la gestion des erreurs". Elle pourra se corriger et continuer.
Travailler avec les brouillons
Lorsque Fern a terminé, le brouillon 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 discussion de la tâche pour demander des révisions (par exemple, "Ajouter une section de dépannage" ou "Raccourcir l'introduction")
Publier dès que prêt - Enregistrez et publiez l'article dans la collection de votre 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.