Jev って、なに？

1. たとえ話：先生と採点係

プログラム（コード）が先生、Jev が採点係だと思ってください。

だから、ふつうのコードが苦手な「言葉の意味を読み取る」部分だけを Jev に任せて、残りはこれまでどおりコードで書けます。

2. 状況（state）：審査員に見せる資料

Jev に質問するときは、判断の材料もいっしょに渡します。これを状況（state）と呼びます。審査員の前に、判定に必要な資料を並べるイメージです。

{
  "customer_message": "届いた冷蔵庫のドアが閉まりません",
  "order": { "item": "冷蔵庫", "days_since": 3 },
  "refund_policy": "到着後14日以内なら返品可"
}

質問: `order.days_since` と
`refund_policy` を見て、
この返品は認められる？

• 質問ぜんぶが、同じ状況を見ます。各質問は互いの答えを見ずに、独立して判断します。だから 200 問でも、いっせいに並列で答えられます。
• 必要な情報は、状況に入れます。Jev は最新の事実を覚えていません。在庫・価格・規約などは、コードがデータベースから取って渡します。
• 渡せるのはテキストだけです。文字列・JSON・配列。画像や音声は（今のところ）渡せません。

どのアプリが、何を状況として渡しているかは、下の「5つのアプリ」で見られます。

3. 質問は3種類だけ

聞きたいことの答えの形で、使い分けます。タブを切り替えて、 どんな答えが返ってくるか見てみてください。

4. 実物のリクエストとレスポンス

ここまでの話を、そのままの形で見てみましょう。POST https://api.typesafe.ai/v1/systemoneに、状況（state）と質問（questions）を送ります（APIキーは Authorization: Bearer … ヘッダーで渡します）。

送るもの（リクエスト）

{
  "model": "jev-latest",
  "state": {
    "customer_message": "届いた冷蔵庫のドアが閉まりません。すぐに何とかしてください！",
    "order": {
      "item": "冷蔵庫",
      "days_since_delivery": 3
    },
    "refund_policy": "到着後14日以内なら返品できます"
  },
  "questions": {
    "category": {
      "type": "choice",
      "instructions": "`customer_message` は、どの種類の問い合わせか？",
      "criteria": {
        "repair": "壊れている・動かないので、修理や交換を求めている",
        "return": "商品を返品して返金してほしい",
        "other": "上のどれでもない"
      }
    },
    "refundable": {
      "type": "noul",
      "instructions": "`order.days_since_delivery` と `refund_policy` から見て、この注文は返品できる期間内か？"
    },
    "urgency": {
      "type": "score",
      "instructions": "`customer_message` から読み取れる、顧客の急ぎ具合は？",
      "criteria": [
        "急いでいない",
        "少し急いでいる",
        "かなり急いでいる",
        "今すぐ対応してほしい"
      ]
    }
  }
}

• stateは材料です。名前をつけた JSON で、お客さんの文章・注文・返品ルールを渡しています。
• questionsは質問の集まりです。category などの名前はコードが結果を受け取るための ID で、Jev には送られません。意味は instructionsに全部書きます。
• type が質問の種類です。choice は選択肢を criteriaに、score は段階の説明を配列で書きます。noul は instructionsだけで足ります。
• 質問の中の `order.days_since_delivery`のように、バッククォートで状況の場所を指しています。

返ってくるもの（レスポンス）

{
  "model": "jev-1.13.0",
  "answers": {
    "category": {
      "type": "choice",
      "choice": "repair",
      "confidence": 1.0,
      "probabilities": {
        "return": 0.0,
        "other": 0.0,
        "repair": 1.0
      }
    },
    "refundable": {
      "type": "noul",
      "noul": 0.97
    },
    "urgency": {
      "type": "score",
      "score": 2.99,
      "confidence": 0.99,
      "legend": {
        "0": "急いでいない",
        "1": "少し急いでいる",
        "2": "かなり急いでいる",
        "3": "今すぐ対応してほしい"
      },
      "probabilities": {
        "0": 0.0,
        "1": 0.0,
        "2": 0.0,
        "3": 1.0
      }
    }
  },
  "usage": {
    "input_tokens": 592,
    "output_tokens": 71
  }
}

• answers に、質問のID ごとの答えが入ります。3つの質問が、1回の呼び出しでまとめて返ってきました。
• choice は choice（選ばれたもの）と、選択肢ごとのprobabilities。noul は noul（当てはまる確率）だけ。 score は score（期待値）と、段階ごとの確率です。
• confidenceは、確率がどれだけ1つに集中しているかを表します。「迷っているか」の目安にして、 自信が低いものだけ人に回す、といった使い方ができます。
• usage は使ったトークン数。料金の目安になります。

これは実際に送って返ってきた結果です。わかりやすい例だったので、確率が 0 か 1 に寄っています。迷う内容なら、確率がばらけます。

5. Jev のとくちょう

• ⚡

  速い

  1回の呼び出しは、ふつう 0.2〜0.5 秒。画面の操作に組み込めます。

