Wie Fern Artikel erstellt
Fern ist Ihr KI-Dokumentationsagent, der Artikel für Ihr Help Center recherchiert, schreibt und entwirft. Sie geben ihr einen Prompt, sie erledigt den Rest.
Dieser Leitfaden beschreibt, wie der Prozess funktioniert, welche Quellen Fern nutzt und wie Sie die besten Ergebnisse erzielen.
Funktionsweise
Das Erstellen 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 das Webhooks-Feature“ oder „Schreibe eine Anleitung für die SSO-Einrichtung“).
Fern recherchiert – Sie scannt Ihre Codebasis, Support-Tickets, bestehende Artikel sowie alle Dateien oder Links, die Sie bereitstellen. 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 – Basierend auf ihrer Recherche schreibt sie den vollständigen Artikel. Der Entwurf erscheint im Task-Viewer mit dem Status „Bereit zur Überprüfung“.
Überprüfung und Veröffentlichung – Bearbeiten Sie den Entwurf direkt im Task-Viewer und veröffentlichen Sie ihn in Ihrem Help Center, sobald er fertig ist.
Fern veröffentlicht nicht automatisch. Sie behalten immer die endgültige Kontrolle, bevor Artikel live gehen.
Welche Quellen Fern nutzt
Fern greift auf mehrere Quellen zu, um genaue und vollständige Dokumentationen zu erstellen:
Ihr Help Center – Durchsucht vorhandene Artikel, um Dubletten zu vermeiden und relevante Links hinzuzufügen
Support-Gespräche – Analysiert Tickets von Intercom, Zendesk oder Help Scout, um häufige Fragen und Probleme zu identifizieren
Ihre Codebasis – Durchsucht GitHub-Repositories, 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
Verbinden 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. Statt „Dokumentiere Webhooks“ versuchen Sie es mit „Dokumentiere das Webhooks-Feature. Decke Einrichtungsschritte, verfügbare Events, das Payload-Format und die Fehlerbehebung bei häufigen Fehlern ab.“
Je detaillierter Ihre Angaben sind, desto besser kann Fern den Artikel recherchiert und strukturieren.
Globale Anweisungen festlegen
Gehen Sie zu Einstellungen → Fern, um zu konfigurieren, wie Fern schreibt und recherchiert:
Anweisungen für Entwürfe – Legen Sie Ihren bevorzugten Ton fest (z. B. „Verwende einen selbstbewussten, freundlichen Ton“ oder „Schreibe für ein technisches Publikum“)
Recherche-Anweisungen – 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 beifügen
Wenn Sie Referenzmaterialien haben (Spezifikationsdokumente, Screenshots, Videos, bestehende Dokumentation), fügen Sie diese direkt Ihrem Prompt bei. 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 stecken bleibt 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 – Schreiben Sie Fern im Task-Thread, um Überarbeitungen anzufordern (z. B. „Füge einen Abschnitt zur Fehlerbehebung hinzu“ oder „Mache 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.