直接使用流程既有的標籤
一次分類請求包含 text(3–6,000 字元)、instructions(3–1,500 字元)、2 到 12 個不重複、各不超過 60 字元且各佔一行的標籤,以及介於 0.5 與 1、預設 0.85 的 threshold。標籤就是答案範圍:回傳其他名稱會以供應商錯誤拒收,不會進入你的流程。
若兩個標籤永遠導向同一個動作,它們其實是同一個標籤。當訊息可能落在類別之外時,加入「其他」或「不明」結果,讓無法歸類的文字有誠實的去處,而不是被推進最接近的佇列。
curl https://jevapi.pro/api/v1/decisions \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: doc-8841-v1' \
-d '{
"text": "發票 INV-2291 仍未付款,請寄一份含稅額明細的副本。",
"instructions": "選擇這則訊息索取的單據類型。",
"labels": ["發票", "合約", "收據", "其他"],
"threshold": 0.85
}'一次請求最多可問 4 個型別化問題
同一個端點也接受型別化問題,取代單一標籤清單:1 到 4 個問題,各有 id、型別與準則。choice 需要 2–12 個準則標籤,noul 需要 true 與 false 準則,score 需要 2–7 個有序等級。若一個內容同時帶 questions 與 instructions 或 labels,會以 400 ambiguous_input 拒絕,因為一個請求不能同時是兩種請求。
每個答案都以你送出的 id 回傳:choice 帶標籤與機率,noul 帶 0 到 1 的機率,score 帶它在評分標準上的位置。最上層的 choice、confidence 與 probabilities 對應第一個問題,needsReview 在任何答案需要覆核時為 true。不論問 1 個標籤或 4 個型別化問題,一次請求都算 1 點;失敗的帳戶請求會退還點數,以相同冪等鍵重播已完成的請求不會再次計費。
{
"text": "按下付款後結帳頁面變成空白,我試過兩個瀏覽器。",
"questions": [
{"id": "team", "type": "choice", "instructions": "這個案件應由哪個團隊負責?", "criteria": {"billing": "帳務或退款問題。", "technical": "錯誤或異常行為。", "account": "登入、權限或個人資料。"}},
{"id": "is_bug", "type": "noul", "instructions": "來訊者是否回報產品缺陷?", "criteria": {"true": "描述了損壞或異常的行為。", "false": "提出問題或功能需求。"}},
{"id": "urgency", "type": "score", "instructions": "這個案件需要多快回應?", "criteria": ["可以等", "本週內", "工作被卡住"]}
],
"threshold": 0.85
}把答案當證據,而不是確定性
機率只檢查範圍與是否落在允許的標籤上。API 不保證機率總和為 1,也不保證最大機率對應回傳的答案;缺少機率時回傳空物件,不會代為補值。模型未提供信心時 confidence 為 null,此時 needsReview 為 true。
模型失敗會是錯誤回應,絕不會變成預設標籤:502 或 503 會退還點數,也不留下任何判定。請測試否定句、引用文字、一則訊息多個請求,以及藏在文字裡的指令——文字是被判定的證據,不是要遵循的任務。最後用自己標記的保留資料集計算錯誤,因為供應商公開的評測結果與你的資料無關。