• 🧺

  まとめて聞ける

  同じ状況についての質問を、何十〜何百問でも1回でまとめて投げられます。いっせいに答えが返ります。

• 📊

  数字で返る

  答えは確率。しきい値を決めて分岐したり、足し算で並べたりと、コードでそのまま使えます。

速さは、このサンプルでの実測です（探してるものだけ表示で約0.25秒、Car Picker で約0.24秒、200問のパネルで約1.5秒）。

6. 候補がたくさんあるとき、どう聞く？

「商品が何十個」「料理が何百品」のように候補が多いときの聞き方は、おもに4つあります。 どれにも共通するのは、同じ状況に対する質問は、まとめて1回で聞くことです。質問が増えるのは、状況について知りたいことが増えたときで、候補の数に 合わせて増やすわけではありません。

• ① 依頼文から条件を取り出す

  質問は固定の数（車選びは30問）。候補との照合は、コードがデータに対して行います。ソラカー Car Picker

• ② 候補ごとに同じ質問を並べて、1リクエスト

  候補が短い文（商品のタイトル、料理名）のとき。共通の状況を state に入れ、候補は質問のほうに入れます。探してるものだけ表示今夜なに作る？

• ③ 全候補を1つの質問の選択肢にして絞る

  1つの質問に、255択まで置けます。確率が候補ごとに返るので、1回で順位が付きます。 選択肢の並びに偏ることがあるため、逆の並びでも聞いて平均します（公式のスキル提案の例）。

• ④ 絞ってから、候補ごとに詳しく聞く

  ③で数品に絞ってから、残った候補に、程度（score）や当てはまるか（noul）を聞きます。広く浅く、狭く深く、の二段構えです。

候補が長い文書（記事、問い合わせの全文）で、1つの state に入れきれないときは、候補ごとに1リクエストにします（公式の再ランキングの例）。

7. 5つのアプリで、どう使っている？

公式ドキュメントには、4つのパターンがあります。どのデモが、どのパターンを使っているかは、次のとおりです。

どのアプリも、同じ型で読めます。

やりたいこと → 渡す状況 → Jev に聞くこと → 流れ → コードがやること

{
  "ユーザーの状況": "疲れているので、ご飯が進む和食がいい",
  "あなたのタスク": "今夜の夜ご飯の献立（主菜）を決める"
}

{
  "candidate": "サバの味噌煮"
}

{
  "candidate": "親子丼"
}

{
  "candidate": "ぶり大根"
}

{
  "新規事業のアイデア": "使わなくなった楽器を、近所の子どもに月額で貸し出すサービス"
}

{
  "人物": {
    "名前": "ステーブン・ジョーブズ",
    "紹介": "パーソナルコンピュータとスマートフォンを世に広めた起業家。製品の美しさと、ハードとソフトを統合した体験を何よりも重視する…",
    "関心領域": [
      "プロダクトデザイン",
      "消費者向け製品",
      "垂直統合",
      "ブランド体験"
    ]
  }
}

{
  "人物": {
    "名前": "ステーブン・ジョーブズ",
    "紹介": "パーソナルコンピュータとスマートフォンを世に広めた起業家。製品の美しさと、ハードとソフトを統合した体験を何よりも重視する…"
  }
}

{
  "search_query": "ipad pro スマートキーボード"
}

{
  "candidate": {
    "title": "Apple Smart Keyboard(10.2インチiPad、10.5インチiPad Air、10.5インチiPad…"
  }
}

{
  "candidate": {
    "title": "ロジクール iPad Pro 12.9インチ対応 キーボード iK1272BKA ブラック バックライトキーボード付ケー…"
  }
}

{
  "candidate": {
    "title": "Apple Smart Keyboard Folio (11インチ iPad Pro 第1世代用) - 日本語"
  }
}

{
  "message": "イヤホンを返金してほしいです。あと、プレミアム会員も今月で解約したいです。",
  "customer": {
    "plan": "プレミアム会員（月額）",
    "orders": [
      {
        "id": "A-1001",
        "item": "ワイヤレスイヤホン",
        "status": "配達済み",
        "days_since_delivery": 6
      },
      {
        "id": "A-1002",
        "item": "モバイルバッテリー",
        "status": "発送済み（まだ届いていない）",
        "days_since_delivery": null
      }
    ]
  },
  "refund_policy": "到着後14日以内なら返品・返金できます"
}

{
  "request": "家族四人（小学生2人）で乗れるセダン、ボディカラーは赤で、自動ブレーキで止まるやつ"
}

8. 気をつけること

• 文章は作れません。返事・要約・説明は書けないので、それが必要なら別の LLM と組み合わせます。
• テキストだけです。画像や音声は（今のところ）渡せません。
• 確率は「全体として」当たります。たとえば「80%」と答えたもの100件のうち約80件が当たる、という意味です。1件1件が必ず合っている保証ではありません。自分のデータで確かめてから使いましょう。
• APIキーはサーバー側に置きます。ブラウザに渡すと誰でも見えてしまうので、このアプリも Route Handler の中でだけ使っています。

← トップへ戻る