Erste Schritte / Einsteiger
Rollen und Rechte verstehen
Mitglied, Power User und Tenant-Admin im aktiven Mandanten unterscheiden.
Status dieser Funktion
Zugriff je Objekt: Gespräche und Läufe nur für ihre Eigentümer, Agenten-Interna nur für Ersteller, Einbettungen und Bots mit eigener Identität ohne Sonderrechte In Entwicklung
Die Oktober-Prüfung umfasst Regressionstests, keine vollständige Sicherheitsabnahme am laufenden Ingress oder im Browser. Vier Entscheidungen der Verantwortlichen bleiben im Prüfbericht offen. Rate-Limits gelten je Prozess; die Geheimnismaskierung im Verlauf erkennt nicht sämtliche personenbezogenen Daten.
1. Rolle prüfen
Eine Rolle bestimmt den grundsätzlichen Zugriff. Zusätzlich gelten Rechte am konkreten Agenten, Team oder Space. Ein Titel wie Firmenleitung macht eine Person nicht automatisch zum Administrator.
member: entsprichtstandard_user. Nutzt freigegebene Chats und Ressourcen. Keine allgemeine Agentenerstellung oder Veröffentlichung.power_user: kann Agenten, Teams und Aufgaben erstellen und eigene Ressourcen nach Objektberechtigung bearbeiten. Darf nicht pauschal veröffentlichen, Agenten pausieren oder Governance verwalten.tenant_admin: verwaltet den eigenen Mandanten, veröffentlicht und pausiert Agenten und verwaltet Budgets, Anbieter und Einstellungsrichtlinien.
2. Rechte passend vergeben
Lass den Tenant-Admin die benötigten Rechte zuweisen. Plane eine verantwortliche Person für Freigaben ein. Für den dokumentierten Firmen-Pilot wird ein Tenant-Admin verwendet. Zusätzliche Agenten-Admin-Grants ersetzen die erforderliche Rollenstufe nicht.
3. Fehlende Berechtigung klären
Bei einer verweigerten Aktion zuerst Mandant, Rolle und Objektzugriff prüfen. Eine Delegation in der Entscheidungsansicht verleiht keine neuen Rechte. Benutze keinen zweiten Mandanten, um eine fehlende Freigabe zu umgehen.
Ergebnis prüfen
Die zuständige Person kann genau die vorgesehene Aktion durchführen. Für Agenten gilt zusätzlich das Freigabe-Gate: Erst Evaluation und Veröffentlichung machen einen Entwurf aktiv.
Grundlage im Repository
docs/pilot/admin-handbuch.mdapps/web/src/lib/auth/permissions.ts
Getting started / Beginner
Understanding roles and permissions
Distinguish members, power users and tenant admins in the active tenant.
Feature status
Object-level access: conversations and runs only for their owner, agent internals only for builders, embeds and bots under their own low-privilege identity In development
The October review includes regression tests, not a complete live ingress or browser security acceptance. Four owner decisions remain open in the review. Rate limits are per process; timeline secret masking is not a universal personal-data detector.
1. Check your role
A role determines baseline access. Permissions on the specific agent, team or space also apply. A title such as company lead does not automatically make someone an administrator.
member: equivalent tostandard_user. Uses shared chats and resources. Does not have general permission to create or publish agents.power_user: can create agents, teams and tasks, and edit their own resources according to object permissions. Does not have blanket permission to publish or pause agents, or manage governance.tenant_admin: manages their own tenant, publishes and pauses agents, and manages budgets, providers and settings policies.
2. Assign appropriate permissions
Ask the tenant admin to assign the permissions you need. Designate a person responsible for approvals. The documented company pilot uses a tenant admin. Additional agent-admin grants do not replace the required role level.
3. Investigate missing permissions
If an action is denied, first check the tenant, role and object access. Delegation in the decisions view does not grant new permissions. Do not use a second tenant to bypass a missing approval.
Check the result
The responsible person can perform exactly the intended action. Agents also require the release gate: evaluation and publication are required before a draft becomes active.
Repository sources
docs/pilot/admin-handbuch.mdapps/web/src/lib/auth/permissions.ts