KI-Agenten mit deinen Dokumentations-Websites verbinden
Lasse Claude Code, Codex, ChatGPT oder deine eigenen Skripte Seiten für Dokumentations-Websites entwerfen, organisieren und veröffentlichen. Pläne (Pro und höher), Berechtigungen für Dokumentations-Websites, Website-Eingrenzung und Veröffentlichungsregeln, mit Links zu den vollständigen Anleitungen für KI-Agenten & API.
KI-Agenten wie Claude Code, Codex, Cursor, Claude oder ChatGPT können deine Dokumentations-Websites für dich lesen und schreiben: Artikel entwerfen, Seiten korrigieren, die von Lesern schlecht bewertet wurden, Inhaltlücken schließen, übersetzen oder veröffentlichen. Dieser Artikel behandelt die Besonderheiten für Dokumentations-Websites. Token, Connectoren, Ausgaben und Fehler werden unter KI-Agenten & API erklärt.
Bevor du beginnst
- KI-Agenten & API sind in den Plänen Pro, Business und Benutzerdefiniert enthalten, einschließlich Connectoren für Claude und ChatGPT. Kostenlose und Starter-Pläne beinhalten dies nicht; Token und Apps funktionieren nicht mehr, wenn ein Arbeitsbereich auf einen dieser Pläne umgestellt wird.
- Ein Agent agiert als die Person, die sein Token erstellt oder es verbunden hat, innerhalb der Rolle dieser Person. Er kann auf einer Website niemals mehr tun, als diese Person selbst könnte.
- API-Aufrufe kosten keine Credits. Das Übersetzen von Seiten und das Generieren von Website-Seiten mit KI kosten Credits, und zwar nur mit einem Token, das diese ausgeben darf.
Einen Agenten verbinden
Öffne das Arbeitsbereich-Menü und wähle KI-Agenten & API, oder wähle KI-Agenten & API im Einstellungen-Menü einer Dokumentations-Website (dies öffnet die Aktivität für diese Website).
- API-Token für Claude Code, Codex, Cursor oder ein Skript: Token → Neues Token, dann ein vierstufiger Assistent (Zweck, Berechtigungen, Begrenzungen, Überprüfen). Wähle eine Voreinstellung für Dokumentations-Websites wie Autor oder Veröffentlicher, wähle die Seiten unter Begrenzungen → Dokumentations-Websites aus und kopiere das Token, das nur einmal angezeigt wird. Siehe API-Token erstellen.
- Connector für Claude.ai oder ChatGPT: Füge die Connector-URL aus Verbundene Apps in die App ein, melde dich an und wähle die Seiten und den Zugriff. Siehe KI-Apps und -Agenten verbinden.
Voreinstellungen für Dokumentations-Websites
| Voreinstellung | Beschreibung auf dem Bildschirm | Für |
|---|---|---|
| Autor | "Agenten entwerfen; eine Person überprüft und veröffentlicht." | Entwerfen von Artikeln und Changelog-Einträgen, Hochladen von Bildern |
| Veröffentlicher | "Vertrauenswürdige Automatisierung, die ändern darf, was Leser sehen." | Alles für Dokumentations-Websites, einschließlich Veröffentlichen, Einstellungen und Erstellen von Websites |
| Support-Assistent | "Antworten aus veröffentlichten Dokumenten. Sonst nichts." | Ein Hilfe-Bot, der nur veröffentlichte, öffentliche Seiten durchsucht |
| Schreibgeschützt | "Recherche, Audits und Übersetzungsprüfungen." | Lesen von Inhalten |
| Analyst | "Liest Inhalte und Lesersignale, um Korrekturen vorzuschlagen." | Lesen von Inhalten und Erkenntnissen |
Produzent und Arbeitsbereich-Agent fügen Videos hinzu und verbrauchen Credits. Jede Berechtigung und wer sie erteilen kann: Agenten-Berechtigungen.
Berechtigungen für Dokumentations-Websites
| Berechtigung | Erlaubt |
|---|---|
content:read |
Lesen von Websites, Seiten, Artikeln (auch Entwürfe), Revisionen, Changelog und Website-Seiten |
articles:write |
Erstellen von Artikelentwürfen und Bearbeiten von Artikeln, die nicht live sind |
structure:write |
Erstellen und Bearbeiten von Abschnitten; Verschieben, Ausblenden und Umbenennen von Seiten |
site-pages:write |
Bearbeiten von Website-Seiten wie Startseite, Kontakt und Rechtliches |
changelog:write |
Erstellen und Bearbeiten von Changelog-Einträgen als Entwürfe |
media:write |
Hochladen von Bildern |
site:publish |
Veröffentlichen: Ändern, was Leser sehen, Bearbeiten von Live-Inhalten, Markieren von Seiten als bereit |
insights:read |
Lesen von Suchlücken, unbeantworteten Fragen und Seiten-Feedback |
site:configure |
Ändern von Website-Einstellungen, Aussehen und Navigation |
sites:create |
Erstellen neuer Dokumentations-Websites |
help:read |
Durchsuchen nur veröffentlichter, öffentlicher Seiten (für einen Support-Assistenten) |
Das Lesen ist für jedes Mitglied offen. Schreiben und Organisieren: Eigentümer, Administratoren, Editoren und Content Creators. Veröffentlichen und Website-Einstellungen: Eigentümer, Administratoren und Editoren ("Nur Eigentümer, Administratoren und Editoren können die Veröffentlichung gewähren."). Erstellen von Websites: Eigentümer und Administratoren.
Welche Websites ein Token abdeckt
Wähle unter Begrenzungen → Dokumentations-Websites die Option Alle Websites ("Jede Dokumentations-Website in diesem Arbeitsbereich, einschließlich neuer.") oder Ausgewählte Seiten. Ein Token oder eine verbundene App sieht und ändert nur die Websites, die es abdeckt. Wenn ein Artikel auch auf einer Website außerhalb seines Bereichs erscheint, wird die Änderung verweigert: "Dieser Artikel wird auch auf einer Website angezeigt, die dieses Token nicht ändern kann."
Live-Inhalte benötigen Veröffentlichungsrechte
Ohne site:publish kann ein Agent nicht ändern, was Leser sehen. Das Bearbeiten eines Artikels, der live ist, wird verweigert ("Dieser Inhalt ist auf einer veröffentlichten Website live, daher erfordert das Ändern die Fähigkeit site:publish."), und der Agent kann seinen Entwurf stattdessen zur Überprüfung einreichen. Du erhältst eine Benachrichtigung: "agent hat um Überprüfung von page auf site gebeten": "Nichts wurde veröffentlicht. Lies den Artikel und veröffentliche ihn, wenn er bereit ist."
Jede Änderung, die ein Agent vornimmt, wird im Verlauf der Seite als "Agent name (token)" angezeigt. Veröffentlichungen sind auf 10 pro Stunde pro Token begrenzt. Eine pausierte Website ist für Agenten schreibgeschützt: "Diese Website ist pausiert oder offline und schreibgeschützt."
Was Agenten auf einer Website tun können
Websites auflisten und den Seitenbaum lesen, Seiten suchen und lesen, Markdown in der Vorschau anzeigen, Artikel erstellen und aktualisieren, sie zur Überprüfung einreichen, Abschnitte und Seiten organisieren, Website-Seiten und das Changelog bearbeiten, Bilder hochladen, Erkenntnisse lesen und Lücken als abgedeckt markieren, Einstellungen, Aussehen, Navigation und Weiterleitungen ändern, Websites erstellen, Seiten übersetzen, Website-Seiten generieren, veröffentlichen und rückgängig machen. Jedes erfordert die entsprechende Berechtigung.