Choice、Score、Noul

同じ state、別々の判断

1 回のリクエストに Choice、Score、Noul を混ぜられます。同じ state に対して、別々に、並行して判断されます。質問を足しても、質問どうしが文脈を共有するわけではありません。

Choice はリストから一つ選び、各選択肢の確率と confidence を返します。Score はルーブリックに沿って state を採点し、score、probabilities、confidence を返します。Noul は文が真かどうかを、0 から 1 の確率で答えます。Noul は別の confidence フィールドを付けません。

このサイトでリクエストを実行できます。Jev Playground がご自身の TypeSafe キーで https://api.typesafe.ai/v1/systemone に送り、実際の回答を表示します。

質問は一つに絞る

各質問は、狭い一事だけを聞くべきです。判断に複数の要因があるなら、要因ごとに質問を分け、結果は自分のコードで合わせます。

サポートチケットで考えると分かります。チケットが適切に処理されたか、とは聞きません。製品名があるか、返金を求めているか、文面が緊急か、を別々に聞きます。三つの答えをどう足すかはコードの仕事です。重みを変えるときは、質問文ではなくコードを変えます。

state と questions

公式の案内では、判断する材料は state、判断そのものは questions に置きます。質問 id はレスポンスのキーです。質問の全文は instructions に書きます。

求めるのは、適切な文脈があれば詳しい人がすぐに下せる判断です。「このメッセージは緊急さを伝えているか」は範囲内です。「分析して最善の行動を決めよ」は System 2 の問いなので、分割します。出典：TypeSafe primitives。

このハブが検証するホスト側リクエストは POST https://api.typesafe.ai/v1/systemone で、Bearer 認証を使い、JSON フィールドは model、state、questions です。コミュニティの断片にある mode フィールドは、公式の形ではありません。

Choice

閉じた集合から、名前のある選択肢を一つ選ぶ。公式ドキュメント：リストがすべての入力を覆えないなら other を足す。戻り値は choice、probabilities、confidence。

名前はあるが順序がない選択肢に Choice を使います。請求、技術、その他、のような分け方です。公式ドキュメントは、リストが不完全かもしれないときに other を勧めています。choice が選ばれた項目、probabilities が全項目、confidence はその分布がどれだけ尖っているかの要約です。

出典：Choice primitive。

Score

自分で定義した順序つきレベルに state を置きます。返る点数は、二つのレベルの間に落ちることがあります。戻り値は score、legend、probabilities、confidence。

レベルは順序があり、0 から番号が付きます。説明が三つなら、点数は 0 から 2 です。返る点数はレベルの間に来ることがあります。しきい値はプロンプトではなく、アプリケーションのコードに置きます。legend はレベルを番号で繰り返します。

出典：Score primitive。

Noul

はい／いいえの質問です。信号は確率そのもので、別の confidence フィールドはありません。戻り値は noul（0 から 1 の確率）。

1 に近ければ強いはい、0 に近ければ強いいいえ、0.5 付近は不確かです。任意の true／false 基準で、何を成り立つと数えるか書けます。Noul の回答に、別の confidence フィールドはありません。

出典：Noul primitive。

このハブが主張しないこと

JEV Hub は確率を作らず、コミュニティの playground のフィールドを公式とは扱いません。Playground の回答は TypeSafe からそのまま返ります。受け付けるモデル id は公式に記載されたもの（jev-latest、jev-preview、jev-1.13.0 のようなバージョン付き id）です。しきい値を調整したらバージョンを固定してください。

続きは Jev Playground、Jev MCP サーバー、ワークフローガイド へ。