Utiliser Fern pour créer et modifier des articles
Les tâches sont le moyen par lequel vous indiquez à Fern ce qu'il faut créer ou mettre à jour dans votre centre d'aide. Fern s'occupe de la recherche et de la rédaction, vous fournissez les instructions et révisez les résultats.
Les tâches sont accessibles depuis la barre latérale de votre tableau de bord sous « Fern » à l'adresse app.ferndesk.com/fern
Créer une tâche
Il existe trois façons de créer des tâches :
1. Depuis le tableau de bord Fern
Naviguez vers la barre latérale du tableau de bord → Fern. Vous verrez la zone de saisie Fern en haut, où vous pouvez taper des instructions en langage naturel.
Prompts libres : Taper ce dont vous avez besoin en langage clair. Soyez spécifique pour obtenir de meilleurs résultats :
« Rédige un guide de démarrage pour les nouveaux utilisateurs »
« Mets à jour l'article sur l'authentification API avec le nouveau flux OAuth »
« Crée une documentation de dépannage pour les erreurs de connexion »
Modèles rapides : Cliquez sur n'importe quelle carte de modèle sous la zone de saisie pour pré-remplir les demandes courantes.
2. Depuis les Recommandations de votre boîte de réception
Lorsque Fern identifie des lacunes de contenu ou des articles obsolètes via les recommandations, vous pouvez cliquer sur « Assigner à Fern » pour générer automatiquement une tâche avec le contexte déjà attaché.
3. Depuis les tickets Linear (si intégré)
Si vous avez connecté Linear, vous pouvez créer des tâches de documentation directement depuis les tickets Linear. Voir Comment utiliser Fern dans les tickets Linear.
Ajouter du contexte aux tâches
Plus vous fournissez de contexte, meilleur sera le résultat de Fern. Vous pouvez joindre :
Fichiers :
Images : PNG, JPEG, GIF, WebP
Vidéos : MP4, WebM, QuickTime
Documents : PDF, TXT, DOC, XLS, CSV
Liens : Collez des URL externes ou des vidéos YouTube pour que Fern s'y réfère.
Références : Sélectionnez des articles existants, des collections ou des fils de discussion de support pour donner à Fern des informations contextuelles.
Glissez-déposez des fichiers, collez des captures d'écran ou utilisez les boutons de pièce jointe dans la boîte de dialogue de création de tâche.
Soyez spécifique dans vos prompts. Au lieu de « écrire sur les webhooks », essayez « rédiger un guide de configuration pour les webhooks avec des exemples de code montrant la structure de la charge utile ».
Ce que les tâches peuvent faire
Fern peut gérer plusieurs types de travaux de documentation :
Créer de nouveaux articles à partir de zéro basés sur votre description
Mettre à jour le contenu existant pour refléter les changements de produit ou corriger des erreurs
Rechercher et rédiger à partir de signaux de support, de recommandations ou d'audits
Éditer pour plus de clarté en réécrivant des sections ou en améliorant la structure
Ce que les tâches ne peuvent pas faire
Créer de nouvelles collections : modifier la structure de votre centre d'aide
Répondre à des questions sur l'utilisation de Ferndesk : trouvez plutôt les réponses dans notre centre d'aide.
Suivre la progression d'une tâche
Une fois la tâche créée, elle apparaît dans la liste des tâches sur la barre latérale.
Les tâches ayant des brouillons non publiés affichent une icône d'article pour que vous sachiez ce qui est en attente de révision.
La liste s'actualise automatiquement au fur et à mesure que les tâches progressent. Vous recevrez également une notification par e-mail lorsqu'une tâche est prête à être révisée, ainsi que des notifications push si elles sont activées.
Révision et publication
Lorsque Fern termine la rédaction d'un article, celui-ci apparaît au bas de votre tâche.
Si le résultat vous convient : Cliquez sur « Publier l'article (ou les articles) » pour le mettre en ligne immédiatement dans votre centre d'aide.
S'il nécessite des modifications : Vous pouvez envoyer un message à Fern avec des instructions supplémentaires (ex : « ajoute plus d'exemples de code » ou « adopte un ton moins technique »), ou fermer la tâche et en créer une nouvelle avec des instructions affinées.
Si vous n'en voulez pas : Fermez ou ignorez la tâche. Rien n'est publié sans votre approbation explicite.
Les tâches qui se bloquent ou stagnent peuvent généralement être relancées en envoyant un message à Fern dans le fil de discussion de la tâche lui demandant de continuer.
Conseils pour de meilleurs résultats
@mentionner des articles ou des collections : pour dire à Fern de se concentrer sur eux.
Fournir des exemples : Si vous souhaitez un format ou un style spécifique, incluez un exemple ou référencez un article similaire.
Joindre des documents de support : Captures d'écran, documents de spécifications, exemples de réponses API : tout ce qui aide Fern à comprendre la fonctionnalité.
Lier du contenu connexe : Référencez des articles existants pour que Fern maintienne la cohérence avec votre documentation actuelle.
Être direct sur le ton et l'audience : Précisez si vous écrivez pour des développeurs, des utilisateurs finaux, des administrateurs, etc.
Problèmes courants
La tâche semble bloquée : Envoyez un message à Fern dans le fil de la tâche pour reprendre la progression.
Types de fichiers non pris en charge : Convertissez les fichiers dans des formats pris en charge (PDF pour les documents, PNG, JPEG ou WEBP pour les images) avant de les joindre.
Le résultat ne correspond pas aux attentes : Réessayez avec un prompt plus détaillé, du contexte supplémentaire ou des exemples de référence de ce que vous souhaitez.