TypeSafe Decisions
使用 Jev 進行條件判斷、分類、評分和工具選擇。
Decisions 使用 Jev 對文字或業務狀態進行判斷，回傳可直接在程式碼中讀取的答案。介面同步回傳 JSON，不支援串流回應。
請求範例
以下範例使用 jev-1.13.0。選擇問題情境與程式語言後，即可複製對應請求。
是否要求退款
curl --request POST 'https://api.agtcloud.cn/v1/decisions' \
--header 'Authorization: Bearer your-api-key' \
--header 'Content-Type: application/json' \
--data '{
"model": "jev-1.13.0",
"state": "My subscription was charged twice. Please refund the duplicate charge.",
"questions": {
"ticket": {
"type": "noul",
"instructions": "Does the customer explicitly request a refund?",
"criteria": {
"true": "The message explicitly asks for a refund.",
"false": "The message does not ask for a refund."
}
}
}
}'問題類型
| 類型 | 用途 | 回傳內容 |
|---|---|---|
noul | 判斷條件是否成立，例如客戶是否要求退款 | noul：條件成立的機率 |
choice | 從候選項中選擇分類或動作，例如工單處理部門 | choice、probabilities、confidence |
score | 按照有序標準評分，例如工單緊急程度 | score、legend、probabilities、confidence |
透過 state 提供待判斷的內容，在 questions 中填寫問題及標準。同一請求可以包含多個問題，也可以混合三種類型；每個問題共用同一個 state。
讀取結果
answers 使用與 questions 相同的問題 ID。例如問題 ID 為 ticket 時，從 answers.ticket 讀取答案。
- 判斷：讀取
noul。數值範圍為 0～1，接近 1 表示傾向成立，接近 0 表示傾向不成立；依業務需要設定判斷閾值。 - 分類：讀取
choice取得選項名稱，使用probabilities檢視各選項機率。 - 評分：讀取
score。等級依criteria的陣列位置從 0 編號；三階標準對應 0～2，評分可以為小數。legend提供等級編號與說明的對應關係。
choice 和 score 的 confidence 表示機率分布的確定程度，不等於答案正確率。機率、評分和 Token 用量會隨請求變化。
工具選擇使用 choice 回傳動作名稱，例如 lookup_payment。應用程式依該名稱執行後續操作；本次決策請求不會執行工具，也不會產生 OpenAI tool_calls。
Token 用量與費用
usage.input_tokens 和 usage.output_tokens 分別記錄輸入、輸出 Token 用量。Jev 按輸入 Token 計費，輸出 Token 不收費；多個問題及候選說明也會影響輸入用量。目前價格請參閱 模型廣場。