Wie Fern Artikel erstellt
Fern ist dein KI-Dokumentationsagent, der Artikel für dein Help Center recherchiert, schreibt und entwirft. Du gibst ihr eine Aufforderung, sie erledigt den Rest.
Dieser Leitfaden erklärt, wie der Prozess funktioniert, welche Quellen Fern nutzt und wie du die besten Ergebnisse erzielst.
So funktioniert es
Das Erstellen eines Artikels mit Fern folgt diesem Ablauf:
Fern eine Aufforderung geben - Gehe zur Fern-Seite oder drücke überall in Ferndesk ⌘N. Tippe ein, was du brauchst (z. B. „Die Webhooks-Funktion dokumentieren“ oder „Einen Leitfaden für die SSO-Einrichtung schreiben“).
Fern recherchiert - Sie durchsucht deinen Codebase, Support-Tickets, vorhandene Artikel und alle Dateien oder Links, die du bereitstellst. Du siehst eine Aufschlüsselung dessen, was sie recherchiert.
Fern plant die Arbeit - Sie erstellt eine To-do-Liste, die jeden Schritt zeigt (Recherche, Schreiben, Hinzufügen von Visuals). So behältst du ihren Fortschritt im Blick.
Fern entwirft den Artikel - Sie schreibt den vollständigen Artikel auf Grundlage ihrer Recherche. Der Entwurf erscheint im Aufgaben-Viewer mit dem Status „Bereit zur Überprüfung“.
Du prüfst und veröffentlichst - Bearbeite den Entwurf direkt im Aufgaben-Viewer und veröffentliche ihn dann, wenn er bereit ist, in deinem Help Center.
Fern veröffentlicht nicht automatisch. Du behältst vor dem Livegang von Artikeln immer die volle Kontrolle.
Welche Quellen Fern verwendet
Fern zieht Daten aus mehreren Quellen heran, um präzise und vollständige Dokumentationen zu erstellen:
Dein Help Center - Durchsucht vorhandene Artikel, um Duplikate zu vermeiden und relevante Links hinzuzufügen
Support-Konversationen - Analysiert Tickets von Intercom, Zendesk oder Help Scout, um häufige Fragen und Pain Points zu identifizieren
Dein Codebase - Durchsucht deine verbundenen GitHub-Repositories, um UI-Abläufe, Routen, API-Endpunkte und Fehlermeldungen zu dokumentieren. Wenn mehrere Repos verbunden sind, kann sich Fern bei Bedarf auf ein bestimmtes Repository oder Branch konzentrieren.
Dateien und Links - Liest PDFs, Textdateien und externe Dokumentation, die du der Aufforderung anhängst
Bilder - Analysiert Screenshots und Diagramme (sie kann keine Bilder generieren, nur beschreiben und in den Kontext einordnen)
Videos - Bindet öffentliche Videos von YouTube, Loom, Wistia oder Vimeo ein. Du kannst Videos auch direkt hochladen.
Web-Browsing - Recherchiert externe Dokumentation, Changelogs oder Referenzmaterialien
Verbinde Integrationen wie GitHub und Intercom in deinen Workspace-Einstellungen, damit Fern Zugriff auf diese Quellen erhält.
Die besten Ergebnisse erzielen
Die Qualität von Ferns Ausgabe hängt davon ab, wie viel Kontext du bereitstellst. So bereitest du sie auf Erfolg vor:
Klare, detaillierte Aufforderungen schreiben
Sei konkret in Bezug darauf, was du möchtest. Statt „Webhooks dokumentieren“ versuche „Die Webhooks-Funktion dokumentieren. Decke die Einrichtungsschritte, verfügbaren Events, das Payload-Format und die Fehlerbehebung bei häufigen Fehlern ab.“
Je mehr Details du lieferst, desto besser kann Fern recherchieren und den Artikel strukturieren.
Globale Anweisungen festlegen
Gehe zu Einstellungen → Fern, um zu konfigurieren, wie Fern schreibt und recherchiert:
Anweisungen zum Entwerfen - Lege den gewünschten Ton fest (z. B. „Verwende einen selbstbewussten, freundlichen Ton“ oder „Schreibe für ein technisches Publikum“)
Rechercheanweisungen - Sage Fern, worauf sie sich konzentrieren soll (z. B. „Durchsuche den Codebase immer nach UI-Abläufen“ oder „Prüfe Support-Tickets auf häufige Probleme“)
Diese Einstellungen gelten für jede Aufgabe, die Fern erstellt, sodass du dich nicht wiederholen musst.
Dateien und Links anhängen
Wenn du Referenzmaterialien hast (Spezifikationsdokumente, Screenshots, Videos, vorhandene Dokumentation), hänge sie direkt an deine Aufforderung an. Fern bezieht sie in ihre Recherche ein.
Audits verwenden
Fern identifiziert Dokumentationslücken automatisch durch Audits. Besuche die Fern-Seite, um die Audit-Ergebnisse zu sehen, und weise dann direkt Aufgaben zu, um die benötigten Artikel zu entwerfen.
Wenn eine Aufgabe hängen bleibt oder unerwartete Ergebnisse liefert, schreibe Fern im Aufgabenthread eine Nachricht mit Feedback wie „Weiter so“ oder „Dieser Abschnitt braucht mehr Details zur Fehlerbehandlung.“ Sie kann sich selbst korrigieren und fortfahren.
Arbeiten mit Entwürfen
Wenn Fern fertig ist, erscheint der Entwurf im Aufgaben-Viewer. Du kannst:
Direkt bearbeiten - Nutze den integrierten Editor, um Inhalte zu verfeinern, die Formatierung anzupassen oder Abschnitte hinzuzufügen
Änderungen anfordern - Schreibe Fern im Aufgabenthread, um Überarbeitungen anzufordern (z. B. „Füge einen Abschnitt zur Fehlerbehebung hinzu“ oder „Mach die Einleitung kürzer“)
Veröffentlichen, wenn bereit - Speichere und veröffentliche den Artikel in deiner Help-Center-Sammlung
Entwürfe bleiben im Aufgaben-Viewer, bis du sie veröffentlichst. Nichts geht ohne deine Freigabe live.
Bei sehr langen Aufgaben wird im Thread möglicherweise ein Trenner Context compacted angezeigt. Das ist ein automatisches Verhalten, das die Aufgabe am Laufen hält. Du kannst den Trenner erweitern, um die Zusammenfassung zu prüfen, und der Entwurf läuft ganz normal weiter. Weitere Informationen findest du unter Context compaction in task threads.
Nach der Veröffentlichung
Wenn du die automatische Verwaltung von Übersetzungssprachen aktiviert hast, werden Übersetzungen für neu veröffentlichte Artikel automatisch in die Warteschlange gestellt. Sie erscheinen kurz nach der Veröffentlichung statt sofort.