Copy

前提条件

已创建 API Key 并配置为环境变量 DASHSCOPE_API_KEY。配置方法请参见配置 API Key 到环境变量。

请求说明

协议：TypeSafe System One（POST /compatible-mode/v1/systemone）一次请求携带业务 state 与若干 typed 问题（choice / noul / score），模型一次前向返回每个问题的判定结果与概率分布，其中 choice 与 score 额外返回置信度，不生成文本，因此延迟与成本与输出长度无关。 请求地址 调用时请将 {WorkspaceId} 替换为业务空间 ID，详见地域与域名。

地域	Endpoint
新加坡	`https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/systemone`
华北2（北京）	`https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/systemone`

请求参数

Content-Type · String · Header · 必选请求类型：application/json。Authorization · String · Header · 必选API-Key，格式：Bearer $DASHSCOPE_API_KEY。model · String · Body · 必选模型名，取值 decision-model-preview。state · String / Object / Array · Body · 必选待决策的业务状态：工单文本、对话或结构化对象（对象会被序列化后送模型）。questions · Object · Body · 必选问题表。key 为调用方自定义的问题 id；value 为问题对象，字段如下。

questions 属性

type · String · 必选问题类型，取值：

choice：多选一
noul：是否判断
score：有序量表

instructions · String · 可选问题描述或评判标准。criteria · Object / Array · 视类型

choice：选项名 → 选项描述的映射（1–255 项，建议给全量选项并补 other 兜底）。
noul：可选 {"true":…, "false":…} 描述。
score：从低到高的等级描述数组（2–10 级，建议 3–7 级且每级可清晰区分）。

接口限制与建议

问题数接口不设上限（建议 ≤ 16，延迟随问题数近线性增长）。
choice 选项 ≤ 255。
score 等级 2–255（建议 3–7 级）。
上下文上限 65535 token，超长 state 会被拒绝或截断。

请求示例

Python 示例使用 TypeSafe SDK（typesafe-sdk）调用，base_url 指向百炼网关，SDK 会自动拼接 /v1/systemone 并解析返回体。安装：pip install typesafe-sdk。

工单分流示例
是非判断示例

一次请求同时完成「派单团队 choice」「是否升级 noul」「严重度 score」三项决策。以下以新加坡地域为例。

curl -sS -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/systemone \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "decision-model-preview",
    "state": {"ticket_id": "T-1001", "content": "订单支付后超过 24 小时仍未到账，用户无法继续使用核心服务，要求立即处理。"},
    "questions": {
      "department": {"type": "choice", "instructions": "应该由哪个团队处理？",
                     "criteria": {"billing": "支付、退款和账单问题", "technical": "产品故障和集成问题"}},
      "escalate":   {"type": "noul",  "instructions": "是否需要立即通知值班人员？"},
      "severity":   {"type": "score", "instructions": "这个问题有多严重？",
                     "criteria": ["轻微问题，不影响功能", "部分功能受影响，但存在替代方案",
                                  "核心功能不可用，没有替代方案", "造成严重业务或安全影响"]}
    }
  }'

对一个 noul 问题返回 P(yes) 概率，0=否 1=是。以下以新加坡地域为例。

curl -sS -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/systemone \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "decision-model-preview",
    "state": "这段评论是否在索要退款？",
    "questions": {
      "refund": {"type": "noul", "instructions": "是否在索要退款？"}
    }
  }'

返回参数

model · String模型名回显。request_id · String请求 ID，用于问题排查。answers · Object答案表，key 与请求中的问题 id 一一对应，value 为答案对象，字段如下。

answers 属性

type · String与问题类型一致（choice / noul / score）。choice · Stringchoice 类型：选中的选项名。noul · Floatnoul 类型：P(yes)，0=否 1=是。score · Floatscore 类型：等级索引的概率加权期望，可落在两级之间（如 1.43）。probabilities · Object每个选项 / 等级的概率（和为 1）。confidence · Float该答案的置信度（choice / score 类型返回）。legend · Objectscore 类型：等级索引 → 等级描述。

usage · Object计量信息：

input_tokens（Integer）：输入 token 数。

latency_ms · Float服务端耗时（毫秒）。

返回示例

以下为工单分流示例的返回结果（节选），概率与置信度以实际返回为准。

{
  "model": "decision-model-preview",
  "request_id": "7b986c65-b223-9341-b5f0-b988e27ecaac",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "billing",
      "confidence": 0.88,
      "probabilities": {"billing": 0.94, "technical": 0.06}
    },
    "escalate": {
      "type": "noul",
      "noul": 0.99
    },
    "severity": {
      "type": "score",
      "score": 2.25,
      "confidence": 0.91,
      "legend": {
        "0": "轻微问题，不影响功能",
        "1": "部分功能受影响，但存在替代方案",
        "2": "核心功能不可用，没有替代方案",
        "3": "造成严重业务或安全影响"
      },
      "probabilities": {"0": 0.0, "1": 0.01, "2": 0.73, "3": 0.26}
    }
  },
  "usage": {"input_tokens": 125},
  "latency_ms": 52.9
}

错误码

如果调用失败，会返回错误信息。更多错误码及解决方法，请参见错误信息。

​前提条件

​请求说明