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 limits en el subespacio): max_decisions (402 PLAN_LIMIT_REACHED con scope: "workspace") y monthly_decisions por ciclo de facturación (402 QUOTA_EXCEEDED con scope: "workspace").
  • GET /v1/me con el header agrega workspace_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.

En esta página