Evaluate Questions
最近更新:2026年10月7日
TypeSafeAI System One 兼容决策端点,支持官方 SDK 调用 Jev 等结构化决策模型。
兼容 TypeSafeAI System One 协议的结构化决策端点。使用官方 SDK(typesafe-sdk、@typesafe-ai/sdk)时,只需将 Base URL 指向 Amux AI,并通过 Authorization: Bearer <key> 鉴权即可调用。
本页定义所有 System One 决策模型共用的协议请求与响应结构。具体模型的版本别名、上下文窗口与使用建议请参阅对应模型文档,例如 Jev。
https://gateway.amux.ai/v1/systemone鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> 在控制台创建的 Amux AI API 密钥。
Content-Typestring必填默认 "application/json"请求内容类型,固定为 application/json。
请求
application/jsonmodelstring必填规范模型 ID(如 typesafe/jev)或版本别名(如官方 SDK 默认发送的 jev-latest)。响应体 model 字段返回实际执行评估的具体带版本号模型 ID。
statestring | object | array必填待评估的上下文数据,支持纯文本字符串、JSON 对象或 JSON 数组(仅支持文本数据,不支持图像、音频或视频)。建议使用字段语义清晰的 JSON 对象,并在问题指令中通过反引号引用字段名(如 ` message `)。
questionsmap<string, Question>必填待评估问题映射表,键为调用方自定义的问题 ID,响应体 answers 按相同键名返回对应结果。问题 ID 不参与模型推理;所有问题基于同一份 state 并行评估。
›questionsmap<string, Question>
‹question id›Question结构化评估问题。通过 type 指定问题类型(noul、choice 或 score);三类问题均包含 type 与 instructions,并各自通过 criteria 定义判定标准。
›‹question id›Question
noulobject布尔概率评估问题。返回陈述成立的概率值(取值范围 0–1)。
›noulobject
type"noul"必填问题类型,固定为 noul。
instructionsstring | object | array必填待评估的布尔陈述。支持字符串、JSON 对象或数组;传入对象时,可在问题文本中通过反引号(如 ` field )引用同级或 state` 中的字段名。
criteriaobject可选判定准则,分别定义正向(接近 1)与负向(接近 0)的判定标准及边界条件。
›criteriaobject
truestring | object | array判定为成立(接近 1)的条件说明。
falsestring | object | array判定为不成立(接近 0)的条件说明。
choiceobject单项选择评估问题。从给定候选项中选择唯一最佳项,返回选中项、各候选项的概率分布及 confidence 置信度。
›choiceobject
type"choice"必填问题类型,固定为 choice。
instructionsstring | object | array必填分类或决策指令。支持字符串、JSON 对象或数组。
criteriaobject必填候选项映射表(键为选项名,值为该选项的判定说明;无需额外说明时可设为 null)。最多支持 255 个选项,选项名将原样作为响应 probabilities 的键返回。
scoreobject有序量表评分问题。按从低到高排列的等级标准对 state 评分,返回概率加权后的连续分值与置信度。
›scoreobject
type"score"必填问题类型,固定为 score。
instructionsstring | object | array必填评分维度说明。支持字符串、JSON 对象或数组。
criteriaarray<string>必填按从低到高顺序排列的量表等级说明(索引 0 对应最低等级)。支持 2–10 个等级。
响应
200response评估成功,按请求中的问题 ID 返回对应结构化答案。
400response请求体格式错误、问题定义未通过参数校验,或输入超出上下文长度上限。
402response账户可用余额不足。
协议特性说明
决策模型不执行自由文本生成,而是针对给定的上下文 state 并行评估一组带类型的问题,并为每个问题返回确定结构的评估结果:
noul:返回二元陈述成立的概率(0–1)。choice:从预定义候选项中选出最匹配项,并返回各选项概率分布与confidence置信度。score:在有序评分档位上计算加权连续分值(可介于相邻档位之间),并返回各档位概率与confidence置信度。
决策模型不支持通过 /v1/chat/completions、/v1/messages 等文本对话端点调用。
错误处理
错误响应遵循 OpenAI 标准错误结构。questions 内部结构由上游模型校验,参数不合法时返回 400 错误并指明具体字段路径;完整的 type 枚举值与重试规则见错误与重试。
curl https://gateway.amux.ai/v1/systemone \
-H "Authorization: Bearer $AMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "typesafe/jev",
"state": {
"message": "Hi, my Stripe integration has been failing for 3 days. Please help ASAP."
},
"questions": {
"department": {
"type": "choice",
"instructions": "Which team should handle `message`?",
"criteria": {
"billing": "Payment or subscription issues",
"technical": "Bugs or integration problems",
"sales": null
}
},
"frustration": {
"type": "score",
"instructions": "How frustrated does the customer appear?",
"criteria": [
"Calm",
"Frustrated but civil",
"Very angry"
]
},
"is_urgent": {
"type": "noul",
"instructions": "`message` conveys urgency or time-sensitivity"
}
}
}'{
"model": "jev-1.13.0",
"answers": {
"department": {
"type": "choice",
"choice": "technical",
"confidence": 0.95,
"probabilities": {
"billing": 0.03,
"sales": 0,
"technical": 0.97
}
},
"frustration": {
"type": "score",
"score": 1,
"confidence": 1,
"legend": {
"0": "Calm",
"1": "Frustrated but civil",
"2": "Very angry"
},
"probabilities": {
"0": 0,
"1": 1,
"2": 0
}
},
"is_urgent": {
"type": "noul",
"noul": 1
}
},
"usage": {
"input_tokens": 407,
"output_tokens": 73
}
}