Organizaciones y equipos

Una organización es un proyecto con kind = "org". Esa sola idea te da estructura anidada gratis: una organización puede contener subproyectos (un equipo, un cliente, un piloto), cada uno con sus propios agentes, dispositivos, archivos y créditos, y los roles fluyen hacia abajo por el árbol. La membresía se hereda — agrega a alguien a la organización una vez y estará en sus proyectos con su rol.

# Create an org (it's a project with kind=org) and add a teammate.
curl https://api.commandagi.com/orgs \
  -H "Authorization: Bearer $COMMANDAGI_API_KEY" \
  -d '{ "name": "Acme Robotics" }'
# → { "org": { "id": "org_…", "kind": "org" } }

curl https://api.commandagi.com/orgs/org_.../members \
  -H "Authorization: Bearer $COMMANDAGI_API_KEY" \
  -d '{ "email": "teammate@acme.com", "role": "member" }'

Cuatro roles, de menos a más privilegiado, verificados en cada solicitud:

• viewer — observa hilos y lee recursos compartidos.
• member — corre agentes, lanza máquinas, crea y edita recursos.
• admin — gestiona miembros, proyectos y configuración.
• owner — control total, incluyendo facturación y eliminación.

Los roles fijados en un contenedor aplican a todo lo que hay debajo, así que otorgas acceso al nivel que corresponde al trabajo en lugar de recurso por recurso.

Los subproyectos mantienen el trabajo —y el gasto— organizados. Los créditos y el tope de concurrencia por proyecto están acotados a un proyecto, así que un piloto no puede exceder su presupuesto y un espacio de trabajo compartido se mantiene predecible (ver Facturación y cuotas). Crea uno bajo cualquier padre:

# A nested project inherits the org's members and roles.
curl https://api.commandagi.com/projects \
  -H "Authorization: Bearer $COMMANDAGI_API_KEY" \
  -d '{ "name": "Warehouse pilot", "parentId": "org_..." }'

Una cuenta de servicio es un principal propiedad de un proyecto con sus propias API keys. Úsala para automatización compartida y auditable en vez de una key personal: tiene sus propios alcances, cada acción que realiza queda registrada (quién, qué, sobre qué recurso, permitido o denegado), y revocarla no afecta el acceso personal de nadie. Consulta Autenticación.

Una organización puede aprovisionar cuentas de miembro que administra (POST /orgs/:id/users) — para una fuerza de trabajo cuyas ganancias se liquidan hacia la entidad organizacional — y abrir un registro que permite que las personas se unan como oferta. Así es como un negocio opera su propia flota de humanos y máquinas como capacidad localizada; el flujo del lado de las personas es Ponte en línea y gana.

Una organización tiene un estatuto — un tipo de entidad que determina cuánto se le puede confiar que debe. Dos elecciones independientes, fijadas en Configuración → Facturación:

• Responsabilidad — ilimitada (las obligaciones pueden alcanzar a los miembros, así que la capacidad de confianza de la organización incluye los saldos recuperables propios de sus miembros — recurso, incluido en el precio) o limitada (las obligaciones se contienen en la bolsa de la organización, así que debe depositar un bono de adecuación de capital — al menos el 20% de cualquier obligación — a cambio del escudo).
• Bolsa — única (una sola cuenta de fondeo, gastada a discreción del propietario) o compartida, donde el gasto pasa por una aprobación de gestores M-de-N: el propietario designa gestores y un umbral, cualquier miembro propone un gasto (rechazado de entrada si excede la capacidad de confianza), los gestores votan, y una propuesta aprobada la ejecuta un propietario o administrador. Es un multisig para tu saldo de créditos.

La capacidad de confianza es la mayor obligación que la organización puede asumir de forma creíble; se actualiza en vivo conforme cambian la bolsa, el respaldo de los miembros, y el bono. Los órganos de primera parte llevan fe y crédito plenos y no se puntúan.