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 kümmert sich um den Rest.
Dieser Leitfaden erklärt, wie der Prozess funktioniert, welche Quellen Fern verwendet und wie du die besten Ergebnisse erzielst.
So funktioniert es
Das Erstellen eines Artikels mit Fern läuft in diesem Ablauf ab:
Gib Fern eine Aufforderung - Gehe zur Fern-Seite oder drücke überall in Ferndesk ⌘N. Gib ein, was du brauchst (z. B. „Dokumentiere die Webhooks-Funktion“ oder „Schreibe eine Anleitung für die SSO-Einrichtung“).
Fern recherchiert - Sie durchsucht deine Codebasis, Support-Tickets, vorhandenen 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 mit jedem Schritt (Recherche, Schreiben, Hinzufügen von visuellen Elementen). So erhältst du Einblick in ihren Fortschritt.
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 Prüfung“.
Du prüfst und veröffentlichst - Bearbeite den Entwurf direkt im Aufgaben-Viewer und veröffentliche ihn dann in deinem Help Center, wenn du bereit bist.
Fern veröffentlicht nicht automatisch. Du behältst immer die endgültige Kontrolle, bevor Artikel live gehen.
Welche Quellen Fern verwendet
Fern greift auf mehrere Quellen zurück, um genaue 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 aus Intercom, Zendesk oder Help Scout, um häufige Fragen und Problempunkte zu identifizieren
Deine Codebasis - 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 einen bestimmten Branch konzentrieren.
Dateien und Links - Liest PDFs, Textdateien und externe Dokumentationen, die du an die Aufforderung anhängst
Bilder - Analysiert Screenshots und Diagramme (sie kann keine Bilder erzeugen, nur sie beschreiben und einordnen)
Videos - Bindet öffentliche Videos von YouTube, Loom, Wistia oder Vimeo ein. Du kannst Videos auch direkt hochladen.
Web-Browsing - Recherchiert externe Dokumentationen, Änderungsprotokolle 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 setzt du sie auf Erfolgskurs:
Klare, detaillierte Aufforderungen schreiben
Sei konkret darüber, was du möchtest. Statt „Dokumentiere Webhooks“ versuche es mit „Dokumentiere die Webhooks-Funktion. Gehe auf Einrichtungsschritte, verfügbare Events, das Payload-Format und die Fehlerbehebung bei häufigen Fehlern ein.“
Je mehr Details du bereitstellst, desto besser kann Fern recherchieren und den Artikel strukturieren.
Globale Anweisungen festlegen
Gehe zu Einstellungen → Fern, um zu konfigurieren, wie Fern schreibt und recherchiert:
Entwurfsanweisungen - Lege deinen bevorzugten Ton fest (z. B. „Verwende einen selbstbewussten, freundlichen Ton“ oder „Schreibe für technische Zielgruppen“)
Rechercheanweisungen - Sage Fern, worauf sie den Fokus legen soll (z. B. „Durchsuche immer die Codebasis 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 bindet sie in ihre Recherche ein.
Automatische PR-Entwürfe und Audits verwenden
Wenn Automatic PR drafts aktiviert ist, kann Fern aus zusammengeführten Pull Requests entwerfen, die kundenrelevantes Verhalten ändern. Sensitivity and Guidance for PR drafts unter Settings > Automations steuern, wie leicht diese Entwürfe erstellt werden und welche festen Regeln gelten. Nicht jeder zusammengeführte PR wird zu einer Entwurfsaufgabe.
Fern erkennt außerdem Dokumentationslücken 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.
Mit Entwürfen arbeiten
Wenn Fern fertig ist, erscheint der Entwurf im Aufgaben-Viewer. Du kannst:
Direkt bearbeiten - Verwende den integrierten Editor, um Inhalte zu verfeinern, die Formatierung anzupassen oder Abschnitte hinzuzufügen
Änderungen anfordern - Schreibe Fern im Aufgaben-Thread, um Überarbeitungen anzufordern (z. B. „Füge einen Abschnitt zur Fehlerbehebung hinzu“ oder „Mach die Einleitung kürzer“)
Veröffentlichen, wenn du bereit bist - Speichere den Artikel und veröffentliche ihn in deiner Help-Center-Sammlung
Entwürfe bleiben im Aufgaben-Viewer, bis du sie veröffentlichst. Ohne deine Zustimmung geht nichts live.
Bei sehr langen Aufgaben kann im Thread ein Trennbereich Context compacted erscheinen. Das ist ein automatisches Verhalten, das die Aufgabe am Laufen hält. Du kannst den Trennbereich aufklappen, um die Zusammenfassung zu prüfen, und der Entwurf läuft normal weiter.
Nach der Veröffentlichung
Fern veröffentlicht nur Inhalte in der Primärsprache. Wenn die automatische Verwaltung von Übersetzungssprachen aktiviert ist, stellt die Übersetzungs-Suite für neu veröffentlichte Artikel automatisch Übersetzungen in die Warteschlange. Sie erscheinen kurz nach der Veröffentlichung und nicht sofort. Um vorhandene Übersetzungen zu aktualisieren, verwende den Sprachselektor im Artikel-Editor oder gehe zu Help Center > Translate, um alle Inhalte für diese Sprache neu zu übersetzen.