SystemOne
通过 SystemOne 协议调用决策模型,一次请求携带业务 state 与若干 typed 问题(choice / noul / score),一次前向返回每个问题的判定结果与概率分布,不生成文本。适用于工单分流、内容审核、智能体路由与结果校验等高频结构化决策场景。
POST/v1/systemone
授权
Authorizationstringheader必填
HTTP: Bearer Auth
- Security Scheme Type: http
- HTTP Authorization Scheme: Bearer API_key,用于验证账户信息,可在按量计费&资源包 > API Key 管理中查看。
请求头
Content-Typeenum<string>默认值: application/json必填
请求体的媒介类型,请设置为 application/json,确保请求数据的格式为 JSON。可用选项:application/json
请求体application/json
statestring | object | array必填
待决策的业务上下文:工单文本、对话数组或结构化对象。非 string 时会序列化(json.dumps)后送入模型。
questionsobject必填
问题表。key 为调用方自定义的问题 id(字段名),value 为问题对象,至少包含一个字段。
questions.typestring建议
问题类型:choice(多选一)/ noul(是否判断)/ score(有序量表/评分)。省略时按 criteria 推断。
questions.instructionsstring建议
问题描述或评判标准。
questions.criteriaobject | array视类型
choice / enum:{ "选项id": "描述" },按 key 顺序、最多 255 个;score:从低到高的等级数组或对象(缺省 0..4,最多 255 档);noul / boolean:可省略,固定 true / false。
modelstring必填
模型编码,当前固定为 u2-decision
接口限制与建议
- 问题数接口不设上限(建议 ≤ 16,延迟随问题数近线性增长)。
choice选项 ≤ 255(建议≤ 26,选项过多会降低模型推理质量)。score选项 ≤ 255(缺省 0..4)。- 上下文上限 131072 token,超长
state会被截断
systemone 响应对象
modelstring
固定 u2-decision。
answersobject
答案表,key 与请求 questions 的字段名一一对应;非法或超长跳过的字段可能缺失。
answers.typeString
与问题类型一致(choice / noul / score)。
answers.choiceString
choice 类型:选中的选项名。
answers.noulFloat
P(true),∈ [0, 1];判定可用 noul >= 0.5。
answers.scoreFloat
score 类型:等级索引的概率加权期望,可落在两级之间(如 1.43)。
answers.probabilitiesObject
每个选项 / 等级的概率(和为 1)。
answers.confidenceFloat
该答案的置信度(choice / score 类型返回)。
answers.legendObject
score 类型:等级索引 → 等级描述。
latency_msnumber
本次推理耗时(毫秒)。