Wie Fern Artikel erstellt
Fern ist dein KI-Agent für Dokumentation, der Artikel für dein Help Center recherchiert, schreibt und als Entwurf erstellt. Du gibst ihr einen Prompt, und 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 folgt diesem Ablauf:
Fern einen Prompt geben – Öffne die Fern-Seite oder drücke ⌘K auf einer beliebigen Ferndesk-Seite. Gib ein, was du brauchst (z. B. „Dokumentiere die Webhooks-Funktion“ oder „Schreibe eine Anleitung zur SSO-Einrichtung“).
Fern recherchiert – Sie durchsucht deine Codebasis, Support-Tickets, vorhandene Artikel sowie alle Dateien oder Links, die du bereitstellst. Du siehst eine Übersicht darüber, wonach sie recherchiert.
Fern plant die Arbeit – Sie erstellt eine To-do-Liste mit jedem einzelnen Schritt (Recherche, Schreiben, Hinzufügen visueller Elemente). So kannst du ihren Fortschritt nachvollziehen.
Fern erstellt den Artikelentwurf – Sie schreibt den vollständigen Artikel auf Grundlage ihrer Recherche. Der Entwurf erscheint im Aufgaben-Viewer mit dem Status „Bereit zur Überprüfung“.
Du überprüfst und veröffentlichst – Bearbeite den Entwurf direkt im Aufgaben-Viewer und veröffentliche ihn anschließend in deinem Help Center, sobald er bereit ist.
Fern veröffentlicht nicht automatisch. Du hast immer die letzte Kontrolle, bevor Artikel live gehen.
Welche Quellen Fern verwendet
Fern greift auf mehrere Quellen zurück, um genaue und vollständige Dokumentation zu erstellen:
Dein Help Center – Durchsucht vorhandene Artikel, um Duplikate zu vermeiden und relevante Links hinzuzufügen
Support-Unterhaltungen – Analysiert Tickets aus Intercom, Zendesk oder Help Scout, um häufige Fragen und Probleme zu erkennen
Deine Codebasis – Durchsucht deine verbundenen GitHub-Repositories, um UI-Abläufe, Routen, API-Endpunkte und Fehlermeldungen zu dokumentieren. Wenn du mehrere Repositories verbunden hast, kann Fern bei Bedarf ein bestimmtes Repository oder einen bestimmten Branch berücksichtigen.
Dateien und Links – Liest PDFs, Textdateien und externe Dokumentation, die du an den Prompt anhängst
Bilder – Erfasst und annotiert Screenshots und analysiert Diagramme (sie kann keine eigenen Illustrationen erstellen, sondern sie nur erfassen und beschreiben)
Videos – Bettet öffentliche Videos von YouTube, Loom, Wistia oder Vimeo ein. Du kannst Videos auch direkt hochladen.
Websuche – Recherchiert in externer Dokumentation, Changelogs oder Referenzmaterialien
Verbinde Integrationen wie GitHub und Intercom in den Einstellungen deines Workspace, damit Fern auf diese Quellen zugreifen kann.
Die besten Ergebnisse erzielen
Die Qualität der von Fern erstellten Inhalte hängt davon ab, wie viel Kontext du bereitstellst. So schaffst du die besten Voraussetzungen für sie:
Klare, detaillierte Prompts schreiben
Beschreibe genau, was du möchtest. Statt „Dokumentiere Webhooks“ könntest du schreiben: „Dokumentiere die Webhooks-Funktion. Behandle die Einrichtungsschritte, verfügbaren Ereignisse, das Payload-Format und die Fehlerbehebung bei häufigen Fehlern.“
Je mehr Details du bereitstellst, desto besser kann Fern recherchieren und den Artikel strukturieren.
Globale Anweisungen festlegen
Gehe zu Einstellungen → Über dich, um festzulegen, wie Fern schreibt und recherchiert:
Anweisungen zum Verfassen – Lege deinen bevorzugten Ton fest (z. B. „Verwende einen selbstbewussten, freundlichen Ton“ oder „Schreibe für ein technisches Publikum“).
Rechercheanweisungen – Teile Fern mit, was sie priorisieren 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 oder vorhandene Dokumentation), hänge sie direkt an deinen Prompt an. Fern bezieht sie in ihre Recherche ein.
Automatische PR-Entwürfe und Audits verwenden
Wenn Automatische PR-Entwürfe aktiviert ist, kann Fern Entwürfe aus zusammengeführten Pull Requests erstellen, die das kundenorientierte Verhalten ändern. Sensitivität und Hinweise für PR-Entwürfe unter Einstellungen > Automatisierungen steuern, wie schnell diese Entwürfe erstellt werden und welche allgemeinen Regeln gelten. Nicht jeder zusammengeführte PR wird zu einer Entwurfsaufgabe.
Fern erkennt durch Audits außerdem Dokumentationslücken. Öffne die Fern-Seite, um die Audit-Ergebnisse zu sehen, und weise anschließend direkt Aufgaben zu, damit die benötigten Artikel erstellt werden.
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 „Mache die Einleitung kürzer“).
Bei Bedarf veröffentlichen – 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 wird im Thread möglicherweise eine Trennlinie Kontext komprimiert angezeigt. Dieses automatische Verhalten sorgt dafür, dass die Aufgabe weiter ausgeführt wird. Du kannst die Trennlinie aufklappen, um die Zusammenfassung zu prüfen; der Entwurf wird anschließend normal fortgesetzt.
Nach der Veröffentlichung
Fern veröffentlicht nur Inhalte in der Primärsprache. Wenn du automatisch verwaltete Übersetzungssprachen aktiviert hast, stellt die Übersetzungssuite automatisch Übersetzungen für neu veröffentlichte Artikel in die Warteschlange. Sie erscheinen kurz nach der Veröffentlichung und nicht sofort. Um vorhandene Übersetzungen zu aktualisieren, verwende die Sprachauswahl im Artikel-Editor oder gehe zu Help Center > Übersetzen, um alle Inhalte für diese Sprache erneut zu übersetzen.
Codebeispiele in Entwürfen
Fern-Entwürfe können Codeblöcke mit Syntaxhervorhebung und mehrsprachige Codeblöcke enthalten, die dasselbe Snippet in mehreren Sprachen anzeigen – nützlich für REST- und SDK-Beispiele nebeneinander. Während der Erstellung kann Fern außerdem deine veröffentlichten API-Referenzen durchsuchen, sodass Endpunktnamen, Methoden, Parameter und Antworten in neuen Anleitungen deiner Spezifikation entsprechen.