はじめに

新しい商品の価格を上げたり下げたりしたとき、買い手の反応はどう変わるのか。
市場調査に進む前に、こうした仮説を手軽に試したいと考えて「Japan Scale」というWebサービスを作りました。

1,000人の架空の住民が暮らす街で、価格や認知率を変えて反応を眺めたり、住民に話を聞いたりできます。
この記事では、サービスの目的と使い方を紹介したあと、判断用のAI「Jev」を街の行動とインタビューの2か所に使った点を説明します。
中心は、Jevをどこにどう組み込んだかです。Jev自体の仕組みや性能の解説ではありません。

Japan Scaleとは

Japan Scaleは、1,000人の架空の住民に商品企画の仮説をぶつけるシミュレーターです。
市場調査の代わりではなく、市場調査の前に問いを具体化するための道具です。

現在は検証版として、無償で公開しています。
ただし、Jev方式で使うAIの利用料金は、利用者ご自身のAPI契約に基づいて発生します。
今後はこの検証版をもとに住民データの量と精度を高め、企業向けのサービスとして提供する予定です。

できること

商品の価格と認知率を変え、住民ごとの反応（未認知、認知、興味、購入）を見比べる
地域、性別、職業、年齢、年収で住民を探し、1〜4人にテキストで質問する
あまり意味のない機能ですが…、全国8地域の架空の街（場所は計692か所）で、住民の時間割や動きを眺める

使い方は3ステップ

試したい条件を置きます。商品名、価格、認知率を設定します。
反応と住民を眺めます。反応の違いを確認し、気になる属性の住民を探します。
次の問いを持ち帰ります。インタビューや比較から、実際の調査で確かめる仮説を整理します。

ログインはGoogleアカウント、または確認済みのメールアドレスで行います。

Japan Scaleは、売上や市場規模を予測するツールではありません。

住民の氏名、属性、街の設定は、すべて架空のデータです。
反応は固定ルールによる試行です。実在の消費者調査ではありません。
統計的な代表性や予測精度は検証していません。
インタビューで表示される確信度は、正解率や購入確率を示す値ではありません。

既定はルール方式、Jevは選んだときだけ

Japan Scaleには2つの動かし方があります。
画面の表示とは次のように対応します。本文では、左側を「ルール方式」、右側を「Jev方式」と呼びます。

	ルール方式（既定）	Jev方式
街の画面の表示	JSON時間割	Jevが行動を判断
インタビュー画面の表示	ルールベース	Jev＆LLM
街の行動	JSONに保存した時間割どおり	Jevが行き先を判断
インタビューの方針	固定ルールで決まる	Jevが方針を判断
APIキー	不要	利用者自身のキーが必要
外部AIの呼び出し	なし	あり（明示的に選んだときだけ）

APIキーがなくても、街のシミュレーション、住民台帳、インタビューはルール方式で動きます。
Jevを使った実際の動きを見たい場合は、AI接続設定でTypeSafe（Jev）のAPIキーと、Azure OpenAIまたはOpenAIのAPIキーを登録してください。
登録後に方式を「Jev＆LLM」へ切り替えると、街の行動判断とインタビューの方針判定にJevが使われます。

登録したキーは暗号化して保存し、画面に再表示することはありません。

JevはTypeSafeが提供するSystem Oneモデルの1つで、選択肢から判断を選び、確信度を返す外部APIです。
詳しくはTypeSafeの公式ドキュメントを参照してください。
Japan Scaleは、この「選択肢から選ぶ」使い方に絞って呼んでいます。

Jevを使った2か所

街の住民の行動判断

1つ目は、街を歩く住民の行動です。
ルール方式では、住民はJSONの時間割のとおりに動きます。
Jev方式では、決まった動きではなく、その都度、次の行き先をJevが選びます。

街の画面で行動方式を切り替えます。「JSON時間割」と「Jevが行動を判断」のどちらかです。
Jevを選べるのは、必要なキーがそろっている場合だけです。

仕組みは次のとおりです。

判断の対象は、表示中の地域の住民です。街の時間で約1時間ごとに、判断をやり直します。
判断材料は、曜日、時刻、住民の属性、現在の行き先、時間割です。
選択肢は、その住民の自宅、職場、学校、時間割上の場所、よく行く場所のうち、その時刻に営業中のものです。
時間割は参考であり、必須ではありません。
Jevには、用事、食事、娯楽、仕事や学校、帰宅などから、もっともらしいものを選ぶよう指示しています。
偏った推定を避ける指示も入れています。性別だけで好みや行動を決めつけない、年齢だけで病気や通院を推定しない、というものです。

