Custom Agents mit der Admin-API verwalten

Wenn du Administrator im Enterprise Plan bist, kannst du die Custom Agents in deinem Workspace mit der Admin-API verwalten. Anstatt dich einzeln durch die Einstellungen jedes Agents zu klicken, kann dein Team Agent- und Nutzungsinformationen in deine eigenen Tools abrufen und dieselben Regeln auf viele Agents gleichzeitig anwenden. Die Admin-API steht nur Enterprise-Org-Admins zur Verfügung, die ein organisationsweites Admin-Token verwenden.

• Sieh dir jeden Custom Agent in deinem Workspace an Hole dir eine Liste aller Agents, einschließlich wer sie erstellt hat, ob sie aktiv sind, welches Modell sie verwenden, wann sie zuletzt ausgeführt wurden und worauf sie Zugriff haben.

• Verfolge, wer Zugriff auf einen Custom Agent hat. Aktualisiere die Berechtigungen eines Agents.

• Verfolge den Guthabenverbrauch. Sieh, wie viel Guthaben jeder Agent verbraucht hat, und verfolge den Guthabenverbrauch gesammelt.

• Lege Guthaben-Limits fest. Lege das Guthaben-Limit für einen einzelnen Agenten fest oder ändere es, oder lege das /standard für alle Custom Agents im Workspace fest.

• Wähle aus, wer Agents erstellen kann. Lege die Richtlinie zur Agentenerstellung für deinen Workspace fest und pausiere bei Bedarf alle Agents im gesamten Workspace.

• Einen Agenten ein- oder ausschalten. Verhindere, dass ein bestimmter Agent ausgeführt wird, ohne dessen Einrichtung zu /löschen, und schalte ihn später wieder ein.

• Einen Agenten /löschen. Entferne einen Agenten aus der Nutzung. Seine Einrichtung bleibt erhalten, sodass er bei Bedarf wiederhergestellt werden kann.

• Es muss sich um einen Workspace mit Enterprise Plan handeln.

• Die Admin-API verwendet einen Admin-Zugriff auf Organisationsebene, den deine Organisation einrichtet, nicht persönliche Integrationstokens. Für die Einrichtungsschritte, schau in der Entwicklerdokumentation →

Alles, was die Admin-API tut, hat eine entsprechende Steuerung in Notion:

• Das Agent-Verzeichnis (Einstellungen → Notion AI → Agents) zeigt die Agents in deinem Workspace an und verwaltet sie.

• Das Notion-Guthaben-Dashboard zeigt den Guthabenverbrauch der Agents an.

• Erstellungssteuerelemente legen fest, wer Agents erstellen kann.

Nutze die Einstellungen für einmalige Änderungen. Nutze die Admin-API, wenn du diese Aufgaben automatisieren, viele Agents gleichzeitig verwalten oder Nutzungsdaten in deine eigenen Berichtstools abrufen möchtest.

• Ruf den Guthabenverbrauch in interne Berichte ab, damit jedes Team sehen kann, was seine Custom Agents kosten.

• Wende dieselben Limits oder Regeln auf viele Agents gleichzeitig an.

• Übertrage den Besitz für Agents, die weiterbestehen sollen. Deaktiviere oder entferne Agents, die nicht mehr benötigt werden.