子工作区
为你应用的每位客户创建一个子工作区,用你自己的 id 寻址——创建它、把你的决策复制进去、用 Dcision-Workspace 运行它们,并限制和监控其用量。
一个子工作区存放一位客户的决策。你用你自己为该客户分配的 id(external_id,例如你的工作区或账户 id)来寻址它,因此你永远不需要存储 Dcision 的 id。
创建子工作区
POST /v1/workspaces 为某个 external_id 创建子工作区,若已存在则更新它——每当客户开启该功能时都调用一次。
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 会把你自己决策的已部署版本以相同的 slug 复制到新的子工作区——这样每位客户都从你可用的决策起步,之后可以自行修改。它只在子工作区创建时运行;响应会列出哪些已复制、哪些被跳过。
运行客户的决策
在发送 API 密钥的同时附带请求头 Dcision-Workspace: ext:<external_id>(或子工作区的 id):
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?" } }'同一个请求头也适用于 GET /v1/decisions、GET /v1/me、GET /v1/executions 和 MCP 服务器。不属于你的子工作区会返回 404 WORKSPACE_NOT_FOUND。SDK 将它作为一个选项:
const acme = dcision.withWorkspace("ext:acme");
await acme.decide("lead-qualification", { message: "Pricing?" });幂等性按子工作区计算:为两位客户发送相同的 Idempotency-Key 会产生冲突(409),而绝不会返回另一位客户已存储的回答。
计费与限额
- 子工作区的每次计费运行都计入你的工作区的用量、套餐和钱包;速率限制也沿用你的工作区。
- 每位客户的限额(在 设置 → 合作伙伴 中设置,或通过子工作区的
limits):max_decisions(402 PLAN_LIMIT_REACHED,带scope: "workspace")以及每个计费周期的monthly_decisions(402 QUOTA_EXCEEDED,带scope: "workspace")。 - 带上该请求头调用
GET /v1/me时会额外返回workspace_usage——该客户在本周期的运行次数及其限额。 - 子工作区使用你的引擎设置和引擎密钥。它们的 LLM 和 JSON 目的地只有在你允许时才使用你的 LLM 密钥;工作区密钥(secrets)从不共享。
将你的某个决策移入其中
你在自己工作区中构建的决策可以连同其历史记录(版本、执行记录、投递和智能体对话)移动到客户的子工作区——使用 POST /v1/decisions/{slug}/move 并传入 { "to": "ext:acme" },或在应用中使用 ⋯ → 移动到子工作区(所有者和管理员)。如果子工作区中有一个具有相同 slug 且未被修改过的副本(来自 seed),replace_empty: true 会替换它。之后,使用 Dcision-Workspace 调用该决策。
在应用中查看客户的决策
设置 → 合作伙伴 → 打开 会在 Dcision 应用内显示某个子工作区的决策——与你的客户在你的应用中看到的界面相同。你工作区的成员可以编辑它们;查看者只能阅读。
删除
DELETE /v1/workspaces/ext:acme 会删除该子工作区及其所有决策和执行记录。已经计费的用量仍保留在你的工作区中。