Berechtigungen für einen KI-Agenten wählen
Jede Berechtigung, die ein API-Token oder eine verbundene App haben kann, was sie erlaubt, welche Voreinstellung sie enthält und welche Rollen (Inhaber, Admin, Editor, Content Creator) sie vergeben können.
Jedes API-Token und jede verbundene App verfügt über eine Reihe von Berechtigungen (Fähigkeiten), die bestimmen, was ein Agent in deinem Arbeitsbereich tun darf. Dieser Artikel listet jede Berechtigung auf, was sie erlaubt, welche Voreinstellung sie enthält und welche Rollen sie vergeben können.
Wie Berechtigungen funktionieren
- Ein Agent handelt als die Person, die das Token erstellt hat, im Rahmen dessen, was die Rolle dieser Person erlaubt. Er kann niemals mehr tun, als sein Inhaber in der App tun könnte, und er sieht nur die Aufnahmen, Videos und Sammlungen, die sein Inhaber sehen kann.
- Deine Rolle entscheidet, was du vergeben kannst. Im Token-Assistenten und auf dem Verbindungsbildschirm ist eine Berechtigung, die deine Rolle nicht vergeben kann, ausgegraut mit "Deine Rolle kann dies nicht vergeben." (oder "Nur Inhaber, Admins und Editoren können das Veröffentlichen vergeben." für das Veröffentlichen). Eine Voreinstellung, die eine dieser Berechtigungen enthält, ist ausgegraut mit "Deine Rolle kann nicht jede Fähigkeit in dieser Voreinstellung vergeben."
- Die Rolle wird bei jedem Aufruf geprüft, nicht nur bei der Erstellung des Tokens. Wenn sich die Rolle des Inhabers später ändert, werden Aufrufe, die eine Berechtigung erfordern, die die neue Rolle nicht zulässt, abgelehnt, und das Token zeigt Übersteigt Rolle in der Token-Liste an: "Die Rolle des Inhabers hat sich geändert. Aufrufe, die die durchgestrichenen Fähigkeiten benötigen, werden abgelehnt."
- Jede Berechtigung hat eine Art, die als Badge im Assistenten angezeigt wird: Gelesen, Bearbeiten, Veröffentlichen, Verwalten oder Gibt Credits aus.
- Ein Agent sieht nur die Tools (MCP) und Endpunkte (REST), die seine Berechtigungen erlauben. Der Aufruf eines Tools, das ihm fehlt, gibt "Diesem Token fehlt die … Fähigkeit." zurück.
Voreinstellungen
Der erste Schritt des Token-Assistenten (Wofür ist das?) bietet Voreinstellungen an. Die Auswahl einer Voreinstellung aktiviert deren Berechtigungen; du kannst jede davon im nächsten Schritt ändern, woraufhin der Assistent Angepasst mit Zurücksetzen auf Voreinstellung anzeigt.
| Voreinstellung | Beschreibung auf dem Bildschirm | Berechtigungen |
|---|---|---|
| Autor | "Agenten entwerfen; eine Person prüft und veröffentlicht." | content:read, articles:write, changelog:write, media:write |
| Veröffentlicher | "Vertrauenswürdige Automatisierung, die ändern darf, was Leser sehen." | Jede Berechtigung für Dokumentations-Websites außer help:read und insights:read |
| Support-Assistent | "Antworten aus veröffentlichten Dokumenten. Nichts anderes." | help:read |
| Schreibgeschützt | "Recherche, Audits und Übersetzungsprüfungen." | content:read |
| Analyst | "Liest Inhalte und Lesersignale, um Korrekturen vorzuschlagen." | content:read, insights:read |
| Produzent | "Entwirft Inhalte und startet bezahlte Arbeit innerhalb von Ausgabenlimits." | Autor, plus site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| Arbeitsbereich-Agent | "Alles, was ein Agent in diesem Arbeitsbereich tun kann, innerhalb von Ausgabenlimits." | Jede Berechtigung außer help:read |
Produzent und Arbeitsbereich-Agent beinhalten credits:spend, daher fragt der Assistent im Schritt Begrenzungen nach Ausgabenlimits. Siehe Agentenausgaben und Genehmigungen steuern.
Die Voreinstellungen Autor, Veröffentlicher, Support-Assistent, Schreibgeschützt und Analyst sind für Dokumentations-Websites gedacht.
Berechtigungen für Videos
| Berechtigung | Art | Was sie erlaubt |
|---|---|---|
library:read |
Gelesen | "Aufnahmen, Videos, Artikel und Transkripte lesen, die der Inhaber sehen kann": die Bibliothek und Aufnahmen auflisten, ein Element, dessen Transkript und dessen Artikel lesen und ein Einbettungselement abrufen. |
videos:create |
Bearbeiten | "Videos und Artikel aus Aufnahmen zitieren und anfordern sowie Übersetzungen": ein Angebot anfordern und Anleitungen, Produktdemos, Bereinigungen und gestaltete Videos aus einer Aufnahme, soziale Clips, Artikel aus einer Aufnahme und Videoübersetzungen anfordern. Das Starten bezahlter Arbeit erfordert auch credits:spend. |
videos:export |
Bearbeiten | "Videos exportieren und Einbettungen abrufen": ein MP4 in 1080p (Standard), 2K oder 4K rendern, immer mit 60 fps, und einen Download-Link erhalten. Exporte kosten keine Credits. |
materials:write |
Bearbeiten | "Bilder, Videos und PDFs zu den Uploads des Arbeitsbereichs hinzufügen, die für neue Videos verwendet werden". |
Berechtigungen für den Arbeitsbereich
| Berechtigung | Art | Was sie erlaubt |
|---|---|---|
credits:spend |
Gibt Credits aus | "Credits für angeforderte Arbeit ausgeben, innerhalb der Limits des Tokens". Dies ist der zweite Schlüssel, den jeder bezahlte Start benötigt, neben der Berechtigung für diese Arbeit (zum Beispiel videos:create). |
jobs:read |
Gelesen | "Jobs sehen, die von anderen Token des Inhabers gestartet wurden". Ein Token sieht immer seine eigenen Jobs; dies fügt die Jobs der anderen Token seines Inhabers hinzu. Ermöglicht es dem Agenten außerdem, einen Job abzubrechen und das Credit-Guthaben des Arbeitsbereichs zu lesen. |
Berechtigungen für Dokumente
Diese gelten für Dokumentations-Websites. Unter Begrenzungen → Dokumentations-Websites deckt ein Token Alle Websites ("Jede Dokumentations-Website in diesem Arbeitsbereich, einschließlich neuer.") oder Ausgewählte Seiten ab.
| Berechtigung | Art | Was sie erlaubt |
|---|---|---|
content:read |
Gelesen | "Websites, Seiten, Artikel (auch Entwürfe), Revisionen, Änderungsprotokoll und Website-Seiten lesen". Auch Website-Einstellungen, Erscheinungsbild, Navigation und Weiterleitungen. |
articles:write |
Bearbeiten | "Artikelentwürfe erstellen und Artikel bearbeiten, die nicht live sind". Das Übersetzen eines Artikels (bezahlt) erfordert auch credits:spend. |
structure:write |
Bearbeiten | "Abschnitte erstellen und bearbeiten, Seiten verschieben, ausblenden und umbenennen". |
site-pages:write |
Bearbeiten | "Website-Seiten wie Startseite, Kontakt und Rechtliches bearbeiten". Das Generieren oder Übersetzen einer Website-Seite mit KI (bezahlt) erfordert auch credits:spend. |
changelog:write |
Bearbeiten | "Einträge im Änderungsprotokoll als Entwürfe erstellen und bearbeiten". |
media:write |
Bearbeiten | "Bilder hochladen". |
site:publish |
Veröffentlichen | "Veröffentlichen: ändern, was Leser sehen, Live-Inhalte bearbeiten, Seiten als fertig markieren". Auch das Veröffentlichen und Löschen von Änderungsprotokoll-Einträgen und das Zurücksetzen einer Website. |
insights:read |
Gelesen | "Website-Einblicke lesen: Suchlücken, unbeantwortete Fragen und Seiten-Feedback". Mit articles:write kann er auch eine Lücke als abgedeckt markieren. |
site:configure |
Verwalten | "Website-Einstellungen, Erscheinungsbild und Navigation ändern" sowie Weiterleitungen hinzufügen. |
sites:create |
Verwalten | "Neue Dokumentations-Websites erstellen". |
help:read |
Gelesen | "Nur veröffentlichte, öffentliche Seiten durchsuchen (Support-Assistent)". Ein Token, das nur diese Berechtigung hat, sieht nichts anderes. |
Wer kann was vergeben
| Berechtigung | Inhaber | Admin | Editor | Content Creator |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
Ja | Ja | Ja | Ja |
library:read |
Ja | Ja | Ja | Ja |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
Ja | Ja | Ja | Ja |
videos:export |
Ja | Ja | Ja | Ja |
videos:create, materials:write, credits:spend |
Ja | Ja | Nein | Ja |
site:publish, site:configure |
Ja | Ja | Ja | Nein |
sites:create |
Ja | Ja | Nein | Nein |
Ein Content Creator kann einem Token credits:spend geben, aber bezahlte Arbeit, die eine Genehmigung erfordert, wird immer vom Inhaber des Arbeitsbereichs oder einem Admin genehmigt, niemals allein vom Inhaber des Tokens. Siehe Agentenausgaben und Genehmigungen steuern.
Für Agenten noch nicht verfügbar
Agenten können noch keine Website-Recherche oder aufgezeichnete Rundgänge durchführen oder Videos auf anderen Plattformen veröffentlichen. Diese Berechtigungen können nicht vergeben werden.