Erste Schritte / Einsteiger

Rollen und Rechte verstehen

Mitglied, Power User und Tenant-Admin im aktiven Mandanten unterscheiden.

8 Min. Lesezeit · Zuletzt aktualisiert:

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: entspricht standard_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.md
  • apps/web/src/lib/auth/permissions.ts

Getting started / Beginner

Understanding roles and permissions

Distinguish members, power users and tenant admins in the active tenant.

8 min read · Last updated:

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 to standard_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.md
  • apps/web/src/lib/auth/permissions.ts