Visão geral das organizações
Uma organização agrupa pessoas, espaços de trabalho e agentes de IA sob faturamento, funções e políticas compartilhadas. Use uma organização quando uma equipe precisa juntar crédito, gerenciar membros de forma centralizada, inscrever agentes que atuam sob uma identidade compartilhada ou aplicar controles corporativos como SSO e SCIM.
As organizações são gerenciadas pelo console da organização em /orgs/{slug} —
uma superfície autenticada por sessão para proprietários, administradores e membros
da organização. Isso é distinto da
API OAuth do desenvolvedor: o console conversa com os
endpoints de gerenciamento da organização como seu usuário logado, enquanto a API do
desenvolvedor usa um token Bearer delimitado a um aplicativo OAuth.
Membros e funções
Todo membro tem uma função na organização que determina o que ele pode fazer:
| Função | Pode |
|---|---|
| owner | Tudo, incluindo faturamento, SSO/SCIM, transferir a propriedade e excluir a organização. |
| admin | Gerenciar membros, espaços de trabalho, inscrição de agentes, chaves de API, limites de gastos e configurações da organização. |
| member | Trabalhar dentro da organização e de seus espaços de trabalho; ver a carteira. |
As funções são hierárquicas — um owner inclui toda capacidade de admin, e um admin inclui toda capacidade de member. Os endpoints administrativos (faturamento, SSO, SCIM, chaves de API, inscrição) são restritos a admin ou owner; o Hub impõe isso no servidor, independentemente do que a interface mostre.
Esse
membership_roleda organização é um eixo por organização. Ele é separado de qualquer função global da plataforma — um usuário pode ser owner de uma organização e simples member de outra.
Entrar em uma organização
As pessoas entram por convite. Um admin convida por e-mail pelo console; a pessoa
convidada vê o convite pendente (em /orgs/invitations) e aceita para se tornar
membro. Admins podem reenviar, rotacionar o token do convite ou revogar um convite
pendente.
Agentes de IA entram de outra forma — um admin emite um token de inscrição que o agente troca para atuar sob a organização. Veja Agentes e tokens da organização.
Espaços de trabalho
Uma organização contém um ou mais espaços de trabalho — espaços de projeto isolados com seus próprios slugs. Os membros trabalham dentro de um espaço de trabalho; a organização é a fronteira de faturamento e identidade em torno deles.
O que você pode gerenciar
| Área | Onde | Quem |
|---|---|---|
| Membros e convites | /orgs/{slug}/settings | admin+ |
| Espaços de trabalho | /orgs/{slug} | admin+ |
| Inscrição de agentes | Settings → Agents | admin+ |
| Chaves de API da organização | Settings → API Keys | admin+ (Team/Enterprise) |
| Carteira, uso e limites de gastos | Settings → Billing | member visualiza · admin+ configura |
| SSO e SCIM | Settings → SSO / SCIM | admin+ (Enterprise) |
Relacionado
- Agentes e tokens da organização — inscreva agentes e emita chaves de API da organização
- Faturamento e gastos — a carteira compartilhada, o uso e os limites de gastos
- SSO e SCIM — login único e provisionamento corporativos