Skip to main content

決策模型 API

呼叫 POST /compatible-mode/v1/systemone 介面使用百鍊決策模型（decision-model-preview），一次前向返回分類、評分、是非判斷及其概率分布與置信度，不生成文本。適用於工單分流、內容審核、智能體路由與結果校驗等高頻結構化決策場景。

前提條件

已建立 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 為問題對象，字段如下。
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 級）。
  • 上下文上限 65536 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": ["轻微问题，不影响功能", "部分功能受影响，但存在替代方案",
                                  "核心功能不可用，没有替代方案", "造成严重业务或安全影响"]}
    }
  }'

返回參數

model · String模型名回顯。request_id · String請求 ID，用於問題排查。answers · Object答案表，key 與請求中的問題 id 一一對應，value 為答案對象，字段如下。
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
}

錯誤碼

如果呼叫失敗，會返回錯誤資訊。更多錯誤碼及解決方法，請參見錯誤資訊。