Subespacios
Un subespacio por cliente de tu app, con tu propio id — créalo, copia tus decisiones en él, ejecútalas con Dcision-Workspace, limita y vigila su uso.
Un subespacio contiene las decisiones de un cliente. Te diriges a él con tu id del cliente (external_id, por ejemplo el id de tu workspace o de tu cuenta), así que nunca guardas ids de Dcision.
Crea uno
POST /v1/workspaces crea el subespacio para un external_id, o lo actualiza cuando ya existe: llámalo cada vez que un cliente active la función.
curl https://api.dcision.io/v1/workspaces \
-H "Authorization: Bearer $DCISION_API_KEY" -H "Content-Type: application/json" \
-d '{
"external_id": "acme",
"name": "Acme Inc",
"seed": { "decisions": ["lead-qualification"], "deploy": true }
}'seed copia la versión desplegada de tus propias decisiones en el nuevo subespacio, con los mismos slugs, así que cada cliente parte de tu decisión funcional y luego puede cambiarla. Solo se ejecuta cuando se crea el subespacio; la respuesta lista lo que se copió y lo que se omitió.
Ejecuta la decisión de un cliente
Envía tu clave de API con el header Dcision-Workspace: ext:<external_id> (o el id del subespacio):
curl https://api.dcision.io/v1/decisions/lead-qualification \
-H "Authorization: Bearer $DCISION_API_KEY" \
-H "Dcision-Workspace: ext:acme" \
-H "Content-Type: application/json" \
-d '{ "state": { "message": "Can you send pricing for 500 seats?" } }'El mismo header funciona en GET /v1/decisions, GET /v1/me, GET /v1/executions y el servidor MCP. Un subespacio que no es tuyo responde 404 WORKSPACE_NOT_FOUND. Los SDKs lo aceptan como opción:
const acme = dcision.withWorkspace("ext:acme");
await acme.decide("lead-qualification", { message: "Pricing?" });La idempotencia es por subespacio: la misma Idempotency-Key enviada para dos clientes es un conflicto (409), nunca la respuesta guardada de otro cliente.
Facturación y límites
- Cada ejecución facturable de un subespacio cuenta en el uso, el plan y el saldo de tu workspace; los límites de solicitudes también son los de tu workspace.
- Límites por cliente (desde Configuración → Socio, o
limitsen el subespacio):max_decisions(402 PLAN_LIMIT_REACHEDconscope: "workspace") ymonthly_decisionspor ciclo de facturación (402 QUOTA_EXCEEDEDconscope: "workspace"). GET /v1/mecon el header agregaworkspace_usage: las ejecuciones del cliente en el ciclo y su límite.- Los subespacios se ejecutan con tu configuración de motor y tus claves del motor. Sus destinos LLM y JSON usan tus claves de LLM solo si lo permites; los secretos del workspace nunca se comparten.
Mueve una de tus decisiones a él
Una decisión que construiste en tu propio workspace puede pasar al subespacio de un cliente con su historial (versiones, ejecuciones, entregas, chat con el agente): POST /v1/decisions/{slug}/move con { "to": "ext:acme" }, o ⋯ → Mover a un subespacio en la app (propietarios y administradores). Si el subespacio tiene una copia sin modificar con el mismo slug (de seed), replace_empty: true la reemplaza. Después, llama a la decisión con Dcision-Workspace.
Ve las decisiones de un cliente en la app
Configuración → Socio → Abrir muestra las decisiones de un subespacio dentro de la app de Dcision: las mismas pantallas que tus clientes ven en la tuya. Los miembros de tu workspace las editan; los lectores solo pueden verlas.
Eliminar
DELETE /v1/workspaces/ext:acme elimina el subespacio con todas sus decisiones y ejecuciones. El uso ya facturado se queda en tu workspace.
Socios
Ofrece Dcision dentro de tu propia app — un subespacio por cliente, un editor incrustable para tus usuarios finales y el uso facturado a tu workspace.
Integra el editor
Permite que tus clientes creen, editen, prueben y publiquen sus decisiones dentro de tu app con sesiones de embed desde tu backend, el script @dcision/embed, permisos y eventos.