初めての Jev（TypeSafe）マニュアル

チャットで文章を書く AI ではなく、分類・確率・スコアで判断するモデル。ウェイトリストからアカウント作成、API／AI Gateway 経由の使い方まで。

1. Jev とは

Jev は TypeSafe AI が出しているモデルで、入力（状態・文章・構造化データ）に対して、有限の選択肢ごとの確率やスコアを返すことに強い。

ChatGPT / Claude 系: 質問に文章で答える
Jev: 「不正 / 正常 / 要レビュー」などのラベル確率を高速・安価に返す、という位置づけ

文章の下書きや要約には向かない。ゲート判定・ルーティング・トリアージ向き。

公式の入口は TypeSafe。ウェイトリスト登録 → 招待メール → アカウント作成、という順が基本。

2. アクセスの流れ（実際のメール）

wirelessml@gmail.com 向けに届いた TypeSafe メールを基準にした手順。

ウェイトリスト登録
件名例: TypeSafe AI: You’re on the waitlist for Jev!
差出人: team@updates.typesafe.ai
内容: 「順番が来たら連絡する」／Discord 案内
アカウント準備完了
件名例: TypeSafe AI: Your account is ready
内容: 「You're in! Create your account…」
ログイン URL 例:
https://console.typesafe.ai/login
（ウェイトリスト紐づけ付きの場合あり）
Google ログイン通知（任意）
Google から typesafe.ai へのデータ共有通知が届くことがある。対応不要のことが多い。

メール内の Unsubscribe / Discord リンクはそのまま公式案内。フィッシングに注意し、差出人が @updates.typesafe.ai / Google 公式か確認すること。

3. TypeSafe コンソール

console.typesafe.ai を開く
招待メールの「Create your account」から進む（Google ログイン可）
API キーやプロジェクト設定をコンソールで確認する

コミュニティ: discord.gg/typesafe

4. Vercel AI Gateway 経由（実装向き）

アプリやエージェントから呼ぶなら、Vercel AI Gateway のモデル ID typesafe-ai/jev が扱いやすい。

Vercel で AI Gateway を有効化し、API キーを用意する
環境変数に AI_GATEWAY_API_KEY（または利用環境の公式名）を入れる
AI SDK（ai パッケージ）の experimental_evaluate で呼ぶ

プロモ期間や無料枠は変わるので、ダッシュボードの表示を正とする。

5. 呼び出しの型

典型は次の3つ。

type	用途	criteria
`boolean`	はい／いいえ（確率つき）	不要
`choice`	ラベル選択	非空の map（キー→説明）
`score`	順序つきルーブリック	順序つき配列

import { experimental_evaluate as evaluate } from 'ai';

const result = await evaluate({
  model: 'typesafe-ai/jev',
  state: {
    from: 'billing@example.com',
    subject: '請求書について',
    snippet: '支払期限が過ぎています…',
  },
  questions: {
    needs_action: {
      type: 'boolean',
      instructions: '返信・支払い・本人確認などユーザーの対応が必要か？',
    },
    category: {
      type: 'choice',
      instructions: '最も近いカテゴリを選べ。',
      criteria: {
        promo: '宣伝・ニュースレター',
        security: 'ログイン・アカウント・2FA',
        finance: '請求・決済・銀行',
        other: 'どれでもない',
      },
    },
    urgency: {
      type: 'score',
      instructions: '今日中に見るべき度合い',
      criteria: ['ignore', 'skim_later', 'handle_today'],
    },
  },
});

// result.answers.needs_action.probability
// result.answers.category.choice / .probabilities
// result.answers.urgency.score / .probabilities

state は短く。巨大 HTML 全文は避け、件名・差出人・抜粋など必要最小限に
質問は 1〜5 個程度が扱いやすい
しきい値（例: probability ≥ 0.7）は自分で決めてから自動化する
結果は API の返り値だけを信じ、推測で埋めない

6. 向きやすい用途

メール／チケットのトリアージ（要対応？／カテゴリ／緊急度）
請求書・申請の不正／正常／要レビューゲート
アップロードや PR のソフトゲート（通す／保留）
ブラウザ操作やエージェントの前段で、有限アクション集合から選ばせる
広告ブロックや UI 要素の「広告か本文か」など、二値・多値の高速判定

向かないもの: 長文ドラフト、創作、曖昧な相談の対話そのもの。

7. 注意・コスト感

公式・Gateway の価格表が正。目安として input は非常に安い帯（例: 約 $0.042 / 1M input tokens と言われることがある）だが、変更されうる
トークンを食うのは「長い説明文」ではなく「何度も評価する回数」側になりやすい。必要なゲートだけ呼ぶ
有限集合に落とせない問題は、先に LLM やスクリプトで候補を作ってから Jev に渡す、という分担が合いやすい
ウェイトリスト中はコンソール／API がまだ使えないことがある。メールの「account is ready」を待つ

8. リンク集

コンソール: console.typesafe.ai/login
Discord: discord.gg/typesafe
サイト: typesafe.ai
リンクハブ: links.wirelessml.workers.dev

本マニュアルは TypeSafe からの案内メール、公開情報、および AI Gateway 経由の実装パターンに基づく。製品仕様は公式の最新ドキュメントを優先すること。