子工作区

为你应用的每位客户创建一个子工作区,用你自己的 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 会删除该子工作区及其所有决策和执行记录。已经计费的用量仍保留在你的工作区中。

本页内容