根式与工作区式更新差异¶
两套管理协议不能只换路径。分别确认字段、枚举、空值、成功码和返回包装后再调用。
项目 |
根式 |
工作区式 |
|---|---|---|
后端类型 |
字符串;非法/省略创建按 OPENAI |
数值0~6;非法拒绝,省略0。 |
创建提供商密钥 |
OPENAI/QIANWEN/DOUBAO 检查非空 |
所选创建 owner 未把密钥非空作为统一条件;保存不证明可调用。 |
更新 name/key/timeout |
只应用非空/正数,空值保留 |
同类非空/正数规则,key 名为 api_key_encrypted。 |
更新 models |
省略/null/[] 保留,非空数组替换 |
省略/null 保留,[] 清空,非空数组替换。 |
重设推理 NONE |
非空协议字符串 |
optional数值0;省略/null保留。 |
来源字段 |
未采用 |
仅 LLM;origin_ref/version 空串可清除,provider_origin 空串拒绝。 |
端点状态 |
ONLINE/OFFLINE;非法/省略按 ONLINE |
0/1;非法拒绝,省略/null按0。 |
Router strategy |
非法/省略按 ROUND_ROBIN |
非法拒绝,省略0。 |
Router interval |
非正按30 |
非正按30。 |
Router LLM retries |
非正按0 |
零/省略为0,负数按2。 |
Router Embedding retries |
非正按2 |
非正按2。 |
Router affinity |
省略/null按false覆盖 |
省略/null按false覆盖。 |
Root update 的空数组不会清空。工作区式虽有清空 HTTP 合同,但当前专用 Go/Python 及其 CLI 的重复字段序列化会丢失空数组。参数类型存在不等于客户端能表达所有有效 HTTP 输入,见 模型与供给后端。
工作区式对象的 type=0、status=0、reasoning=0、strategy=0 和 false/空数组可从 HTTP 响应省略;顶层成功 code=0 保留。CLI JSON 还会按自身序列化省略零值。检查对象 ID、默认值与字段存在性,不能把所有缺键等同于未知或失败。