Amux AI

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。

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)或版本别名(如官方 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
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
  }
}