Workerが送る指示の一部を、ソースの英文のまま抜粋します。

worker/behavior.js

instructions: `Choose the next destination for state.residents.${key} only. …略…
The schedule is context, not mandatory: choose plausible errands, food, recreation, work/study or home.
Only listed open destinations are valid. …略…
Do not infer preferences or restrict activities solely from gender.
Do not assume illness or a medical need solely from age.`,

判断が切れた住民は、1回のリクエストに24人ずつまとめ、2本を並行して処理します。
表示地域の人数は、最大で関東の345人ほどです。

Jevの行き先がまだ決まっていない住民は、時間割で動きます。
再判断を待つ間は、前回の行き先が営業中であれば、それを使い続けます。
接続に失敗したときは、画面に通知して時間割の方式へ戻ります。

Jevの回答は、そのまま信用せずに検証しています。
候補にない行き先や、0〜1の範囲外の確信度が返ってきた場合は、エラーとして扱い、反映しません。

インタビューで答える方針の判定

2つ目は、インタビューです。
住民に質問すると、住民は一人称で答えます。この回答の方針を、Jevが決めます。

方針は5種類です。

worker/api.js

const criteria = {
  positive: '前向きに受け止め、関心や期待を話す',
  cautious: '条件や懸念を確認し、慎重に答える',
  negative: '自分に合わない理由や困りごとを率直に話す',
  neutral: '日常の経験や考えを中立的に説明する',
  uncertain: '情報不足のため、分からない点や確認したい点を話す',
};

Jevには、住民の属性と商品、街で計算した反応、これまでの発言を渡します。
そのうえで、5つの方針から1つの選択と、0〜1の確信度を返してもらいます。
確信度が0.35未満のときは、方針を「情報不足」に倒します。

指示には、街で計算した決定的な反応（未認知、認知、興味、購入）と、過去の発言を尊重するよう入れています。

役割は分担しています。

方針の判断はJev
回答の文章化はLLM（Azure OpenAIまたはOpenAI）

Jevが選んだ方針と反応をLLMに渡し、LLMがその方針に沿った一人称の回答を書きます。
画面には、方式、方針、確信度、マップの判定を表示します。
確信度は、正解率や購入確率ではありません。

インタビューでJevやLLMへの接続が失敗したときは、エラーを表示します。自動でルール方式の回答に切り替わることはありません。

全体のアーキテクチャ

全体は、ブラウザ、Cloudflare上のWorker、外部のAIの3層で構成しています。

各層の役割は次のとおりです。

ブラウザは、街の描画と操作を担当します。住民の動きや反応の集計は、ブラウザ側で計算して表示します。
Workerは、画面の配信とAPIを1つにまとめています。住民データの読み出し、利用者の設定、行動判断、インタビューを受け持ちます。
D1には、住民1,000人と街の場所のデータ、利用者ごとの設定を保存しています。
ログインはFirebase Authenticationに任せています。データの読み出し、設定、行動判断、インタビューのAPIは、ログイン済みの利用者からの要求だけを受け付けます。
外部のAIは、Jev方式を選んだときだけWorkerから呼び出します。ルール方式では、外部のAIへの呼び出しは発生しません。
判断はJev、文章はLLMという分担にしています。街の行動判断はJevだけで完結し、インタビューではJevの判断をもとにLLMが回答文を作ります。
マップの反応計算は、ブラウザとWorkerで同じ関数を使い、画面とインタビューで結果がずれないようにしています。

まとめ

Japan Scaleは、1,000人の架空の住民で、商品企画の仮説を市場調査の前に試すサービスです。
反応は固定ルールの試行であり、売上予測ではありません。

Jevは2か所に使っています。

街の住民の行動判断。時間割を参考に、営業中の候補から次の行き先を選びます。
インタビューでの回答方針の判定。5つの方針から1つを選び、確信度を返します。

どちらも、利用者が自分のキーを登録して「Jev＆LLM」を選んだときだけ動きます。キーがなくても、街のシミュレーション、住民台帳、インタビューはルール方式で試せます。