DOCS · APPROVALS

审批意图

中枢不替业务决定谁能审批。它只冻结高风险工具调用快照,生成审批意图,并在业务侧回传决策后放行或驳回。

POST业务侧审批意图接收 URL
{
  "kind": "tool_approval_request",
  "approval_id": 123,
  "job_id": "job_...",
  "route": "inventory_ops",
  "provider": "erp",
  "tool": "inventory.adjust",
  "scope": "inventory.write",
  "risk": "high",
  "on_behalf_of": "tenant_1:user_1001",
  "args": { "store_id": 8, "sku_id": 10086, "delta": -20 },
  "args_hash": "sha256:...",
  "intent": {
    "title": "库存扣减需要审批",
    "summary": "将门店 8 的 SKU 10086 库存扣减 20"
  }
}
POST/approvals/{approval_id}/decision
{
  "kind": "tool_approval_decision",
  "schema_version": "bailing.approval-decision.v1",
  "approval_id": 123,
  "job_id": "job_...",
  "request_id": "req_...",
  "args_hash": "sha256:...",
  "decision_id": "oa:approval:9001",
  "decision": "approved",
  "approver": "user_2002",
  "comment": "OA 审批单 oa:approval:9001 已通过"
}

决策只接受 approved / denied。必须带回 approval_idjob_idrequest_idargs_hash,中枢只放行原始冻结快照。decision_id 是业务审批系统的幂等键。

相关 schema

approval-request.schema.json · approval-decision.schema.json