Jev
最近更新:2026年10月7日
TypeSafeAI 决策模型 Jev 的问题类型、响应结构、置信度与使用限制。
Jev 是 TypeSafeAI 的 System One 决策模型。该模型不生成自由文本,而是针对输入的上下文 state 并行评估一组带类型的问题,并为每个问题返回结构化评估结果,供业务代码直接执行分支判断。
该模型通过 TypeSafeAI System One 端点调用,官方 SDK(typesafe-sdk、@typesafe-ai/sdk)只需将 Base URL 指向 Amux AI 即可直接使用。
模型规格
| 属性 | 说明 |
|---|---|
| 模型 ID | typesafe/jev |
| 可用别名 | jev-latest(官方 SDK 未指定 model 时的默认值)、jev-preview、jev-1.13.0 |
| 当前版本 | jev-1.13.0 |
| 上下文上限 | 单次请求 64K token;state 与单个最长问题合计 ≤ 32K token |
| 支持输入 | 仅文本(字符串、JSON 对象或数组);图像、音频、视频需预先转换为文本或结构化字段 |
| 计费方式 | 仅按输入 token 计费,输出不计费;具体单价见模型详情页 |
| 流式输出 | 不支持 |
https://gateway.amux.ai/v1/systemone鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> 在控制台创建的 Amux AI API 密钥。
Content-Typestring必填默认 "application/json"固定为 application/json。
请求
application/jsonmodelstring必填模型标识。支持规范 ID typesafe/jev 或模型别名 jev-latest(官方 SDK 默认值)、jev-preview、jev-1.13.0。如需固定置信度阈值行为,建议指定具体版本号 jev-1.13.0。
statestring | object | array必填待评估的上下文数据,支持字符串、JSON 对象或数组(如对话记录、业务单据或应用状态)。建议使用语义清晰的字段名,并在 questions 中使用反引号(如 ` message `)引用对应字段。仅支持文本数据,不支持图像、音频或视频。
questionsmap<string, Question>必填待评估问题映射表。键为调用方自定义的问题标识(不参与模型推理),响应中的 answers 按相同键名返回对应评估结果。同一请求中的多个问题针对同一 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评估成功,按请求中的问题键名返回对应的结构化评估结果。
400response请求体格式错误、问题定义未通过参数校验(错误信息包含具体字段路径),或输入超出上下文长度上限。
402response账户可用余额不足。
问题类型
每个问题均包含 type、instructions 及按类型定义的 criteria。单次请求可混合传入多种类型的问题;所有问题针对同一 state 并行独立评估,增加问题数量对整体延迟影响极小。
noul:二元判断
评估指定陈述成立的概率,返回 0(否)至 1(是)之间的浮点数。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | "noul" | 是 | 固定为 "noul" |
instructions | string · object · array | 是 | 待判断的陈述 |
criteria | object | 否 | { "true": …, "false": … },分别定义成立与不成立的判定标准 |
"is_urgent": {
"type": "noul",
"instructions": "Does this convey urgency?",
"criteria": { "true": "Explicitly time-sensitive", "false": "No urgency expressed" }
}choice:单选分类
从预定义的候选选项中选择最匹配的一项,并返回所有选项的概率分布。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | "choice" | 是 | 固定为 "choice" |
instructions | string · object · array | 是 | 待执行的分类或决策问题 |
criteria | map<string, string · object · array · null> | 是 | 选项名到判定说明的映射;无需额外说明的选项填 null,最多支持 255 个选项 |
"department": {
"type": "choice",
"instructions": "Which team should handle this?",
"criteria": {
"billing": "Payments, invoicing, refunds",
"technical": "Bugs, outages, integrations",
"sales": null
}
}score:有序评分
按从低到高排列的档位进行评分,返回概率加权后的连续分值(可介于相邻档位之间)。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | "score" | 是 | 固定为 "score" |
instructions | string · object · array | 是 | 评分维度说明 |
criteria | array<string · object · array> | 是 | 各档位描述,下标 0 为最低档,支持 2–10 个档位 |
"frustration": {
"type": "score",
"instructions": "How frustrated is the customer?",
"criteria": ["Calm", "Frustrated", "Very angry"]
}结构化指令与字段引用
instructions、choice 选项说明、score 档位描述以及 noul 的 criteria 均支持传入 JSON 对象。可将问题描述与参考数据分字段存放,并在问题文本中使用反引号按字段名引用:
"instructions": {
"potential_duplicate": { "name": "John Smith", "location": "Oakland, California" },
"question": "Is the resume for the same person as `potential_duplicate`?"
}引用 state 中的字段采用相同语法:例如 state 为 { "message": "…" } 时,可在问题中使用 `message` 引用该字段。
响应结构
响应中 answers 的键名与请求中的 questions 一一对应,每个结果对象均携带与问题相同的 type:
type | 返回字段 |
|---|---|
noul | noul:0(否)至 1(是)的概率值 |
choice | choice:最高概率选项;probabilities:各选项概率映射(总和为 1);confidence:置信度 |
score | score:概率加权分值;legend:档位下标到描述的映射;probabilities:各档位概率映射;confidence:置信度 |
响应中的 model 字段返回实际执行评估的具体版本号(例如 jev-1.13.0)。由于 jev-latest 等别名会随新版本发布而更新,建议记录响应中的版本号以便追踪评估结果。
置信度说明
choice 与 score 类型的结果包含 confidence 字段(取值范围 0–1),用于衡量概率分布的集中程度:概率完全集中于单一选项时为 1,均匀分布时为 0。noul 本身即为概率值,不包含单独的 confidence 字段。
实际接入时可按置信度划分处置策略:高置信度结果自动执行,中等置信度交由人工确认或复核,低置信度转交人工或推理模型处理。涉及写操作或不可逆操作时应设置更高的置信度阈值。若业务已针对特定版本校准阈值,建议固定调用 jev-1.13.0,并在升级版本前重新验证阈值。
使用限制与建议
建议将复杂逻辑拆分为原子化问题,并在应用代码中组合判断结果。Jev 1.13 在以下场景中存在局限性,建议按表中方式调整:
| 场景 | 建议做法 |
|---|---|
| 边界条件判断 | 明确表述判定条件,并将边界情形写入 criteria |
| 算术、计数与数值比较 | 逐项使用 noul 判断,在应用代码中完成计数或数值计算 |
| 日期与时间比较 | 使用 choice 提取日期时间字段,在应用代码中比较 |
| 间接指代与双重否定 | 使用直接陈述句,并用反引号明确指向 state 中的字段 |
大体积或高噪声 state | 预先裁剪输入,仅传入当前评估所需的字段 |
含对抗性文本的 state | 在 criteria 中明确防注入规则,并针对边界样本进行测试 |
| 跨问题概率一致性 | 不同问题的概率相互独立(互补问题的概率之和不一定等于 1);请勿在 noul 与 choice 之间混用同一阈值 |
| 开放式内容生成 | 先使用生成式模型产出候选方案,再由 Jev 进行选择或评分 |
模型在英文输入上表现最佳;使用中文或其他语言时,建议先基于业务样本进行评估并重点关注置信度指标。
请求参数过滤
网关仅向上游转发顶层的 model、state 与 questions 字段;其余未知顶层字段会被网关移除,并记录在响应体 amux.droppedParams 与响应头 x-amux-dropped-params 中。questions 各问题对象内部的字段原样透传。
错误处理
错误响应采用兼容 OpenAI 的结构({ "error": { "type", "message", … } }),官方 SDK 可直接解析。
| 状态码 | type | 触发条件 |
|---|---|---|
| 400 | invalid_request | 请求体缺少必填字段或问题结构未通过校验(错误信息会指明具体字段,如 questions.q.choice.criteria: Field required) |
| 400 | context_length_exceeded | 请求内容超出上下文长度上限 |
| 402 | insufficient_credits | 账户可用余额不足 |
| 502 | provider_* | 上游限流、过载或临时异常,可退避后重试 |
完整的错误类型与重试规则见错误与重试。
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
}
}