POST /admin/cells

创建一个新的 Cell（隔离域）。

POST /admin/cells

请求参数

{
  "id": "dept-legal",
  "timezone": "Asia/Shanghai",
  "locale": "zh-CN",
  "provider_strategy": "shared_only",
  "compliance": "financial"
}

字段	类型	必填	说明
`id`	string	✅	Cell ID，创建后不可变
`timezone`	string	否	时区，创建后不可变。默认 `UTC`。示例：`Asia/Shanghai`
`locale`	string	否	语言区域。示例：`zh-CN`
`provider_strategy`	string	否	Provider 策略：`own_only` / `shared_only` / `own_first` / `shared_first`
`compliance`	string	否	合规预设：`standard`（默认）/ `financial` / `pii-strict` / `healthcare`
`governance`	object	否	治理配置（GovernMode + DenyPaths + NetworkPolicy）
`quotas`	object	否	配额配置（MaxConcurrentRuns / TokensPerMinute 等）

Compliance 预设效果：

预设	GovernMode	NetworkPolicy	适用场景
`standard`	open	allow	通用场景
`financial`	locked	internal_only	金融合规
`pii-strict`	locked	internal_only	个人信息保护
`healthcare`	locked	internal_only	医疗健康

curl 示例

创建一个法务部门 Cell：

curl -s -X POST "http://localhost:9091/admin/cells" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "dept-legal",
    "timezone": "Asia/Shanghai",
    "locale": "zh-CN",
    "provider_strategy": "shared_only",
    "compliance": "financial"
  }' | jq .

响应

201 Created

{
  "id": "dept-legal",
  "state": "Cool",
  "created_at": "2026-09-21T14:00:00Z"
}

注意事项

Cell 创建后处于 Cool 状态。首次请求到达时自动激活（WarmUp）。
id 和 timezone 字段创建后不可修改（immutable）。
如果 id 已存在，返回 409 Conflict。

错误码

HTTP	错误	说明
400	—	请求体格式错误或字段值无效
401	—	未认证或 Token 无效
403	—	非 Admin Token
409	—	Cell ID 已存在

POST /admin/cells

请求参数

curl 示例

响应

201 Created

注意事项

错误码

相关端点