LiquidAI: d1
Liquid AI d1 のテキスト意思決定ワークフローは、与えられた根拠を固定された結果に照らして評価し、確率、カテゴリの選択、またはルーブリックスコアを返します。文章による回答を生成することなく、分類、ルーティング、関連性フィルタリング、優先順位付けに対応します。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
d1 は、範囲の限定された分類、ルーティング、スコアリングのタスク向けに Liquid AI がホストする意思決定モデルです。このプロファイルはテキストの意思決定ワークフローを対象とします。根拠を状態として与え、1 つ以上の質問を定義すると、既知の結果に対する型付きの数値回答を受け取れます。Liquid はこれらの意思決定を、生成される出力トークンがゼロで、確率を直接返す評価と説明しています。有用な結果は、新たに書き起こされた文章ではなく、定義された意思決定とその不確実性です。
根拠と質問をあわせて準備する
意思決定を可能にするテキストを、その解釈に必要なコンテキストも含めて与えます。状態は、何を評価するかを記述した指示とは分けておきます。サポートメッセージには製品や問題の説明が、文書の一節にはユーザーの検索クエリが必要になる場合があります。質問をする前に回答の集合を定義し、すべての選択肢に想定するワークフローに合った意味を持たせます。短いラベルは安定した出力キーとして機能し、説明がそれらの境界を明確にします。
共通の状態に対して、名前付きの質問を使います。intent、urgency、relevant のような明確な名前を付けると、出力とそれが表す意思決定との対応が保たれます。たとえば、ページが動作しないと報告するメッセージからは、意図の選択、緊急度のルーブリック、不具合が報告されているかどうかのはい/いいえのチェックを得られます。3 つの判断を 1 つの曖昧なラベルにまとめず、各質問がそれぞれの基準を保つようにします。
カテゴリ分けとルーティングには choice
choice 質問は、順序のない集合からラベルを 1 つ選び、名前付きの選択肢全体にわたる分布を返します。選択肢は基準の説明で定義し、結果には選ばれた選択肢、確率、信頼度が含まれます。文書の整理では、候補となるフォルダーやテーマを定義し、それぞれにどのような内容が属するかを記述します。リクエストのルーティングでは、実際に存在する振り分け先を記述します。アプリケーションは得られたラベルで次のステップを選びつつ、競合する確率をレビュー用に保持できます。
振り分けタスクの例では、製品に関する質問、連携の問題、アクセスの問題を区別し、これらの定義に当てはまらない資料のために「その他」の選択肢を設けることができます。境界は具体的にします。認証できないというメッセージと、機能の設定方法を尋ねるメッセージは別物です。返されるラベルは与えた意味の中から選ぶものであり、存在しない振り分け先を作ったり、他のシステムで変更を実行したりはしません。
条件チェックと関連性判定には noul
noul 質問は、定義されたはい/いいえの条件が成り立つ確率を 0 から 1 で返します。Liquid は、コンテンツの審査や文章の関連性判定での二値チェックを例示しています。条件を正確に記述し、得られた確率の使い方を決めます。一致の可能性が高いものにフラグを付ける、文章を絞り込む、不確かなケースをレビューに回すといった使い方があります。しきい値は利用側のタスクが決めるものであり、確率を事実についての保証された判定として扱うべきではありません。
関連性のフィルタリングでは、クエリと候補の文章の両方を与えます。その文章がクエリへの回答に役立つかを問い、元の文章をその確率とともに保持します。これにより、d1 に回答そのものを書かせることなく、後の回答に使う資料を選べます。関連性をはい/いいえの条件ではなく複数の段階で表す必要がある場合は、順序付きのルーブリックを定義し、score 質問を使います。
順序付きのレベルには score
score 質問は、説明付きの順序付きレベルを持つルーブリック上に状態を位置付けます。レベルのインデックスは 0 から始まり、スコアは確率で重み付けした位置であり、レベルの中間になることがあります。結果にはレベルの分布と信頼度も含まれます。緊急度であれば、すぐには影響のない問題、相応の不便がある問題、作業が止まる問題を分ける基準を定義します。したがって 4 段階のルーブリックのインデックスは 0~3 であり、その期待スコアがそのまま 1~4 の番号付きカテゴリになるわけではありません。
並べ替えや集計が目的であれば小数のスコアを使い、曖昧さが重要な場合は分布の全体を保持します。部署のようなカテゴリには自然な順序がないため、choice 質問で扱います。信頼度は、ドキュメントに記載されたインターフェースにおいて、報告された回答がどれだけ明確かを要約したものです。タスクで求めるスコアとも、意思決定が正しいという想定上の保証とも区別しておきます。
複数の質問と提供元の活用例
1 回の提供元呼び出しで、複数の質問が同じ状態を評価でき、それぞれが固有の型と確率を保ちます。Liquid のテキストの例には、サポートチケットのフィルタリング、フォルダー分類体系への文書の振り分け、コード検索のパスの選択、利用可能なエージェントアクションからの選択、ツール出力のうち保持する資料の決定が含まれます。これらのワークフローはいずれも、次に行う意思決定が限定されています。コード検索のステップでは説明をもとに有望なフォルダーを選べ、コンテンツ選択のステップでは与えた資料について保持、削減、破棄のいずれかを選べます。元データの取得と選ばれた操作の実行は、引き続き周囲のアプリケーションが担います。
適用範囲と有用な意思決定成果物
ドキュメントに記載されたプリミティブは、既知の結果、ルーブリック評価、条件チェックに適しています。新しい文章、要約、コード、自由形式の会話には生成ワークフローが必要であり、d1 の意思決定結果から得られるものではありません。質問は観測可能な根拠に基づいて用意し、その質問の定義を出力とともに保持して、ラベルやスコアを後から解釈できるようにします。
各状態は、定義した質問に答えるための根拠に絞り、無関係な意思決定タスクは分けて、それぞれの基準が明確なままになるようにします。資料は関連するものに限定し、カテゴリで網羅しきれない場合に備えてフォールバックの意味を定義し、確率のしきい値はタスクのラベル付き例を使って評価します。有用な成果物には、選ばれたカテゴリまたは期待スコアが、その分布、質問の識別情報、元の根拠とともに記録されます。
Ailoot Ultra · System One POST /v1/systemone liquid/d1
liquid/d1はじめに
Liquid AI d1 のテキスト意思決定ワークフローは、与えられた根拠を固定された結果に照らして評価し、確率、カテゴリの選択、またはルーブリックスコアを返します。文章による回答を生成することなく、分類、ルーティング、関連性フィルタリング、優先順位付けに対応します。
- 対応する入力
- テキスト
- 結果
- decisions
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · System One POST /v1/systemone
- 入力の種類
text- 出力の種類
decisions- 出力形式
- json
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 liquid/d1 | デフォルト— |
フィールド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 トークン 入力 · キャッシュ読み取り $0.00008 / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
| 設定リクエスト長に応じた料金区分 1 | 料金表— | コンテキストトークン数が次の値を超える場合0 | コンテキストトークン数が次の値以下の場合上限なし | 料金 入力 · 入力トークン $0.00008 / 1K トークン 出力 · 出力トークン $0 / 1K トークン 入力 · キャッシュ読み取り $0.00008 / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · System One
{
"model": "liquid/d1",
"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']='liquid/d1'
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 liquid/d1
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · LiquidAI: d1
- 利用できる入力と結果は何ですか?
POST /v1/systemone·liquid/d1:text→decisions- リクエストはどの項目を使用しますか?
POST /v1/systemone·liquid/d1:model,provider,questions,session_id,state,trace,user