Nace.AI: Drex v1.5
Drex 1.5 會依據具型別的問題評估所提供的文字或 JSON,並回傳機率、選定的標籤或帶小數的評分準則分數。Nace.AI 的文件說明它僅處理文字決策,適用於分類、分流與優先順序排定,並依版本設有不同的狀態與請求上限。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項,依所選方法列於下方。
Drex 1.5 是 Nace.AI 的文字決策模型。它依據封閉式問題評估所提供的事實,並回傳數值化、具型別的答案,而不是開放式的書面回應。一次請求會將一個狀態與多個具名問題結合,結果則以相同的問題名稱標示各個答案。如此一來,工作流程能取得具體的類別、機率或評分準則位置加以運用,至於要依據結果採取什麼動作,則交由應用程式決定。
準備狀態
狀態是所有問題共同涉及的資訊。Drex 接受 JSON 字串、物件、陣列、數字、布林值或 null,且狀態欄位為必填。即使 null 能通過開發商的驗證,仍請提供有意義的證據。字串適合用於訊息、文件或逐字稿;物件則適合已整理成欄位的事實。請保留會影響決策的資訊,資料較長時則省略不相關的欄位。解讀機率門檻值時,請維持穩定的輸入格式,因為改變表示方式可能會改變答案。
Drex 1.5 只讀取文字。文件所載的介面會拒絕出現在狀態或問題中的影像、音訊、影片與 PDF 內容,包括編碼後的媒體與媒體內容物件。若要將這類素材作為證據,請先準備圖說、辨識後的文件文字或逐字稿。文字形式的網址並不等於已擷取的文件或影像:模型無法開啟它。以客服請求為例,有用的狀態是實際訊息與相關上下文,而不是指向模型未曾收到之素材的參照。
是非機率、選擇或評分
noul 問題詢問某個條件是否成立,並回傳一個介於 0 到 1 之間、代表「是」之估計機率的數字。請透過非空白的指令,或至少一項非空白的真/假判斷準則來定義問題。例如,詢問某則訊息是否回報了功能故障,並定義運作緩慢是否算作故障。Drex 沒有內建的是非判定界線;由使用結果的工作流程決定如何解讀該機率。
選擇(choice)問題會從無序集合中選出一個所提供的標籤,並為每個標籤回傳機率。判斷準則是一個物件,其鍵即為回傳的標籤,每段說明可以是字串或 null。請使用簡短、穩定的鍵,並清楚描述各類別的界線。示範性的分流任務可以區分存取問題、產品瑕疵與一般問題,並為不符合的訊息設置一個 other(其他)類別。選定的標籤可用於分流;機率分布則有助於找出兩個選項仍難以區分的案例。
評分(score)問題使用由等級標籤組成的有序陣列。索引從 0 開始,回傳的分數是各等級索引乘以其機率後的總和,因此可能落在兩個具名等級之間。以嚴重程度量表為例,請定義外觀問題、有替代做法的問題與工作完全受阻三者之間的區別。結果包含等級圖例與各等級機率,以及期望分數。請保留帶小數的分數,用於計算平均或觀察趨勢;選出機率最高的等級與將期望分數四捨五入,回答的是不同的問題。
共用證據與解讀結果
開發商允許針對同一個狀態提出 1 到 512 個問題。請為每個問題指定非空白且有意義的識別碼,例如 category(類別)或 severity(嚴重程度),讓人不必查找編號問題就能理解對應的答案。請將彼此獨立的考量拆分為各自的問題,而不是把多項要求合併成一條含糊的判斷準則。一則訊息即可同時支援類別選擇、嚴重程度評分與條件檢查,且每一項都保有各自的意義。
選擇與評分答案除了機率分布外,還會另外提供信心值。開發商明確區分信心值與最高選項機率,請勿由其中一者推算另一者。對於是非決策,請將原始機率與所選結果一併保存。若選擇結果不確定,請檢視相互競爭的各項機率,而不是單憑勝出的標籤就認定結果確定。請依據誤判為正向或負向結果所造成的後果來定義審查門檻值,並使用具代表性的已標註案例加以評估。
版本與大小上限
Drex 1.5 的文件載明,狀態額度為 131,072 個 token,資料列額度為 139,264 個 token。資料列額度指的是狀態加上最長的單一問題(包括其指令與選項),而不是請求中所有問題的總和。序列化後的狀態與問題合計也必須在 1,048,576 個 UTF-8 位元組以內。一個請求可能符合位元組上限,卻仍超出 token 上限。較舊的 1.0 版本另外列出狀態與資料列皆為 32,768 個 token,因此不應將其上限沿用到 1.5。
Nace 在文件中將 drex-v1.5 列為帶有版本號的開發商識別碼,而 drex-latest 則是會隨版本變動的別名。當工作流程依賴特定版本的上限時,請明確指定目標版本。格式錯誤的問題、缺少狀態或輸入過大,都屬於驗證問題,需要修正輸入,而不是更改類別或猜測答案。請圍繞可觀察的證據準備判斷準則,並將具型別的結果、原始事實與問題定義一併保存。如此一來,決策即可用於分流、優先順序排定或審查,而不會把機率誤認為確定的判決。
Ailoot Ultra · System One POST /v1/systemone nace-ai/drex-v1.5
nace-ai/drex-v1.5入門
Drex 1.5 會依據具型別的問題評估所提供的文字或 JSON,並回傳機率、選定的標籤或帶小數的評分準則分數。Nace.AI 的文件說明它僅處理文字決策,適用於分類、分流與優先順序排定,並依版本設有不同的狀態與請求上限。
- 接受的輸入
- 文字
- 結果
- decisions
Ailoot 可用 · 輸入與方法
Ailoot Ultra · System One POST /v1/systemone
- 輸入
text- 輸出
decisions- 輸出格式
- json
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 nace-ai/drex-v1.5 | 預設值— |
欄位provider | 類型schema | 要求選填 | 值與限制 | 預設值— |
欄位questions | 類型object | 要求必填 | 值與限制 | 預設值— |
欄位session_id | 類型string | 要求選填 | 值與限制 | 預設值— |
欄位state | 類型schema | 要求必填 | 值與限制 | 預設值— |
欄位trace | 類型schema | 要求選填 | 值與限制 | 預設值— |
欄位user | 類型string | 要求選填 | 值與限制 | 預設值— |
欄位questions.<id>.type | 類型string | 要求必填 | 值與限制 noul, choice, score | 預設值— |
欄位questions.<id>.instructions | 類型string|object|array | 要求必填 | 值與限制 | 預設值— |
欄位questions.<id>.criteria | 類型object|array | 要求選填 | 值與限制 條件: choice/score:必填;noul:選填。choice 的條件為物件;score 為陣列,並要求 minItems1。 | 預設值— |
欄位questions.<id>.criteria.true | 類型string|object|array | 要求必填 | 值與限制 適用條件: 已提供 noul criteria 物件 | 預設值— |
欄位questions.<id>.criteria.false | 類型string|object|array | 要求必填 | 值與限制 適用條件: 已提供 noul criteria 物件 | 預設值— |
輸入素材組合
noul · 必填: state, questions.<id>.type=noul, questions.<id>.instructions
choice · 必填: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · 必填: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, state, questions |
參數material_types | 規格text |
參數optional_controls | 規格provider, session_id, trace, user |
參數multimodal_input_binding | 規格null |
生命週期: synchronous
請傳送完全相符的模型 ID,並保留完整的原生回應。
方案
費率資訊不會增加請求選項。支援的參數列於所選方法中。
- 快速模式
- 未指定 選取快速模式時
- flex 模式
- 未指定 選取 flex 模式時
- 最高推理強度
- 未指定 最高推理強度採用 default 調整值時
Ailoot 費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 上下文 Token 數大於 | 上下文 Token 數小於或等於 | 費用 |
|---|---|---|---|---|
| 設定詞元基本費率 | 費率表基本費率 | 上下文 Token 數大於— | 上下文 Token 數小於或等於無上限 | 費用 輸入 · 輸入 Token $0.00008 / 1K Token 輸出 · 輸出 Token $0 / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取,1 小時 — / 1K Token |
| 設定請求長度級距 1 | 費率表— | 上下文 Token 數大於0 | 上下文 Token 數小於或等於無上限 | 費用 輸入 · 輸入 Token $0.00008 / 1K Token 輸出 · 輸出 Token $0 / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取,1 小時 — / 1K Token |
Ailoot 會在請求前預留估算金額。取得結果後,依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot Ultra · System One
{
"model": "nace-ai/drex-v1.5",
"questions": {
"is_bug": {
"criteria": {
"false": "The customer is asking a question or requesting a feature.",
"true": "The customer describes broken or unexpected product behavior."
},
"instructions": "Is the customer reporting a software defect?",
"type": "noul"
},
"team": {
"criteria": {
"account": "Login, permissions, or profile issues.",
"frontend": "Rendering, layout, or browser compatibility issues.",
"payments": "Checkout, billing, or payment processing issues."
},
"instructions": "Which team should own this ticket?",
"type": "choice"
},
"urgency": {
"criteria": [
"Can wait for the next release",
"Should be fixed this week",
"Blocking revenue right now"
],
"instructions": "How urgent is this ticket?",
"type": "score"
}
},
"state": {
"customer_tier": "enterprise",
"ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='nace-ai/drex-v1.5'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
接收並儲存結果
Ailoot Ultra · System One
json
保留所有已完成的結果
請保留所有完整傳回的回應、檔案與內容區塊。
會保留每個已提供的問題 ID 答案,包括其確切型別、noul/choice/score 值、信心值、機率與圖例。完整的原始 JSON 會先儲存,並僅在結算後回傳。
需要檢查原始回應時
請保留原始操作與完整/部分回覆;切勿重送 POST。
回應欄位
| 欄位 | 類型 |
|---|---|
欄位model | 類型string |
欄位id | 類型string |
欄位provider | 類型string |
欄位answers.<id>.type | 類型string |
欄位answers.<id>.noul | 類型number |
欄位answers.<id>.choice | 類型string |
欄位answers.<id>.score | 類型number |
欄位answers.<id>.confidence | 類型number |
欄位answers.<id>.probabilities | 類型object |
欄位answers.<id>.legend | 類型object |
欄位usage.input_tokens | 類型integer |
欄位usage.output_tokens | 類型integer |
欄位usage.cost | 類型number |
錯誤與後續步驟
| 回應 | 條件 | 下一步 |
|---|---|---|
回應400 · invalid_request_error | 條件必要欄位、表示方式或值無效 | 下一步請修正指出的請求欄位。 |
別名
模型別名
Ailoot Ultra nace-ai/drex-v1.5
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Nace.AI: Drex v1.5
- 可以使用哪些輸入與結果?
POST /v1/systemone·nace-ai/drex-v1.5:text→decisions- 請求使用哪些欄位?
POST /v1/systemone·nace-ai/drex-v1.5:model,provider,questions,session_id,state,trace,user