Comment Fern crée des articles
Fern est votre agent de documentation IA qui recherche, rédige et prépare des articles pour votre centre d'aide. Vous lui donnez une invite, elle se charge du reste.
Ce guide explique comment le processus fonctionne, quelles sources Fern utilise et comment obtenir les meilleurs résultats.
Comment ça fonctionne
Créer un article avec Fern suit ce flux de travail :
Donnez une invite à Fern - Accédez à la page Fern ou appuyez sur ⌘N n’importe où dans Ferndesk. Saisissez ce dont vous avez besoin (par exemple, « Documenter la fonctionnalité des webhooks » ou « Rédiger un guide pour la configuration du SSO »).
Fern effectue des recherches - Elle parcourt votre base de code, vos tickets de support, vos articles existants et tous les fichiers ou liens que vous fournissez. Vous verrez un résumé de ce qu’elle recherche.
Fern planifie le travail - Elle crée une liste de tâches indiquant chaque étape (recherche, rédaction, ajout de visuels). Cela vous donne de la visibilité sur son avancée.
Fern rédige l’article - Elle rédige l’article complet en s’appuyant sur ses recherches. Le brouillon apparaît dans le visualiseur de tâche avec le statut « Prêt à être relu ».
Vous relisez et publiez - Modifiez le brouillon directement dans le visualiseur de tâche, 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 la mise en ligne des articles.
Quelles sources Fern utilise
Fern s’appuie sur plusieurs sources pour créer une documentation précise et complète :
Votre centre d’aide - Recherche dans les articles existants pour éviter les doublons et ajouter des liens pertinents
Conversations avec le support - Analyse les tickets provenant de Intercom, Zendesk ou Help Scout pour identifier les questions fréquentes et les points de friction
Votre base de code - Parcourt vos dépôts GitHub connectés pour documenter les flux d’interface, les routes, les points de terminaison API et les messages d’erreur. Si plusieurs dépôts sont connectés, Fern peut se concentrer sur un dépôt ou une branche spécifique si nécessaire.
Fichiers et liens - Lit les PDF, les fichiers texte et la documentation externe que vous joignez à l’invite
Images - Analyse les captures d’écran et les schémas (elle ne peut pas générer d’images, seulement les décrire et les contextualiser)
Vidéos - Intègre des vidéos publiques depuis YouTube, Loom, Wistia ou Vimeo. Vous pouvez aussi téléverser des vidéos directement.
Navigation web - Recherche dans la documentation externe, les journaux des 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 accès à ces sources.
Obtenir les meilleurs résultats
La qualité du résultat de Fern dépend de la quantité de contexte que vous fournissez. Voici comment la préparer à réussir :
Rédigez des invites claires et détaillées
Soyez précis sur ce que vous voulez. Au lieu de « Documenter les webhooks », essayez « Documenter la fonctionnalité des webhooks. Couvrir les étapes de configuration, les événements disponibles, le format de la charge utile et le dépannage des erreurs courantes. »
Plus vous fournissez de détails, plus Fern peut bien rechercher et structurer l’article.
Définir des instructions globales
Allez dans Paramètres → Fern pour configurer la façon dont Fern rédige et effectue ses recherches :
Instructions de rédaction - Définissez le ton que vous préférez (par exemple, « Utiliser un ton sûr de soi et chaleureux » ou « Écrire pour un public technique »)
Instructions de recherche - Indiquez à Fern ce qu’elle doit prioriser (par exemple, « Parcourir toujours la base de code 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 à 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 invite. Fern les intégrera à ses recherches.
Utiliser les brouillons et audits PR automatiques
Lorsque Automatic PR drafts est activé, Fern peut créer des brouillons à partir des pull requests fusionnées qui modifient le comportement côté client. La sensibilité et le guidage pour les brouillons de PR dans Paramètres > Automatisations contrôlent la facilité avec laquelle ces brouillons sont créés et les règles permanentes qui s’appliquent. Toutes les PR fusionnées ne deviennent pas une tâche de rédaction.
Fern identifie également les lacunes de documentation grâce aux audits. Consultez la page Fern pour voir les résultats des audits, puis attribuez directement des tâches afin de rédiger les articles nécessaires.
Travailler avec les brouillons
Une fois que Fern a terminé, le brouillon apparaît dans le visualiseur de tâche. Vous pouvez :
Modifier directement - Utiliser l’éditeur intégré pour affiner le contenu, ajuster la mise en forme ou ajouter des sections
Demander des modifications - Envoyer un message à Fern dans le fil de la tâche pour demander des révisions (par exemple, « Ajouter une section de dépannage » ou « Raccourcir l’introduction »)
Publier quand c’est prêt - Enregistrer puis publier l’article dans la collection de votre centre d’aide
Les brouillons restent dans le visualiseur de tâche jusqu’à ce que vous les publiiez. Rien n’est mis en ligne sans votre approbation.
Les tâches très longues peuvent afficher un séparateur Context compacted dans le fil. Il s’agit d’un comportement automatique qui permet à la tâche de continuer. Vous pouvez développer le séparateur pour consulter le résumé, et le brouillon continue normalement.
Après la publication
Fern ne publie que le contenu de la langue principale. Si la gestion automatique des langues de traduction est activée, la suite de traduction met automatiquement en file d’attente les traductions des nouveaux articles publiés. Elles apparaissent peu après la publication, et non instantanément. Pour mettre à jour les traductions existantes, utilisez le sélecteur de langue dans l’éditeur d’article ou allez dans Help Center > Translate pour retraduire tout le contenu de cette langue.