Wie Fern Artikel erstellt
Fern ist Ihre KI-Dokumentations-Agentin, die Artikel für Ihr Help Center recherchiert, schreibt und entwirft. Sie geben ihr einen Prompt, sie kümmert sich um den Rest.
Dieser Leitfaden erklärt, wie der Prozess funktioniert, welche Quellen Fern nutzt und wie Sie die besten Ergebnisse erzielen.
Wie es funktioniert
Die Erstellung eines Artikels mit Fern folgt diesem Workflow:
Geben Sie Fern einen Prompt – Gehen Sie auf die Fern-Seite oder drücken Sie an einer beliebigen Stelle in Ferndesk ⌘N. Geben Sie ein, was Sie benötigen (z. B. "Dokumentiere die Webhooks-Funktion" oder "Schreibe eine Anleitung für das SSO-Setup").
Fern recherchiert – Sie scannt Ihre Codebasis, Support-Tickets, bestehende Artikel sowie alle von Ihnen bereitgestellten Dateien oder Links. Sie sehen eine Aufschlüsselung dessen, was sie gerade recherchiert.
Fern plant die Arbeit – Sie erstellt eine To-do-Liste, die jeden Schritt zeigt (Recherche, Schreiben, Hinzufügen von Bildmaterial). Dies gibt Ihnen Einblick in ihren Fortschritt.
Fern entwirft den Artikel – Sie schreibt den vollständigen Artikel basierend auf ihrer Recherche. Der Entwurf erscheint im Task-Viewer mit dem Status "Ready to review".
Sie prüfen und veröffentlichen – Bearbeiten Sie den Entwurf direkt im Task-Viewer und veröffentlichen Sie ihn in Ihrem Help Center, wenn er fertig ist.
Fern veröffentlicht nicht automatisch. Sie haben immer die endgültige Kontrolle, bevor Artikel live gehen.
Welche Quellen Fern nutzt
Fern bezieht Informationen aus mehreren Quellen, um eine genaue und vollständige Dokumentation zu erstellen:
Ihr Help Center – Durchsucht vorhandene Artikel, um Dubletten zu vermeiden und relevante Links hinzuzufügen
Support-Konversationen – Analysiert Tickets von Intercom, Zendesk oder Help Scout, um häufige Fragen und Probleme zu identifizieren
Ihre Codebasis – Durchsucht GitHub-Repos, um UI-Flows, Routen, API-Endpunkte und Fehlermeldungen zu dokumentieren
Dateien und Links – Liest PDFs, Textdateien und externe Dokumentationen, die Sie dem Prompt beifügen
Bilder – Analysiert Screenshots und Diagramme (sie kann keine Bilder generieren, sondern diese nur beschreiben und kontextualisieren)
Videos – Bettet öffentliche Videos von YouTube, Loom, Wistia oder Vimeo ein. Sie können Videos auch direkt hochladen.
Web-Browsing – Recherchiert in externen Dokumentationen, Changelogs oder Referenzmaterialien
Verknüpfen Sie Integrationen wie GitHub und Intercom in Ihren Workspace-Einstellungen, um Fern Zugriff auf diese Quellen zu geben.
Die besten Ergebnisse erzielen
Die Qualität der Ergebnisse von Fern hängt davon ab, wie viel Kontext Sie bereitstellen. So bereiten Sie sie optimal vor:
Schreiben Sie klare, detaillierte Prompts
Seien Sie spezifisch bei Ihren Wünschen. Anstatt "Dokumentiere Webhooks", versuchen Sie es mit "Dokumentiere die Webhooks-Funktion. Gehe auf die Einrichtungsschritte, verfügbare Events, das Payload-Format und die Fehlerbehebung bei häufigen Fehlern ein."
Die mehr Details Sie angeben, desto besser kann Fern den Artikel recherchieren und strukturieren.
Globale Anweisungen festlegen
Gehen Sie zu Settings → Fern, um zu konfigurieren, wie Fern schreibt und recherchiert:
Anweisungen für Entwürfe – Legen Sie Ihren bevorzugten Tonfall fest (z. B. "Verwende einen selbstbewussten, freundlichen Ton" oder "Schreibe für ein technisches Publikum")
Anweisungen für die Recherche – Sagen Sie Fern, was Priorität hat (z. B. "Durchsuche immer die Codebasis nach UI-Flows" oder "Prüfe Support-Tickets auf häufige Probleme")
Diese Einstellungen gelten für jede Aufgabe, die Fern erstellt, sodass Sie sich nicht wiederholen müssen.
Dateien und Links anhängen
Wenn Sie Referenzmaterialien haben (Spezifikationsdokumente, Screenshots, Videos, bestehende Dokumentation), hängen Sie diese direkt an Ihren Prompt an. Fern wird sie in ihre Recherche einbeziehen.
Audits nutzen
Fern identifiziert Dokumentationslücken automatisch durch Audits. Besuchen Sie die Fern-Seite, um Audit-Ergebnisse zu sehen, und weisen Sie Aufgaben direkt zu, um die benötigten Artikel zu entwerfen.
Wenn eine Aufgabe stockt oder unerwartete Ergebnisse liefert, schreiben Sie Fern im Task-Thread eine Nachricht mit Feedback wie "Mach weiter" oder "Dieser Abschnitt benötigt mehr Details zur Fehlerbehandlung". Sie kann sich selbst korrigieren und fortfahren.
Mit Entwürfen arbeiten
Wenn Fern fertig ist, erscheint der Entwurf im Task-Viewer. Sie können:
Direkt bearbeiten – Nutzen Sie den integrierten Editor, um Inhalte zu verfeinern, die Formatierung anzupassen oder Abschnitte hinzuzufügen
Änderungen anfordern – Senden Sie Fern eine Nachricht im Task-Thread, um Überarbeitungen anzufordern (z. B. "Füge einen Abschnitt zur Fehlerbehebung hinzu" oder "Mach die Einleitung kürzer")
Veröffentlichen, wenn fertig – Speichern und veröffentlichen Sie den Artikel in Ihrer Help-Center-Sammlung
Entwürfe bleiben im Task-Viewer, bis Sie sie veröffentlichen. Nichts geht ohne Ihre Zustimmung live.
Nach der Veröffentlichung
Wenn Sie automatisch verwaltete Übersetzungssprachen aktiviert haben, werden Übersetzungen für neu veröffentlichte Artikel automatisch in die Warteschlange gestellt. Sie erscheinen kurz nach der Veröffentlichung, nicht sofort.