Jev (TypeSafe AI)

TypeSafe AI Jev で高速な構造化判定を行う

​

概要

Jev は TypeSafe AI の System One モデルです。文章を生成するのではなく、state を型付きの質問で評価し、較正済みの確率を返します。後続のステップは文章を解釈せず、数値でそのまま分岐できます。分類、ルーティング、ルーブリック採点、ガードレール判定に適しています。

​

主な機能

• TYPESAFE_JEV_EVALUATE
  • 1 回のリクエストで 1 つの state を複数の質問で評価
  • 3 種類の質問タイプ：
    • noul — Yes/No。答えが Yes である確率（0〜1）を noul として返す
    • choice — 選択肢から 1 つ選ぶ。criteria は選択肢 → 説明（または null）のマップ。choice、probabilities、confidence を返す
    • score — 順序付きレベルで採点。criteria は 2 つ以上のレベル説明の配列。score（レベルの中間値になりうる）、legend、probabilities、confidence を返す
  • state にはテキストまたは JSON オブジェクト／配列を指定可能
  • model のデフォルトは jev-latest。確信度のしきい値を調整している場合は jev-1.13.0 のようにバージョンを固定
  • レート制限（429）と過負荷（529）のレスポンスは自動でリトライ

​

認証

このツールはご自身の TypeSafe AI API キーが必要です。Jinba の API クレジットは利用できません。取得方法は TypeSafe AI クイックスタート を参照してください。

注意：API キーは機密情報として扱い、公開リポジトリにコミットしないでください。

​

制限

• テキストのみ対応。1 リクエストあたり 64k トークン（state と最長の質問の合計は 32k）まで
• 最も精度が高いのは英語です。日本語など他の言語では、回答を使う前に confidence を確認してください

​

例：サポートチケットのトリアージ

- id: triage
  tool: TYPESAFE_JEV_EVALUATE
  input:
    - name: state
      value: "Help! My payouts have been failing for 3 days."
    - name: questions
      value: |
        {
          "is_urgent": {
            "type": "noul",
            "instructions": "Does this convey urgency?"
          },
          "department": {
            "type": "choice",
            "instructions": "Which team should handle this?",
            "criteria": {
              "billing": "Payments, invoicing, refunds",
              "technical": "Bugs, outages, integrations",
              "sales": "Pricing, upgrades, new accounts"
            }
          },
          "frustration": {
            "type": "score",
            "instructions": "How frustrated is the customer?",
            "criteria": ["Calm", "Frustrated", "Very angry"]
          }
        }
  config:
    - name: api_key
      value: "{{secrets.TYPESAFE_API_KEY}}"

回答は同じ id で返ります。例：{{steps.triage.result.answers.department.choice}}、{{steps.triage.result.answers.is_urgent.noul}}。