Papéis e permissões
Os papéis de organização e de workspace, e o que cada um alcança na plataforma.
Cada pessoa tem um papel na Organização e um papel em cada Workspace de que participa. Os dois são independentes e se somam.
É essa combinação que decide o que aparece na barra lateral e o que a plataforma aceita quando você clica em salvar.
Papéis de organização
- Superadmin: acesso total. É o único papel que abre Provedores, Credenciais e Configurações › Geral.
- Admin: administra a organização: workspaces, membros, quotas, SuperAgentes, MCPs e Integrações. Não alcança Provedores, Credenciais nem Configurações › Geral, e não cadastra MCPs novos no registro.
- Auditor: só leitura, e apenas em Workspaces, Membros, Quotas, Observabilidade e SuperAgentes.
- Usuário: sem acesso às telas de Organização. É o papel de quem só usa o Chat.
A distância entre Superadmin e Admin é deliberada: o que guarda segredo, conta de provedor e credencial, fica com um papel só.
Papéis de workspace
- Proprietário: acesso total ao workspace, incluindo Integrações, Chaves de API e excluir o workspace.
- Curador: constrói e acompanha. Cria Coleções, Agentes, SuperAgentes, Workflows, MCPs e Variáveis, e lê Painel, Conversas, Avaliação das Respostas, Observabilidade e Quotas.
- Editor: só constrói. Mesmo poder de criação do Curador, sem nenhuma das telas de acompanhamento e configuração.
- Auditor: só leitura, na maior parte do workspace.
- Usuário: sem acesso às telas de administração. Conversa no Chat.
| Área do workspace | Proprietário | Curador | Editor | Auditor |
|---|---|---|---|---|
| Coleções, Agentes, SuperAgentes, Workflows, MCPs, Variáveis | Edita | Edita | Edita | Lê |
| Painel, Observabilidade, Quotas | Lê | Lê | Sem acesso | Lê |
| Conversas, Avaliação das Respostas | Lê | Lê | Sem acesso | Lê |
| Modelos, Membros, Geral | Edita | Sem acesso | Sem acesso | Lê |
| Integrações, Chaves de API | Edita | Sem acesso | Sem acesso | Sem acesso |
Como os dois se combinam
A plataforma resolve o acesso a um workspace nesta ordem:
- Se você é membro do workspace, vale o seu papel de workspace.
- Se não é, mas é Superadmin, Admin ou Auditor da organização, vale o papel de organização.
- Se nenhum dos dois se aplica, o workspace não abre.
Por isso um Admin da organização entra em um workspace onde nunca foi adicionado, enquanto um Editor de outro workspace não entra.
A barra lateral esconde o que o seu papel não permite, mas a decisão real é do backend: cada serviço reconfere a permissão a cada chamada. Digitar a URL de uma página escondida não dá acesso a ela.
Quando o acesso não é o esperado
- Você vê o workspace mas não edita nada: você chegou pelo papel de organização, não como membro. Peça para ser adicionado ao workspace.
- Você é Admin e não abre Provedores ou Credenciais: isso é por desenho, e não se resolve por workspace. Esses dois exigem Superadmin.
- Você é Curador e não vê Modelos nem Membros: também por desenho. Essas duas ficam com o Proprietário.
- A área de Workspace está desabilitada: você não participa de nenhum workspace naquela organização.
Próximos passos
- Entenda o que pertence a cada nível em Organizações e Workspaces.
- Seu papel na organização aparece no menu de usuário, em Configurações, junto do nome dela.