Comment Fern crée des articles
Fern est votre agent de documentation IA qui recherche, écrit et rédige des brouillons d'articles pour votre centre d'aide. Vous lui donnez 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 - 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 SSO »).
Fern effectue des recherches - Elle scanne 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 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 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 puise dans 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 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, 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 de la documentation externe, des journaux de modifications ou des 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é des résultats de Fern dépend du contexte que vous fournissez. Voici comment la mettre sur la voie du succès :
Rédigez des instructions 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 (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 effectue ses recherches :
Instructions de rédaction - Définissez votre ton préféré (par exemple, « Utiliser un ton sûr et amical » ou « Écrire pour un public technique »)
Instructions de recherche - Dites à Fern ce qu'elle doit prioriser (par exemple, « Toujours parcourir la codebase pour les flux d'interface utilisateur » 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 (documents de spécifications, captures d'écran, vidéos, documentation existante), joignez-les directement à votre instruction. Fern les intégrera à ses recherches.
Utiliser les audits
Fern identifie automatiquement les lacunes de documentation grâce aux audits. Consultez la page Fern pour voir les résultats de l'audit, puis assignez 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 discussion de la tâche avec des commentaires tels que « 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 quand vous êtes 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.
Après la publication
Si vous avez activé les langues de traduction gérées automatiquement, les traductions des articles nouvellement publiés sont mises en file d'attente automatiquement. Elles apparaissent peu après la publication plutôt qu'instantanément.