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 consigne, elle s’occupe 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 workflow :
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é des webhooks » ou « Rédiger un guide pour la configuration du SSO »).
Fern effectue ses recherches - Elle parcourt votre base de code, les tickets de support, les articles existants et tous les fichiers ou liens que vous fournissez. Vous verrez un récapitulatif 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 avancement.
Fern rédige l’article - Elle rédige l’article complet à partir de ses recherches. Le brouillon apparaît dans le visualiseur de tâche avec le statut « Prêt à relire ».
Vous relisez et publiez - Modifiez directement le brouillon 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 de support - Analyse les tickets provenant d’Intercom, Zendesk ou Help Scout afin d’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 parcours d’interface, les routes, les endpoints d’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 lorsque nécessaire.
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 depuis YouTube, Loom, Wistia ou Vimeo. Vous pouvez aussi importer des vidéos directement.
Navigation web - Recherche dans la documentation externe, les journaux des changements 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 pour réussir :
Rédigez des consignes 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. Couvrez les étapes de configuration, les événements disponibles, le format des payloads et le dépannage des erreurs courantes. »
Plus vous fournissez de détails, mieux Fern peut rechercher et structurer l’article.
Définissez 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 le ton que vous préférez (par exemple, « Utiliser un ton sûr de lui et convivial » 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 parcours d’interface » ou « Vérifier les tickets de support pour les problèmes fréquents »)
Ces paramètres s’appliquent à chaque tâche créée par Fern, donc vous n’avez pas à vous répéter.
Joignez 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 à ses recherches.
Utilisez les audits
Fern identifie automatiquement les lacunes de documentation grâce aux audits. Rendez-vous sur la page Fern pour consulter les résultats des audits, puis attribuez directement des tâches pour rédiger les articles nécessaires.
Si une tâche se bloque ou produit des résultats inattendus, envoyez un message à Fern dans le fil de la tâche avec un retour comme « Continue » ou « Cette section a besoin de plus de détails sur la gestion des erreurs. » Elle peut se corriger elle-même et poursuivre.
Travailler avec les brouillons
Lorsque 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 et publier l’article dans la collection de votre centre d’aide
Les brouillons restent dans le visualiseur de tâche jusqu’à leur publication. 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 se poursuit normalement. Consultez Context compaction in task threads pour plus de détails.
Après la publication
Si la gestion automatique des langues de traduction est activée, les traductions des articles nouvellement publiés sont mises en file d’attente automatiquement. Elles apparaissent peu après la publication, et non instantanément.