Amux AI

Jev

最近更新:2026年10月7日

TypeSafeAI 决策模型 Jev 的问题类型、响应结构、置信度与使用限制。

Jev 是 TypeSafeAI 的 System One 决策模型。该模型不生成自由文本,而是针对输入的上下文 state 并行评估一组带类型的问题,并为每个问题返回结构化评估结果,供业务代码直接执行分支判断。

该模型通过 TypeSafeAI System One 端点调用,官方 SDK(typesafe-sdk、@typesafe-ai/sdk)只需将 Base URL 指向 Amux AI 即可直接使用。

模型规格

属性说明
模型 IDtypesafe/jev
可用别名jev-latest(官方 SDK 未指定 model 时的默认值)、jev-preview、jev-1.13.0
当前版本jev-1.13.0
上下文上限单次请求 64K token;state 与单个最长问题合计 ≤ 32K token
支持输入仅文本(字符串、JSON 对象或数组);图像、音频、视频需预先转换为文本或结构化字段
计费方式仅按输入 token 计费,输出不计费;具体单价见模型详情页
流式输出不支持
POSThttps://gateway.amux.ai/v1/systemone

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> 在控制台创建的 Amux AI API 密钥。

Content-Typestring必填默认 "application/json"

固定为 application/json。

请求

application/json
modelstring必填

模型标识。支持规范 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"
instructionsstring · object · array是待判断的陈述
criteriaobject否{ "true": …, "false": … },分别定义成立与不成立的判定标准
"is_urgent": {
  "type": "noul",
  "instructions": "Does this convey urgency?",
  "criteria": { "true": "Explicitly time-sensitive", "false": "No urgency expressed" }
}

choice:单选分类

从预定义的候选选项中选择最匹配的一项,并返回所有选项的概率分布。

字段类型必填说明
type"choice"是固定为 "choice"
instructionsstring · object · array是待执行的分类或决策问题
criteriamap<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"
instructionsstring · object · array是评分维度说明
criteriaarray<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返回字段
noulnoul:0(否)至 1(是)的概率值
choicechoice:最高概率选项;probabilities:各选项概率映射(总和为 1);confidence:置信度
scorescore:概率加权分值;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触发条件
400invalid_request请求体缺少必填字段或问题结构未通过校验(错误信息会指明具体字段,如 questions.q.choice.criteria: Field required)
400context_length_exceeded请求内容超出上下文长度上限
402insufficient_credits账户可用余额不足
502provider_*上游限流、过载或临时异常,可退避后重试

完整的错误类型与重试规则见错误与重试。

cURL
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
  }
}