Jev — 意思決定モデル

認証

• Authorizationheader必須

  Ailootキーの形式：Bearer sk-…。

リクエストボディ

• modelstring必須

  jev-latest。

• statestring | object | array必須

  評価対象。テキストの文字列またはJSONで、顧客からの問い合わせ、データベースのレコード、やり取り、アプリケーションの現在の状態などを渡します。通常は、一つの文字列より、意味が分かるフィールド名を持つオブジェクトの方が扱いやすくなります。

• questionsobject必須

  質問。キーは自由に指定でき、同じキーで回答が返ります。キーは回答内容に影響しません。質問自体を指定するフィールドは instructions。

• questions.*.typestring必須

  noul, choice または score 。以下を参照してください。

• questions.*.instructionsstring | object | array必須

  質問そのもの。データを含む長い質問は、質問を一つのフィールドに、データを他のフィールドに入れたオブジェクトとして渡せます。フィールドを参照する際は、名前をバッククォートで囲んでください。

• questions.*.criteriaobject | array

  回答の選択肢。形式はタイプごとに異なります。noulでは「はい」と「いいえ」の説明（任意）、choiceでは選択肢の辞書、scoreでは順序付きの評価段階のリストです。

一つのリクエストで複数のタイプを組み合わせられます。

noul — はい／いいえ

フィールド criteria は任意です。「はい」（true）と「いいえ」（false）の意味を記述できます。レスポンスの noul は、0（いいえ）から1（はい）の数値です。

"is_urgent": {
  "type": "noul",
  "instructions": "緊急性が伝わる内容ですか？",
  "criteria": {
    "true": "時間的な切迫性が明示されている",
    "false": "緊急性が表明されていない"
  }
}

"is_urgent": {
  "type": "noul",
  "noul": 0.95
}

choice — 選択肢の選択

criteria は「選択肢 → 説明」の辞書です。説明が不要な場合は nullを指定してください。最大255の選択肢を指定できます。レスポンスの choice は最も確率の高い選択肢、 probabilities は各選択肢の確率（合計1）、 confidence は0から1の確信度です。

"department": {
  "type": "choice",
  "instructions": "どのチームが対応すべきですか？",
  "criteria": {
    "billing": "支払い、請求書発行、返金",
    "technical": "バグ、障害、連携",
    "sales": "価格設定、アップグレード、新規顧客"
  }
}

"department": {
  "type": "choice",
  "choice": "billing",
  "probabilities": { "billing": 0.88, "technical": 0.12, "sales": 0.0 },
  "confidence": 0.81
}

score — 尺度に基づく評価

criteria は低い段階から高い段階へ並べたリストで、最大10段階です（TypeSafeは二段階以上を推奨しています）。レスポンスの score は、各段階の確率で重み付けした値です（段階と段階の間の値になることもあります）。legend は段階の番号とその説明、 probabilitiesとconfidenceが返されます。TypeSafeによると、 score は閾値との比較に適していますが、段階の間の値を厳密な数値として扱う用途には適していません。

"frustration": {
  "type": "score",
  "instructions": "顧客はどの程度いら立っていますか？",
  "criteria": ["落ち着いている", "いら立っている", "非常に怒っている"]
}

"frustration": {
  "type": "score",
  "score": 1.05,
  "legend": { "0": "落ち着いている", "1": "いら立っている", "2": "非常に怒っている" },
  "probabilities": { "0": 0.0, "1": 0.95, "2": 0.05 },
  "confidence": 0.92
}

• modelstring

  回答したモデルのバージョン。エイリアスjev-latestは、将来、新しいバージョンを指すようになります。特定のバージョンに合わせて confidence の閾値を調整した場合は、このフィールドを確認してください。

• answersobject

  各質問に一つの回答が、指定したキーで返ります。すべての回答に typeがあり、choiceとscoreにはさらに confidence。

• usageobject

  input_tokensとoutput_tokensがあります。課金されるのは入力トークンのみです。

同じstateに関する質問は、一つのリクエストにまとめてください。並列に評価され、stateは一度だけ送信されます。TypeSafeの13問の例では、一括リクエストのコストは12,2分の一、処理は10倍高速でした。比較対象は13回の個別リクエストを順に送った場合で、回答は同じでした。

複雑な判断は単純な質問に分解し、コードで回答を組み合わせると扱いやすくなります。たとえば「応募内容を評価」ではなく、市場、実現可能性、競合との差異を個別に評価します。重みは質問文ではなく、コードで変更できます。

{
  "model": "jev-latest",
  "state": "助けてください！ 3日間、私への払い出しが失敗し続けています。",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "どのチームが対応すべきですか？",
      "criteria": {
        "billing": "支払い、請求書発行、返金",
        "technical": "バグ、障害、連携",
        "sales": "価格設定、アップグレード、新規顧客"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "顧客はどの程度いら立っていますか？",
      "criteria": ["落ち着いている", "いら立っている", "非常に怒っている"]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "緊急性が伝わる内容ですか？"
    }
  }
}

• ルーティング。 問い合わせを適切な部署に、リクエストを適切な処理先に振り分けます。単純なコード、大規模モデル、人などが処理先になります。
• 並べ替えと優先順位。 緊急度、感情、リスクを尺度で評価し、コードに閾値を設定します。
• モデレーションと検証。 テキストを次の処理へ送る前に、メッセージがルールに違反していないか、引用を出典が裏付けているか、文書に質問への答えがあるかなどを確認します。
• スコアリングとランキング。 独自の評価基準で文書、候補者、検索した断片を評価し、次に使うものをコードで決定します。
• 不安定な「JSONを返して」という指示の代わりに。 解析が必要なテキストではなく、仕組み上、型付きの値を返す呼び出しです。

• チャット、ユーザーへの回答、テキストやコードの生成。 Jevはテキストを生成しません。その用途には テキストモデル。
• Claude Code、Cursorなどのエージェント用モデル。 エージェントのモデルをjev-latestに置き換えることはできません。エージェントには、テキストを生成してツールを呼び出すモデルが必要です。エージェントが書いたコードからJevを呼び出すことはできます。
• 算術、集計、日付の比較。 TypeSafeによると、こうした処理はコードで行う方が確実です。モデルには意味の判断だけを任せてください。たとえばchoiceで日付の構成要素を抽出します。
• 画像、音声、動画。 モデルが受け付けるのはテキストのみです。これらのデータは事前にテキストへ変換してください。

課金されるのは入力トークンのみです。参照するのはレスポンスのフィールド usage.input_tokens です。料金は $0.084／1百万トークン。出力トークンは無料です。

このページのリクエスト例（入力296トークン）の料金は$0.0001未満です。

リクエスト前にAilootが残高から金額を仮確保し、レスポンス後に実際の使用量に基づいて一度だけ残高から差し引きます。詳細：仕組み。

モデルの制限はTypeSafeの情報に基づきます。キーと残高の制限は、他のAilootモデルと同様に適用されます。詳細：エラーと制限。

エラーはAiloot API共通の形式で返されます。コード、分かりやすい説明、Request IDが含まれます。このメソッドでよく発生するエラー：

コードの一覧は次のページにあります：エラーと制限。