Skip to main content

Role-Based Access Control (RBAC)

Agenta uses role-based access control (RBAC) to manage what members can do inside an organization and its projects.

Plan availability

RBAC is available on Business and Enterprise plans. You can upgrade from your billing settings or see options at https://agenta.ai/pricing.

Roles

Agenta provides these built-in roles:

RoleWhat it is for
OwnerFull control of the organization, including member management
AdminAdminister members and organization settings
EditorCreate and edit most resources in projects
ViewerRead-only access
EvaluatorRun evaluations and review results
Deployment ManagerManage deployments

Permissions

Under the hood, Agenta authorizes requests using granular permissions. These permissions cover actions and resources across the application, such as:

  • Applications and variants
  • Workflows
  • Evaluations and test sets
  • Observability (traces/spans, annotations)
  • Secrets and API keys
  • Deployments and environments
  • Organization membership and roles
  • Billing (for owners)

Owners have full access. Other roles have a default permission set aligned with their responsibilities.

Managing Roles

Assign a Role

When inviting a member, choose a role from SettingsMembers.

Change a Role

Owners and Admins can change roles from SettingsMembers.

Best Practices

  • Give most contributors Editor access, and reserve Owner access for a small number of people.
  • Use Viewer for stakeholders who need visibility but should not change production configurations.
  • Use Evaluator for teammates focused on running evaluations.
  • Use Deployment Manager for teammates focused on guarded deployments.

FAQ

Can I set different roles per project?

Project-level roles are currently not supported. This will be available in the future.

Can I create custom roles?

Custom roles are not currently supported. This will be available in the future.

What's the difference between Owner and Admin?

  • Owner: Full control of the organization, including billing.
  • Admin: Administer members and settings, without full owner privileges.