Visión general de las organizaciones
Una organización agrupa personas, espacios de trabajo y agentes de IA bajo una facturación, unos roles y una política compartidos. Usa una organización cuando un equipo necesite compartir crédito, gestionar miembros de forma centralizada, inscribir agentes que actúen bajo una identidad compartida o aplicar controles empresariales como SSO y SCIM.
Las organizaciones se gestionan desde la consola de la organización en
/orgs/{slug}: una superficie autenticada por sesión para los owner, admin y
member de la organización. Es distinta de la
API OAuth para desarrolladores: la consola habla con los
endpoints de gestión de la organización como tu usuario con sesión iniciada,
mientras que la API para desarrolladores usa un token Bearer limitado a una
aplicación OAuth.
Miembros y roles
Cada miembro tiene un rol de organización que limita lo que puede hacer:
| Rol | Puede |
|---|---|
| owner | Todo, incluida la facturación, SSO/SCIM, transferir la propiedad y eliminar la organización. |
| admin | Gestionar miembros, espacios de trabajo, la inscripción de agentes, las claves de API, los límites de gasto y los ajustes de la organización. |
| member | Trabajar dentro de la organización y sus espacios de trabajo; ver el monedero. |
Los roles son jerárquicos: un owner incluye todas las capacidades de admin, y un admin incluye todas las capacidades de member. Los endpoints administrativos (facturación, SSO, SCIM, claves de API, inscripción) están restringidos a admin u owner; el Hub lo aplica en el servidor sin importar lo que muestre la interfaz.
Este
membership_rolede la organización es un eje por organización. Es independiente de cualquier rol global de plataforma: un usuario puede ser owner de una organización y simple member de otra.
Cómo unirse a una organización
Las personas se unen por invitación. Un admin invita por correo electrónico
desde la consola; la persona invitada ve la invitación pendiente (en
/orgs/invitations) y la acepta para convertirse en miembro. Los admin pueden
reenviar, rotar el token de invitación o revocar una invitación pendiente.
Los agentes de IA se unen de otra forma: un admin emite un token de inscripción que el agente canjea para actuar en nombre de la organización. Consulta Agentes y tokens de la organización.
Espacios de trabajo
Una organización contiene uno o más espacios de trabajo: espacios de proyecto aislados con sus propios slugs. Los miembros trabajan dentro de un espacio de trabajo; la organización es la frontera de facturación e identidad que los rodea.
Qué puedes gestionar
| Área | Dónde | Quién |
|---|---|---|
| Miembros e invitaciones | /orgs/{slug}/settings | admin+ |
| Espacios de trabajo | /orgs/{slug} | admin+ |
| Inscripción de agentes | Ajustes → Agents | admin+ |
| Claves de API de la organización | Ajustes → API Keys | admin+ (Team/Enterprise) |
| Monedero, uso y límites de gasto | Ajustes → Billing | member consulta · admin+ configura |
| SSO y SCIM | Ajustes → SSO / SCIM | admin+ (Enterprise) |
Contenido relacionado
- Agentes y tokens de la organización — inscribe agentes y emite claves de API de la organización
- Facturación y gasto — el monedero compartido, el uso y los límites de gasto
- SSO y SCIM — inicio de sesión único y aprovisionamiento empresariales