RAG 01 · 資料の小部屋 · 再現ノート
資料の小部屋：全10ステージの再現ノート
遊んだステージと同じ資料・操作を使い、なぜ証拠が十分か、不十分かを確かめます。
このノートは基礎ゲーム「資料の小部屋」（中国語）の10ステージに対応しています。 ステージ1を開く →
いまできること
各ステージの「操作手順と結果を見る」を開くと、質問、候補の順序、各操作、証拠の判定（不適切／追加が必要／十分）、最後の返信まで読めます。インストールは不要です。
自分の RAG プロジェクトがあるなら
同じ方法で再現できます。少数の質問と資料を用意し、候補の順序を固定し、渡した証拠を一歩ずつ記録して、同じ三段階で判定します。
このサイトのソース
サイトのソース（ゲームのルールと記録を生成するスクリプトを含む）はまだ公開しておらず、ダウンロード先もありません。下のコマンドは作者のリポジトリでのみ動きます。
この記録はビルド時にゲームのルールを実行して生成します。資料、単語の重み、候補リスト、返信は手作りの教材です。リアルタイムのモデル回答でも、旧ミルクティー助手のベクトル検索記録でもありません。
ゲームと照合できるよう、操作名と資料は元の中国語を残しています。ページ下部で概念の三言語対応を確認できます。
01 必要な一枚を見つける
このステージを開く →操作手順と結果を見る
第1問 · 顧客の質問
几点开门？
查看「营业时间」，拿起并交给顾客
营业时间 — 上午九点开门。
証拠が十分
最終的に渡した証拠
- 营业时间：上午九点开门。
教材の返信／顧客の反応（事前作成）
九点开门，好的，明早见！
このステージの記録を生成するコマンド（作者のリポジトリでのみ実行できます）：
npm run experiment:rag -- --level 102 複数の資料から選ぶ
このステージを開く →操作手順と結果を見る
第1問 · 顧客の質問
周几休息？
先试「饮品价格」，观察为什么不够
饮品价格 — 珍珠奶茶 15 元，杨枝甘露 18 元，加料 2 元。
証拠が不適切 · 这页是价格，我想知道哪天休息。
改选「营业安排」，交给顾客
营业安排 — 周一至周六营业，周日休息。
証拠が十分
最終的に渡した証拠
- 营业安排：周一至周六营业，周日休息。
教材の返信／顧客の反応（事前作成）
周日休息，记住了。
このステージの記録を生成するコマンド（作者のリポジトリでのみ実行できます）：
npm run experiment:rag -- --level 203 言い換えられた質問
このステージを開く →操作手順と結果を見る
第1問 · 顧客の質問
周日能来买奶茶吗？
先试含有“奶茶”字样的价格页
饮品价格 — 珍珠奶茶 15 元，杨枝甘露 18 元，加料 2 元。
証拠が不適切 · 这页是奶茶价格。我不是问多少钱，是问周日能不能来。
改选能说明周日是否营业的资料
营业安排 — 周一至周六营业，周日休息。
証拠が十分
最終的に渡した証拠
- 营业安排：周一至周六营业，周日休息。
教材の返信／顧客の反応（事前作成）
周日不开门啊，知道了，我周六来。
このステージの記録を生成するコマンド（作者のリポジトリでのみ実行できます）：
npm run experiment:rag -- --level 304 LLM に返信を書いてもらう
このステージを開く →操作手順と結果を見る
第1問 · 顧客の質問
我周六九点半来，开门了吗？
取收件窗口的问题，交给 LLM 写信台
查看「营业时间」，拿起并交给写信台；取回信后交给顾客
营业时间 — 平日九点开门；周末十点开门。
証拠が十分
最終的に渡した証拠
- 营业时间：平日九点开门；周末十点开门。
教材の返信／顧客の反応（事前作成）
还没开门。周六属于周末，10点开门。
このステージの記録を生成するコマンド（作者のリポジトリでのみ実行できます）：
npm run experiment:rag -- --level 405 候補の順序を変える
このステージを開く →操作手順と結果を見る
第1問 · 顧客の質問
珍珠奶茶多少钱？
先取默认第一张「新品宣传」，交给写信台
現在の候補順：新品宣传 → 活动海报 → 制作说明 → 饮品价格表
新品宣传 — 新品芋泥波波上市！老顾客买珍珠奶茶，第二杯半价。
証拠が不適切 · 这些资料没有提供价格：这页讲新品上市和第二杯半价，没写珍珠奶茶本身多少钱。
回到检索台，把「饮品价格表」上移一位
現在の候補順：新品宣传 → 活动海报 → 饮品价格表 → 制作说明
回到检索台，把「饮品价格表」上移一位
現在の候補順：新品宣传 → 饮品价格表 → 活动海报 → 制作说明
回到检索台，把「饮品价格表」上移一位
現在の候補順：饮品价格表 → 新品宣传 → 活动海报 → 制作说明
取新的第一张，交给写信台
現在の候補順：饮品价格表 → 新品宣传 → 活动海报 → 制作说明
饮品价格表 — 珍珠奶茶 18 元 · 杨枝甘露 20 元 · 加料 2 元
証拠が十分
最終的に渡した証拠
- 饮品价格表：珍珠奶茶 18 元 · 杨枝甘露 20 元 · 加料 2 元
教材の返信／顧客の反応（事前作成）
珍珠奶茶 18 元。
没有被找回的资料，不能靠重新排序凭空出现。
このステージの記録を生成するコマンド（作者のリポジトリでのみ実行できます）：
npm run experiment:rag -- --level 506 検索クエリを書き換える
このステージを開く →操作手順と結果を見る
第1問 · 顧客の質問
那个QQ的黑色小丸子，晚上几点就没啦？
执行检索，比较候选顺序
現在の候補順：冬季限定 → 小料介绍 → 营业时间
先取原查询的第一条，检查证据
現在の候補順：冬季限定 → 小料介绍 → 营业时间
冬季限定 — 黑芝麻汤圆：黑色的小丸子，冬季晚上供应。
証拠が不適切 · 这页是黑芝麻汤圆。客人指着的是珍珠奶茶里的珍珠。
回到检索台，拿掉查询词「QQ」
回到检索台，拿掉查询词「黑色小丸子」
回到检索台，拿掉查询词「晚上」
回到检索台，拿掉查询词「几点」
加入查询词「珍珠」
加入查询词「停止供应」
加入查询词「时间」
执行检索，比较候选顺序
現在の候補順：珍珠 · 供应时间 → 营业时间 → 小料介绍
取改写后的第一条，交给写信台
現在の候補順：珍珠 · 供应时间 → 营业时间 → 小料介绍
珍珠 · 供应时间 — 珍珠每日19:30停止供应。
証拠が十分
最終的に渡した証拠
- 珍珠 · 供应时间：珍珠每日19:30停止供应。
教材の返信／顧客の反応（事前作成）
您说的是珍珠吧？珍珠每天19:30停止供应，七点半以后就没有了。
このステージの記録を生成するコマンド（作者のリポジトリでのみ実行できます）：
npm run experiment:rag -- --level 607 断片の文脈を取り戻す
このステージを開く →操作手順と結果を見る
第1問 · 顧客の質問
新宿店周六几点开门？
先取没有店名的片段，交给写信台
現在の候補順：片段 · 来源：门店营业时间 第 2 段 → 门店地址 → 节假日安排
片段 · 来源：门店营业时间 第 2 段 — ……周末10点开门。
証拠が不適切 · 这段没有说明是哪家店。不能直接把 10 点当成新宿店的开门时间。
回到检索台，点击「查看来源（展开）」
取「新宿店」那一行，交给写信台
门店营业时间 · 新宿店 — 新宿店：周末9点开门。
証拠が十分
最終的に渡した証拠
- 门店营业时间 · 新宿店：新宿店：周末9点开门。
教材の返信／顧客の反応（事前作成）
新宿店周六9点开门（周六属于周末）。
切分（Chunking）方式也会影响这个问题：切的时候就把店名和时间留在一起，片段本身就够用。重新切分和展开上下文是两种不同的做法。
このステージの記録を生成するコマンド（作者のリポジトリでのみ実行できます）：
npm run experiment:rag -- --level 708 二つの検索方法を比べる
このステージを開く →操作手順と結果を見る
第1問 · 顧客の質問
SKU-MT-042 现在多少钱？
先选「按意思找」
执行检索，比较候选顺序
現在の候補順：价格表 · SKU-MT-024 → 新品预告 → 价格表 · SKU-MT-042
试取 SKU-MT-024，核对编号
現在の候補順：价格表 · SKU-MT-024 → 新品预告 → 价格表 · SKU-MT-042
价格表 · SKU-MT-024 — SKU-MT-024 茉香奶绿（大杯）：19 元。
証拠が不適切 · 这页是 SKU-MT-024，客人问的是 042。编号差一位，不是同一件商品。
回到检索台，也启用「按字找」
执行检索，比较候选顺序
現在の候補順：价格表 · SKU-MT-042 → 价格表 · SKU-MT-024 → 编号说明 → 新品预告
取 SKU-MT-042，交给写信台
現在の候補順：价格表 · SKU-MT-042 → 价格表 · SKU-MT-024 → 编号说明 → 新品预告
价格表 · SKU-MT-042 — SKU-MT-042 茉莉奶绿：16 元。
証拠が十分
最終的に渡した証拠
- 价格表 · SKU-MT-042：SKU-MT-042 茉莉奶绿：16 元。
教材の返信／顧客の反応（事前作成）
SKU-MT-042 是茉莉奶绿，16 元。
第2問 · 顧客の質問
有没有口感清爽、带点酸味的饮品？
第二单先选「按字找」
执行检索，比较候选顺序
現在の候補順：焦糖奶茶 → 加料推荐 → 柠檬绿茶
试取「焦糖奶茶」，核对口味描述
現在の候補順：焦糖奶茶 → 加料推荐 → 柠檬绿茶
焦糖奶茶 — 口感醇厚，香甜浓郁。
証拠が不適切 · 这页只是也用了“口感”两个字。焦糖奶茶香甜浓郁，不清爽也不酸。
回到检索台，也启用「按意思找」
执行检索，比较候选顺序
現在の候補順：焦糖奶茶 → 柠檬绿茶 → 加料推荐 → 百香果多多
取「柠檬绿茶」，交给写信台
現在の候補順：焦糖奶茶 → 柠檬绿茶 → 加料推荐 → 百香果多多
柠檬绿茶 — 鲜柠檬配茉莉绿茶，入口爽口，微酸回甘。
証拠が十分
最終的に渡した証拠
- 柠檬绿茶：鲜柠檬配茉莉绿茶，入口爽口，微酸回甘。
教材の返信／顧客の反応（事前作成）
推荐柠檬绿茶：资料写它入口爽口，微酸回甘。
意思接近不等于事实成立。不管哪一路找到的，都要资料本身明确支持答案。
このステージの記録を生成するコマンド（作者のリポジトリでのみ実行できます）：
npm run experiment:rag -- --level 809 不足を見つけて追加検索
このステージを開く →操作手順と結果を見る
第1問 · 顧客の質問
今晚8点还能买到珍珠奶茶吗？
按顾客问题检索
現在の候補順：营业时间
取营业时间，交给写信台，阅读信息缺口
現在の候補順：营业时间
营业时间 — 门店营业到21:00。
受領済み・追加が必要 · 知道门店开着，但还不知道珍珠供应到几点。
回到检索台，先试补查价格
現在の候補順：饮品价格
把价格交给写信台，观察缺口仍然存在
現在の候補順：饮品价格
饮品价格 — 珍珠奶茶 18 元。
証拠が不適切 · 这是价格，填不上缺口：还不知道珍珠供应到几点。
改查「珍珠 · 供应时间」
現在の候補順：珍珠 · 供应时间
补齐珍珠供应时间，取回信交给顾客
現在の候補順：珍珠 · 供应时间
珍珠 · 供应时间 — 珍珠19:30停止供应。
証拠が十分
最終的に渡した証拠
- 营业时间：门店营业到21:00。
- 珍珠 · 供应时间：珍珠19:30停止供应。
教材の返信／顧客の反応（事前作成）
门店开到21:00，但珍珠19:30就停止供应了，今晚8点买不到珍珠奶茶，可以换别的饮品。
这展示了“判断不足—继续检索”的过程，是理解 Agentic RAG 的一个入口；Agentic RAG 不只是重复检索。
このステージの記録を生成するコマンド（作者のリポジトリでのみ実行できます）：
npm run experiment:rag -- --level 910 関係をたどって証拠を探す
このステージを開く →操作手順と結果を見る
第1問 · 顧客の質問
A供应商今晚无法按时送货，明天哪些饮品可能受影响？
展开 A 供应商
展开木薯粉
展开珍珠
把珍珠奶茶路径加入证据
先只带一条路径给写信台
关系证据 — A 供应商 → 木薯粉 → 珍珠 → 珍珠奶茶（进货单、配方、菜单）
証拠が不適切 · 我只拿到一条受影响的路径。A 供应商还连着别的原料吗？再去关系板看看。
回到关系板，展开 A 供应商的芋头
展开芋泥
把芋泥奶茶路径加入证据
带两条路径给写信台；留意回信中的“可能”和库存限制
关系证据 — A 供应商 → 木薯粉 → 珍珠 → 珍珠奶茶（进货单、配方、菜单）；A 供应商 → 芋头 → 芋泥 → 芋泥奶茶（进货单、配方、菜单）
証拠が十分
最終的に渡した証拠
- 关系证据：A 供应商 → 木薯粉 → 珍珠 → 珍珠奶茶（进货单、配方、菜单）；A 供应商 → 芋头 → 芋泥 → 芋泥奶茶（进货单、配方、菜单）
教材の返信／顧客の反応（事前作成）
可能受影响：珍珠奶茶（木薯粉 → 珍珠）和芋泥奶茶（芋头 → 芋泥），都依赖 A 供应商。资料里没有库存信息，是否停售要先查库存。
物流延误只能说明“可能受影响”；没有库存信息，就不能断言一定停售。完整的 GraphRAG 专题还会探索建图和不同的查询方式，这一关只展示关系能提供关联证据。
このステージの記録を生成するコマンド（作者のリポジトリでのみ実行できます）：
npm run experiment:rag -- --level 10この記録の生成方法
サイトのリポジトリのルートで実行します。Node 22.12 以上が必要で、モデル、API キー、ネット接続は不要です。リポジトリはまだ公開していないため、これらのコマンドは作者のリポジトリでしか実行できません。記録の出どころを示すために載せています。
全10ステージを実行
npm run experiment:ragデータと手順の場所
experiments/rag/room/README.mdsrc/scripts/rag-game/levels.tssrc/data/rag-reproduction.ts
ビルド時の全記録を見る
[
{
"level": 1,
"title": "找到那一页",
"skill": "找到唯一资料",
"learn": [
"先找到和问题有关的那一页，再交出去。整个游戏都从这一步开始：检索（Retrieval）。"
],
"source": "teaching-simulation",
"orders": [
{
"question": "几点开门？",
"steps": [
{
"action": "take",
"arg": "hours",
"label": "查看「营业时间」，拿起并交给顾客",
"candidates": [],
"item": {
"id": "hours",
"t": "营业时间",
"b": "上午九点开门。",
"kind": "doc"
},
"judgement": {
"verdict": "accept",
"complete": true
}
}
],
"evidence": [
{
"id": "hours",
"t": "营业时间",
"b": "上午九点开门。",
"kind": "doc"
}
],
"complete": true,
"reply": "九点开门，好的，明早见！"
}
]
},
{
"level": 2,
"title": "从几页里挑出对的",
"skill": "从不同资料中选择",
"learn": [
"资料一多，就要读一读、比一比，挑出真正能回答问题的那一页。"
],
"source": "teaching-simulation",
"orders": [
{
"question": "周几休息？",
"steps": [
{
"action": "take",
"arg": "price",
"label": "先试「饮品价格」，观察为什么不够",
"candidates": [],
"item": {
"id": "price",
"t": "饮品价格",
"b": "珍珠奶茶 15 元，杨枝甘露 18 元，加料 2 元。",
"kind": "doc"
},
"judgement": {
"verdict": "reject",
"say": "这页是价格，我想知道哪天休息。"
}
},
{
"action": "take",
"arg": "schedule",
"label": "改选「营业安排」，交给顾客",
"candidates": [],
"item": {
"id": "schedule",
"t": "营业安排",
"b": "周一至周六营业，周日休息。",
"kind": "doc"
},
"judgement": {
"verdict": "accept",
"complete": true
}
}
],
"evidence": [
{
"id": "schedule",
"t": "营业安排",
"b": "周一至周六营业，周日休息。",
"kind": "doc"
}
],
"complete": true,
"reply": "周日休息，记住了。"
}
]
},
{
"level": 3,
"title": "换了问法也能找到",
"skill": "理解不同问法",
"learn": [
"价格页上也写着“奶茶”，但能回答“周日能不能来”的是营业安排。找资料要看意思，不只是看有没有同样的字。"
],
"source": "teaching-simulation",
"orders": [
{
"question": "周日能来买奶茶吗？",
"steps": [
{
"action": "take",
"arg": "price",
"label": "先试含有“奶茶”字样的价格页",
"candidates": [],
"item": {
"id": "price",
"t": "饮品价格",
"b": "珍珠奶茶 15 元，杨枝甘露 18 元，加料 2 元。",
"kind": "doc"
},
"judgement": {
"verdict": "reject",
"say": "这页是奶茶价格。我不是问多少钱，是问周日能不能来。"
}
},
{
"action": "take",
"arg": "schedule",
"label": "改选能说明周日是否营业的资料",
"candidates": [],
"item": {
"id": "schedule",
"t": "营业安排",
"b": "周一至周六营业，周日休息。",
"kind": "doc"
},
"judgement": {
"verdict": "accept",
"complete": true
}
}
],
"evidence": [
{
"id": "schedule",
"t": "营业安排",
"b": "周一至周六营业，周日休息。",
"kind": "doc"
}
],
"complete": true,
"reply": "周日不开门啊，知道了，我周六来。"
}
]
},
{
"level": 4,
"title": "请 LLM 写回信",
"skill": "把问题和资料交给 LLM，生成回答",
"learn": [
"之前：找到资料，交回资料。",
"现在：把问题和资料交给 LLM，生成回答。",
"RAG：检索增强生成。"
],
"source": "teaching-simulation",
"orders": [
{
"question": "我周六九点半来，开门了吗？",
"steps": [
{
"action": "question",
"arg": "",
"label": "取收件窗口的问题，交给 LLM 写信台",
"candidates": []
},
{
"action": "take",
"arg": "weekend",
"label": "查看「营业时间」，拿起并交给写信台；取回信后交给顾客",
"candidates": [],
"item": {
"id": "weekend",
"t": "营业时间",
"b": "平日九点开门；周末十点开门。",
"kind": "doc"
},
"judgement": {
"verdict": "accept",
"complete": true
}
}
],
"evidence": [
{
"id": "weekend",
"t": "营业时间",
"b": "平日九点开门；周末十点开门。",
"kind": "doc"
}
],
"complete": true,
"reply": "还没开门。周六属于周末，10点开门。"
}
]
},
{
"level": 5,
"title": "排在前面的不一定最有用",
"skill": "检索候选与排序",
"learn": [
"检索先找到候选，重排序（Rerank）帮助把更适合当前问题的资料放到前面。"
],
"note": "没有被找回的资料，不能靠重新排序凭空出现。",
"source": "teaching-simulation",
"orders": [
{
"question": "珍珠奶茶多少钱？",
"steps": [
{
"action": "take",
"arg": "",
"label": "先取默认第一张「新品宣传」，交给写信台",
"candidates": [
"新品宣传",
"活动海报",
"制作说明",
"饮品价格表"
],
"item": {
"id": "promo",
"t": "新品宣传",
"b": "新品芋泥波波上市！老顾客买珍珠奶茶，第二杯半价。",
"kind": "doc",
"src": "station"
},
"judgement": {
"verdict": "reject",
"say": "这些资料没有提供价格：这页讲新品上市和第二杯半价，没写珍珠奶茶本身多少钱。"
}
},
{
"action": "up",
"arg": "price",
"label": "回到检索台，把「饮品价格表」上移一位",
"candidates": [
"新品宣传",
"活动海报",
"饮品价格表",
"制作说明"
]
},
{
"action": "up",
"arg": "price",
"label": "回到检索台，把「饮品价格表」上移一位",
"candidates": [
"新品宣传",
"饮品价格表",
"活动海报",
"制作说明"
]
},
{
"action": "up",
"arg": "price",
"label": "回到检索台，把「饮品价格表」上移一位",
"candidates": [
"饮品价格表",
"新品宣传",
"活动海报",
"制作说明"
]
},
{
"action": "take",
"arg": "",
"label": "取新的第一张，交给写信台",
"candidates": [
"饮品价格表",
"新品宣传",
"活动海报",
"制作说明"
],
"item": {
"id": "price5",
"t": "饮品价格表",
"b": "珍珠奶茶 18 元 · 杨枝甘露 20 元 · 加料 2 元",
"kind": "doc",
"s": "价格表",
"src": "station"
},
"judgement": {
"verdict": "accept",
"complete": true
}
}
],
"evidence": [
{
"id": "price5",
"t": "饮品价格表",
"b": "珍珠奶茶 18 元 · 杨枝甘露 20 元 · 加料 2 元",
"kind": "doc",
"s": "价格表",
"src": "station"
}
],
"complete": true,
"reply": "珍珠奶茶 18 元。"
}
]
},
{
"level": 6,
"title": "换一种说法",
"skill": "改善查询表达",
"learn": [
"顾客的说法和资料的写法常常不一样。换一种查询表达（Query Rewrite），检索就能找到资料；回答时仍然照顾客原来的问题来答。",
"同时用几种说法去查、再把结果合在一起，是 MultiQuery 的思路。"
],
"source": "teaching-simulation",
"orders": [
{
"question": "那个QQ的黑色小丸子，晚上几点就没啦？",
"steps": [
{
"action": "search",
"arg": "",
"label": "执行检索，比较候选顺序",
"candidates": [
"冬季限定",
"小料介绍",
"营业时间"
]
},
{
"action": "take",
"arg": "",
"label": "先取原查询的第一条，检查证据",
"candidates": [
"冬季限定",
"小料介绍",
"营业时间"
],
"item": {
"id": "tangyuan",
"t": "冬季限定",
"b": "黑芝麻汤圆：黑色的小丸子，冬季晚上供应。",
"kind": "doc",
"src": "station"
},
"judgement": {
"verdict": "reject",
"say": "这页是黑芝麻汤圆。客人指着的是珍珠奶茶里的珍珠。"
}
},
{
"action": "rm",
"arg": "QQ",
"label": "回到检索台，拿掉查询词「QQ」",
"candidates": []
},
{
"action": "rm",
"arg": "黑色小丸子",
"label": "回到检索台，拿掉查询词「黑色小丸子」",
"candidates": []
},
{
"action": "rm",
"arg": "晚上",
"label": "回到检索台，拿掉查询词「晚上」",
"candidates": []
},
{
"action": "rm",
"arg": "几点",
"label": "回到检索台，拿掉查询词「几点」",
"candidates": []
},
{
"action": "add",
"arg": "珍珠",
"label": "加入查询词「珍珠」",
"candidates": []
},
{
"action": "add",
"arg": "停止供应",
"label": "加入查询词「停止供应」",
"candidates": []
},
{
"action": "add",
"arg": "时间",
"label": "加入查询词「时间」",
"candidates": []
},
{
"action": "search",
"arg": "",
"label": "执行检索，比较候选顺序",
"candidates": [
"珍珠 · 供应时间",
"营业时间",
"小料介绍"
]
},
{
"action": "take",
"arg": "",
"label": "取改写后的第一条，交给写信台",
"candidates": [
"珍珠 · 供应时间",
"营业时间",
"小料介绍"
],
"item": {
"id": "pearl",
"t": "珍珠 · 供应时间",
"b": "珍珠每日19:30停止供应。",
"kind": "doc",
"s": "珍珠供应",
"src": "station"
},
"judgement": {
"verdict": "accept",
"complete": true
}
}
],
"evidence": [
{
"id": "pearl",
"t": "珍珠 · 供应时间",
"b": "珍珠每日19:30停止供应。",
"kind": "doc",
"s": "珍珠供应",
"src": "station"
}
],
"complete": true,
"reply": "您说的是珍珠吧？珍珠每天19:30停止供应，七点半以后就没有了。"
}
]
},
{
"level": 7,
"title": "这句话说的是哪家店",
"skill": "找回片段的上下文",
"learn": [
"片段一旦离开了它的主体和条件（哪家店），就可能不足以支持回答。展开上下文（Small-to-Big），把主体找回来。"
],
"note": "切分（Chunking）方式也会影响这个问题：切的时候就把店名和时间留在一起，片段本身就够用。重新切分和展开上下文是两种不同的做法。",
"source": "teaching-simulation",
"orders": [
{
"question": "新宿店周六几点开门？",
"steps": [
{
"action": "take",
"arg": "frag",
"label": "先取没有店名的片段，交给写信台",
"candidates": [
"片段 · 来源：门店营业时间 第 2 段",
"门店地址",
"节假日安排"
],
"item": {
"id": "frag",
"t": "片段 · 来源：门店营业时间 第 2 段",
"b": "……周末10点开门。",
"kind": "doc",
"s": "片段",
"src": "station"
},
"judgement": {
"verdict": "reject",
"say": "这段没有说明是哪家店。不能直接把 10 点当成新宿店的开门时间。"
}
},
{
"action": "expand",
"arg": "",
"label": "回到检索台，点击「查看来源（展开）」",
"candidates": []
},
{
"action": "take",
"arg": "shinjuku",
"label": "取「新宿店」那一行，交给写信台",
"candidates": [],
"item": {
"id": "shinjuku",
"t": "门店营业时间 · 新宿店",
"b": "新宿店：周末9点开门。",
"kind": "doc",
"s": "新宿店",
"src": "station"
},
"judgement": {
"verdict": "accept",
"complete": true
}
}
],
"evidence": [
{
"id": "shinjuku",
"t": "门店营业时间 · 新宿店",
"b": "新宿店：周末9点开门。",
"kind": "doc",
"s": "新宿店",
"src": "station"
}
],
"complete": true,
"reply": "新宿店周六9点开门（周六属于周末）。"
}
]
},
{
"level": 8,
"title": "两种查找方式",
"skill": "关键词与语义检索",
"learn": [
"按字找（关键词检索）擅长编号、专有名词这类要一字不差的线索；按意思找（语义检索）能找到换了说法的内容。两路合并去重，就是混合检索（Hybrid Search）的思路。"
],
"note": "意思接近不等于事实成立。不管哪一路找到的，都要资料本身明确支持答案。",
"source": "teaching-simulation",
"orders": [
{
"question": "SKU-MT-042 现在多少钱？",
"steps": [
{
"action": "tool",
"arg": "sem",
"label": "先选「按意思找」",
"candidates": []
},
{
"action": "search",
"arg": "",
"label": "执行检索，比较候选顺序",
"candidates": [
"价格表 · SKU-MT-024",
"新品预告",
"价格表 · SKU-MT-042"
]
},
{
"action": "take",
"arg": "sku024",
"label": "试取 SKU-MT-024，核对编号",
"candidates": [
"价格表 · SKU-MT-024",
"新品预告",
"价格表 · SKU-MT-042"
],
"item": {
"id": "sku024",
"t": "价格表 · SKU-MT-024",
"b": "SKU-MT-024 茉香奶绿（大杯）：19 元。",
"kind": "doc",
"s": "SKU-024",
"src": "station"
},
"judgement": {
"verdict": "reject",
"say": "这页是 SKU-MT-024，客人问的是 042。编号差一位，不是同一件商品。"
}
},
{
"action": "tool",
"arg": "kw",
"label": "回到检索台，也启用「按字找」",
"candidates": []
},
{
"action": "search",
"arg": "",
"label": "执行检索，比较候选顺序",
"candidates": [
"价格表 · SKU-MT-042",
"价格表 · SKU-MT-024",
"编号说明",
"新品预告"
]
},
{
"action": "take",
"arg": "sku042",
"label": "取 SKU-MT-042，交给写信台",
"candidates": [
"价格表 · SKU-MT-042",
"价格表 · SKU-MT-024",
"编号说明",
"新品预告"
],
"item": {
"id": "sku042",
"t": "价格表 · SKU-MT-042",
"b": "SKU-MT-042 茉莉奶绿：16 元。",
"kind": "doc",
"s": "SKU-042",
"src": "station"
},
"judgement": {
"verdict": "accept",
"complete": true
}
}
],
"evidence": [
{
"id": "sku042",
"t": "价格表 · SKU-MT-042",
"b": "SKU-MT-042 茉莉奶绿：16 元。",
"kind": "doc",
"s": "SKU-042",
"src": "station"
}
],
"complete": true,
"reply": "SKU-MT-042 是茉莉奶绿，16 元。"
},
{
"question": "有没有口感清爽、带点酸味的饮品？",
"steps": [
{
"action": "tool",
"arg": "kw",
"label": "第二单先选「按字找」",
"candidates": []
},
{
"action": "search",
"arg": "",
"label": "执行检索，比较候选顺序",
"candidates": [
"焦糖奶茶",
"加料推荐",
"柠檬绿茶"
]
},
{
"action": "take",
"arg": "caramel",
"label": "试取「焦糖奶茶」，核对口味描述",
"candidates": [
"焦糖奶茶",
"加料推荐",
"柠檬绿茶"
],
"item": {
"id": "caramel",
"t": "焦糖奶茶",
"b": "口感醇厚，香甜浓郁。",
"kind": "doc",
"src": "station"
},
"judgement": {
"verdict": "reject",
"say": "这页只是也用了“口感”两个字。焦糖奶茶香甜浓郁，不清爽也不酸。"
}
},
{
"action": "tool",
"arg": "sem",
"label": "回到检索台，也启用「按意思找」",
"candidates": []
},
{
"action": "search",
"arg": "",
"label": "执行检索，比较候选顺序",
"candidates": [
"焦糖奶茶",
"柠檬绿茶",
"加料推荐",
"百香果多多"
]
},
{
"action": "take",
"arg": "lemon",
"label": "取「柠檬绿茶」，交给写信台",
"candidates": [
"焦糖奶茶",
"柠檬绿茶",
"加料推荐",
"百香果多多"
],
"item": {
"id": "lemon",
"t": "柠檬绿茶",
"b": "鲜柠檬配茉莉绿茶，入口爽口，微酸回甘。",
"kind": "doc",
"src": "station"
},
"judgement": {
"verdict": "accept",
"complete": true
}
}
],
"evidence": [
{
"id": "lemon",
"t": "柠檬绿茶",
"b": "鲜柠檬配茉莉绿茶，入口爽口，微酸回甘。",
"kind": "doc",
"src": "station"
}
],
"complete": true,
"reply": "推荐柠檬绿茶：资料写它入口爽口，微酸回甘。"
}
]
},
{
"level": 9,
"title": "还缺一条线索",
"skill": "发现信息缺口，再次检索",
"learn": [
"先检查手上的资料够不够回答，发现缺口，再朝缺口的方向发起新的检索。"
],
"note": "这展示了“判断不足—继续检索”的过程，是理解 Agentic RAG 的一个入口；Agentic RAG 不只是重复检索。",
"source": "teaching-simulation",
"orders": [
{
"question": "今晚8点还能买到珍珠奶茶吗？",
"steps": [
{
"action": "first",
"arg": "",
"label": "按顾客问题检索",
"candidates": [
"营业时间"
]
},
{
"action": "take",
"arg": "",
"label": "取营业时间，交给写信台，阅读信息缺口",
"candidates": [
"营业时间"
],
"item": {
"id": "open21",
"t": "营业时间",
"b": "门店营业到21:00。",
"kind": "doc",
"src": "station"
},
"judgement": {
"verdict": "accept",
"say": "知道门店开着，但还不知道珍珠供应到几点。"
}
},
{
"action": "dir",
"arg": "cost",
"label": "回到检索台，先试补查价格",
"candidates": [
"饮品价格"
]
},
{
"action": "take",
"arg": "",
"label": "把价格交给写信台，观察缺口仍然存在",
"candidates": [
"饮品价格"
],
"item": {
"id": "cost",
"t": "饮品价格",
"b": "珍珠奶茶 18 元。",
"kind": "doc",
"src": "station"
},
"judgement": {
"verdict": "reject",
"say": "这是价格，填不上缺口：还不知道珍珠供应到几点。"
}
},
{
"action": "dir",
"arg": "pearl",
"label": "改查「珍珠 · 供应时间」",
"candidates": [
"珍珠 · 供应时间"
]
},
{
"action": "take",
"arg": "",
"label": "补齐珍珠供应时间，取回信交给顾客",
"candidates": [
"珍珠 · 供应时间"
],
"item": {
"id": "pearl1930",
"t": "珍珠 · 供应时间",
"b": "珍珠19:30停止供应。",
"kind": "doc",
"s": "珍珠供应",
"src": "station"
},
"judgement": {
"verdict": "accept",
"complete": true
}
}
],
"evidence": [
{
"id": "open21",
"t": "营业时间",
"b": "门店营业到21:00。",
"kind": "doc",
"src": "station"
},
{
"id": "pearl1930",
"t": "珍珠 · 供应时间",
"b": "珍珠19:30停止供应。",
"kind": "doc",
"s": "珍珠供应",
"src": "station"
}
],
"complete": true,
"reply": "门店开到21:00，但珍珠19:30就停止供应了，今晚8点买不到珍珠奶茶，可以换别的饮品。"
}
]
},
{
"level": 10,
"title": "关系里的答案",
"skill": "利用实体关系回答问题",
"learn": [
"资料之间的关系（供应商 → 原料 → 半成品 → 饮品）能把分散的证据连起来，每一步都能追溯到来源。"
],
"note": "物流延误只能说明“可能受影响”；没有库存信息，就不能断言一定停售。完整的 GraphRAG 专题还会探索建图和不同的查询方式，这一关只展示关系能提供关联证据。",
"source": "teaching-simulation",
"orders": [
{
"question": "A供应商今晚无法按时送货，明天哪些饮品可能受影响？",
"steps": [
{
"action": "node",
"arg": "A",
"label": "展开 A 供应商",
"candidates": []
},
{
"action": "node",
"arg": "tapioca",
"label": "展开木薯粉",
"candidates": []
},
{
"action": "node",
"arg": "pearl",
"label": "展开珍珠",
"candidates": []
},
{
"action": "add",
"arg": "pearlTea",
"label": "把珍珠奶茶路径加入证据",
"candidates": []
},
{
"action": "take",
"arg": "",
"label": "先只带一条路径给写信台",
"candidates": [],
"item": {
"id": "graph:pearlTea",
"t": "关系证据",
"b": "A 供应商 → 木薯粉 → 珍珠 → 珍珠奶茶（进货单、配方、菜单）",
"kind": "doc",
"s": "关系证据",
"src": "station",
"data": [
"pearlTea"
]
},
"judgement": {
"verdict": "reject",
"say": "我只拿到一条受影响的路径。A 供应商还连着别的原料吗？再去关系板看看。"
}
},
{
"action": "node",
"arg": "taro",
"label": "回到关系板，展开 A 供应商的芋头",
"candidates": []
},
{
"action": "node",
"arg": "taropaste",
"label": "展开芋泥",
"candidates": []
},
{
"action": "add",
"arg": "taroTea",
"label": "把芋泥奶茶路径加入证据",
"candidates": []
},
{
"action": "take",
"arg": "",
"label": "带两条路径给写信台；留意回信中的“可能”和库存限制",
"candidates": [],
"item": {
"id": "graph:pearlTea+taroTea",
"t": "关系证据",
"b": "A 供应商 → 木薯粉 → 珍珠 → 珍珠奶茶（进货单、配方、菜单）；A 供应商 → 芋头 → 芋泥 → 芋泥奶茶（进货单、配方、菜单）",
"kind": "doc",
"s": "关系证据",
"src": "station",
"data": [
"pearlTea",
"taroTea"
]
},
"judgement": {
"verdict": "accept",
"complete": true
}
}
],
"evidence": [
{
"id": "graph:pearlTea+taroTea",
"t": "关系证据",
"b": "A 供应商 → 木薯粉 → 珍珠 → 珍珠奶茶（进货单、配方、菜单）；A 供应商 → 芋头 → 芋泥 → 芋泥奶茶（进货单、配方、菜单）",
"kind": "doc",
"s": "关系证据",
"src": "station",
"data": [
"pearlTea",
"taroTea"
]
}
],
"complete": true,
"reply": "可能受影响：珍珠奶茶（木薯粉 → 珍珠）和芋泥奶茶（芋头 → 芋泥），都依赖 A 供应商。资料里没有库存信息，是否停售要先查库存。"
}
]
}
]次の段階：実際のモデル実験
実際のモデルを調べるには、各ステージの資料で検索と生成を別途実行し、モデルのバージョン、候補スコア、完全なコンテキスト、元の回答を保存します。事前作成の返信をモデル出力として扱いません。実験 README に比較変数を記載しています。
旧助手はゲーム入口から置き換えました。過去のベクトル検索実験は experiments/rag/milk-tea-ai-01/ に保管していますが、今回の10ステージとは別の記録です。
このページの概念
概念を開くと、中国語・日本語・English の対応と説明を確認できます。
検索詳しく見る
- 中文
- 检索
- 日本語
- 検索
- English
- Retrieval
資料集合から質問に関連する候補を見つけること。証拠が十分かは別途判断します。
意味検索詳しく見る
- 中文
- 语义检索
- 日本語
- 意味検索
- English
- Semantic search
意味の関連性で検索する方法。表現の違いに対応できますが、類似性は事実の一致ではありません。第8ステージの候補は手作りです。
大規模言語モデル LLM詳しく見る
- 中文
- 大语言模型
- 日本語
- 大規模言語モデル
- English
- Large language model (LLM)
入力に応じて言語を生成するモデル。このゲームの返信は事前作成した教材で、オンラインのモデル呼び出しではありません。
検索拡張生成 RAG詳しく見る
- 中文
- 检索增强生成
- 日本語
- 検索拡張生成
- English
- Retrieval-augmented generation (RAG)
関連資料を検索し、質問と資料をモデルに渡して回答を生成する方法。検索できても正答は保証されません。
リランキング詳しく見る
- 中文
- 重排序
- 日本語
- リランキング
- English
- Reranking
検索済み候補の順序を付け直すこと。未検索の資料は追加できません。第5ステージでは手動で並べ替えます。
クエリ書き換え詳しく見る
- 中文
- 查询改写
- 日本語
- クエリ書き換え
- English
- Query rewriting
元の質問の意図を保ちながら検索用の表現を変えること。回答は元の質問に対応させます。
マルチクエリ検索詳しく見る
- 中文
- 多查询检索
- 日本語
- マルチクエリ検索
- English
- Multi-query retrieval
複数の表現で検索し、候補を統合・重複排除します。第6ステージは書き換えの実演で、自動の複数検索ではありません。
チャンク分割詳しく見る
- 中文
- 文本切分
- 日本語
- チャンク分割
- English
- Chunking
文書を検索単位に分けること。主語や条件が離れると、断片だけでは回答を支えられない場合があります。
コンテキスト拡張詳しく見る
- 中文
- 上下文扩展
- 日本語
- コンテキスト拡張
- English
- Small-to-big retrieval
小さな断片を検索した後、周辺や親文書へ広げて主語や条件を確認します。
キーワード検索詳しく見る
- 中文
- 关键词检索
- 日本語
- キーワード検索
- English
- Keyword search
語の一致を使って検索する方法。番号や固有名詞などの厳密な手がかりに向いています。
ハイブリッド検索詳しく見る
- 中文
- 混合检索
- 日本語
- ハイブリッド検索
- English
- Hybrid search
キーワード検索や意味検索など複数経路を組み合わせます。第8ステージでは交互に統合し重複を除きます。
エージェント型RAG詳しく見る
- 中文
- 智能体式检索增强生成
- 日本語
- エージェント型RAG
- English
- Agentic RAG
タスクの状態に応じて検索などの次の行動を選ぶ仕組み。第9ステージは固定ルールによる追加検索の例で、自律エージェントではありません。
グラフ型RAG詳しく見る
- 中文
- 图结构检索增强生成
- 日本語
- グラフ型RAG
- English
- GraphRAG
実体と関係を用いて証拠を整理・検索する方法。第10ステージは手作りグラフの経路を示し、自動構築や完全なシステムは含みません。