Nace.AI: Drex v1.5
Drex 1.5 は、与えられたテキストまたは JSON を型付きの質問に照らして評価し、確率、選ばれたラベル、または小数値のルーブリックスコアを返します。Nace.AI は、分類、ルーティング、優先順位付けのためのテキスト専用の意思決定を、バージョンごとの状態とリクエストの上限とともに文書化しています。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Drex 1.5 は、Nace.AI のテキスト意思決定モデルです。与えられた事実をクローズドな質問に照らして評価し、自由形式の文章ではなく、数値で型付けされた回答を返します。リクエストは 1 つの状態と名前付きの質問を組み合わせたもので、結果では各回答が同じ質問名で識別されます。これによりワークフローは、具体的なカテゴリ、確率、ルーブリック上の位置を受け取れ、その結果に基づくアクションはアプリケーションに委ねられます。
状態を準備する
状態とは、すべての質問が対象とする情報です。Drex は JSON の文字列、オブジェクト、配列、数値、ブール値、null を受け付け、state フィールドは必須です。null も提供元の検証を通過しますが、意味のある根拠を与えます。文字列はメッセージ、文書、書き起こしに、オブジェクトはすでにフィールドに整理された事実に適しています。意思決定に影響する情報は残し、資料が長い場合は無関係なフィールドを省きます。表現を変えると回答が変わり得るため、確率のしきい値を解釈する際は入力フォーマットを一定に保ちます。
Drex 1.5 が読み取るのはテキストのみです。ドキュメントに記載されたインターフェースは、状態と質問のいずれに含まれる画像、音声、動画、PDF のコンテンツも拒否し、エンコード済みのメディアやメディアコンテンツのオブジェクトもその対象になります。そうした資料を根拠として使う前に、キャプション、認識済みの文書テキスト、書き起こしを用意します。テキストで書かれたアドレスは取得済みの文書や画像ではなく、モデルはそれを開けません。サポートリクエストの場合、有用な状態とは実際のメッセージと関連するコンテキストであり、モデルが受け取っていない資料への参照ではありません。
はい/いいえの確率、選択、スコア
noul 質問は、ある条件が成り立つかどうかを問い、「はい」の推定確率を表す 0 から 1 の数値を返します。質問は、空でない指示、または空でない真/偽の基準を少なくとも 1 つ使って定義します。たとえば、メッセージが機能の故障を報告しているかを問い、動作が遅いことを故障に含めるかどうかを定義します。Drex には組み込みのはい/いいえのしきい値はなく、確率の解釈方法は利用側のワークフローが決めます。
choice 質問は、順序のない集合から与えたラベルを 1 つ選び、すべてのラベルについて確率を返します。基準はオブジェクトで、そのキーが返されるラベルになり、各説明は文字列または null です。短く安定したキーを使い、カテゴリの境界を明確に記述します。ルーティングタスクの例では、アクセスの問題、製品の不具合、一般的な質問を区別し、どれにも当てはまらないメッセージのために「その他」カテゴリを設けることができます。選ばれたラベルはルーティングに役立ち、分布は 2 つの選択肢の区別が難しいままのケースを見つけるのに役立ちます。
score 質問は、レベルラベルの順序付き配列を使います。インデックスは 0 から始まり、返されるスコアは各レベルのインデックスにその確率を掛けた値の合計です。そのため、名前の付いたレベルの中間の値になることがあります。深刻度のスケールであれば、見た目だけの問題、回避策のある問題、作業が完全に止まる問題を分ける基準を定義します。結果には、期待スコアに加えてレベルの凡例と確率が含まれます。小数のスコアは平均や傾向の把握に使います。最も確率の高いレベルを選ぶことと期待スコアを丸めることは、異なる問いへの答えです。
共通の根拠と結果の読み方
提供元は、同じ状態について 1~512 個の質問を許可しています。各質問には category や severity のような空でない意味のある識別子を付け、番号付きの質問を調べなくても対応する回答を理解できるようにします。複数の要件を 1 つの曖昧な基準にまとめず、独立した関心事はそれぞれ別の質問に分けます。1 つのメッセージから、カテゴリの選択、深刻度のスコア、条件のチェックを得ることができ、それぞれが固有の意味を保ちます。
choice と score の回答には、確率分布とは別に信頼度が含まれます。提供元は信頼度と最も高い選択肢の確率を明確に区別しているため、一方から他方を計算しないでください。はい/いいえの判定では、選ばれた結果とともに生の確率を保持します。不確かな選択では、勝ったラベルだけを確実性の根拠とみなさず、競合する確率を確認します。レビューのしきい値は、誤った陽性または陰性の結果がもたらす影響を踏まえて定義し、代表的なラベル付きケースで評価します。
バージョンとサイズの上限
Drex 1.5 のドキュメントでは、状態の上限は 131,072 トークン、行の上限は 139,264 トークンとされています。行の上限は、状態に、指示と選択肢を含む最も長い単一の質問を加えたものに適用され、リクエスト内の全質問の合計ではありません。シリアライズされた状態と質問の合計も、1,048,576 UTF-8 バイト以内に収める必要があります。バイト数の上限を満たしていても、トークン数の上限を超えることがあります。旧版の 1.0 エディションでは、状態と行のどちらにも 32,768 トークンという別の上限が記載されているため、その上限を 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のcriteriaはオブジェクト、scoreはminItems1の配列です。 | デフォルト— |
フィールドquestions.<id>.criteria.true | 種類string|object|array | 要件必須 | 値と制限 適用条件: noul の条件オブジェクトが指定されている | デフォルト— |
フィールドquestions.<id>.criteria.false | 種類string|object|array | 要件必須 | 値と制限 適用条件: noul の条件オブジェクトが指定されている | デフォルト— |
入力素材の組み合わせ
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の料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | コンテキストトークン数が次の値を超える場合 | コンテキストトークン数が次の値以下の場合 | 料金 |
|---|---|---|---|---|
| 設定トークンの基本単価 | 料金表基本料金 | コンテキストトークン数が次の値を超える場合— | コンテキストトークン数が次の値以下の場合上限なし | 料金 入力 · 入力トークン $0.00008 / 1K トークン 出力 · 出力トークン $0 / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
| 設定リクエスト長に応じた料金区分 1 | 料金表— | コンテキストトークン数が次の値を超える場合0 | コンテキストトークン数が次の値以下の場合上限なし | 料金 入力 · 入力トークン $0.00008 / 1K トークン 出力 · 出力トークン $0 / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
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
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用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