AI 助理
文档备案控制台
官方文档
首页 大模型服务平台百炼 API参考（模型） 决策模型 决策模型

决策模型 API

更新时间：
复制 MD 格式
产品详情
我的收藏

调用 POST /compatible-mode/v1/systemone 接口使用百炼决策模型（decision-model-preview），一次前向返回分类、评分、是非判断及其概率分布与置信度，不生成文本。适用于工单分流、内容审核、智能体路由与结果校验等高频结构化决策场景。

前提条件

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

重要在线体验：在编写代码前，可先通过 Playground 在线体验决策模型。选择预设场景（客服对话判断、Agent 完成度核验、工单分流、内容审核、Agent 任务路由、医疗导诊辅助），输入业务内容并运行模型，查看判断结果、概率分布与 Token 用量，再修改条件观察结果变化。

请求说明

协议：TypeSafe System One（POST /compatible-mode/v1/systemone）

一次请求携带业务 state 与若干 typed 问题（choice / noul / score），模型一次前向返回每个问题的判定结果与概率分布，其中 choice 与 score 额外返回置信度，不生成文本，因此延迟与成本与输出长度无关。

请求地址

调用时请将 {WorkspaceId} 替换为业务空间 ID，详见地域与域名。

地域

Endpoint

华北2（北京）

https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/systemone

新加坡

https://{WorkspaceId}.ap-southeast-1.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 为问题对象，字段如下。

问题对象属性

type · String · 必选

问题类型，取值：

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

instructions · String · 可选

问题描述或评判标准。

criteria · Object / Array · 视类型

  • choice：选项名 → 选项描述 的映射（1–255 项，建议给全量选项并补 other 兜底）。
  • noul：可选 {"true":…, "false":…} 描述。
  • score：从低到高的等级描述数组（2–255 级，建议 3–7 级且每级可清晰区分）。
接口限制与建议
  • 问题数上限 16（延迟随问题数近线性增长）。
  • choice 选项 ≤ 255。
  • score 等级 2–255（建议 3–7 级）。
  • 上下文上限 65536 token，超长 state 会被拒绝。

请求示例

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

工单分流示例

一次请求同时完成「派单团队 choice」「是否升级 noul」「严重度 score」三项决策。以下以华北2（北京）地域为例。

curl -sS -X POST https://{WorkspaceId}.cn-beijing.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": ["轻微问题，不影响功能", "部分功能受影响，但存在替代方案",
                                  "核心功能不可用，没有替代方案", "造成严重业务或安全影响"]}
    }
  }'

import os
from typesafe_sdk import TypeSafeClient

client = TypeSafeClient(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode",
)

result = client.system_one(
    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": ["轻微问题，不影响功能", "部分功能受影响，但存在替代方案",
                                  "核心功能不可用，没有替代方案", "造成严重业务或安全影响"]},
    },
)

print(result.answers["department"])   # choice, confidence, probabilities
print(result.answers["escalate"])     # noul P(yes)
print(result.answers["severity"])     # score, legend, probabilities

是非判断示例

对一个 noul 问题返回 P(yes) 概率，0=否 1=是。以下以华北2（北京）地域为例。

curl -sS -X POST https://{WorkspaceId}.cn-beijing.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": "是否在索要退款？"}
    }
  }'

import os
from typesafe_sdk import TypeSafeClient

client = TypeSafeClient(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode",
)

result = client.system_one(
    model="decision-model-preview",
    state="这段评论是否在索要退款？",
    questions={"refund": {"type": "noul", "instructions": "是否在索要退款？"}},
)

print(result.answers["refund"])   # noul P(yes)

返回参数

model · String

模型名回显。

request_id · String

请求 ID，用于问题排查。

answers · Object

答案表，key 与请求中的问题 id 一一对应，value 为答案对象，字段如下。

答案对象属性

type · String

与问题类型一致（choice / noul / score）。

choice · String

choice 类型：选中的选项名。

noul · Float

noul 类型：P(yes)，0=否 1=是。

score · Float

score 类型：等级索引的概率加权期望，可落在两级之间（如 1.43）。

probabilities · Object

每个选项 / 等级的概率（和为 1）。

confidence · Float

该答案的置信度（choice / score 类型返回）。

legend · Object

score 类型：等级索引 → 等级描述。

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
}

错误码

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

上一篇：决策模型下一篇：更多模型