上手篇4
第 4 课 · Questions 怎么写:试卷设计与避坑指南
模块上手篇预计学习12 分钟难度
🎯 学完这一课,你将能够
- 掌握 Jev 试卷(Questions)的核心 JSON 结构与字段设计规范
- 掌握三种题型在代码中 criteria 属性的严格格式要求
- 规避最常见的选项重叠、描述模糊与语言漂移陷阱
- 能够看懂社区 Schema 图与模型真实输出解析图
为什么这一步最容易卡死?
在传统的 Prompt 工程中,大家习惯于让大模型自由发挥。但在 Jev 体系下,模型好不好用,80% 取决于你出的试卷专不专业。
社区有一张流传极广的高清中文上手图,将试卷的键名(Key)、题型(Type)、准则描述(Criteria)与模型返回结构(Output)的对应关系讲解得十分清晰:
出题的三大黄金原则
原则 1:State 只放现场事实,不放公司制度
很多新手习惯把《公司退款政策全文》或者 5000 字的产品文档全部贴到 State 里。这是严重的误区!
State 是当下发生的具体事实(如客户发来的那句话、表单填写的字段);关于规则的描述,应该简明扼要地放进 Questions 的 instructions 或 criteria 中。
原则 2:先在草稿纸上写人话,再选题型
如果连你自己都无法用一两句话向同事讲清这个维度的判断标准,直接去写 JSON 试卷必错无疑。先写清:“我想知道客户是否在催单”、“我想知道属于哪个部门”。
原则 3:Choice 选项必须严格互斥(MECE 原则)
绝对不能同时出现描述重叠的选项。例如同时设置了 after_sales(售后)和 refund(退款),模型就会在两个选项之间摇摆不定,导致 confidence 骤降。如果你分不清,模型更分不清。
一个能直接复制修改的万能骨架
以下是官方推荐的标准试卷骨架,涵盖全部三种题型:
json
{
"is_urgent": {
"type": "noul",
"instructions": "这条消息是否明确表达了必须立即得到处理的紧急意图?"
},
"department": {
"type": "choice",
"instructions": "根据消息陈述的核心诉求,应当流转至哪一个业务部门?",
"criteria": {
"billing": "涉及账户付款、多扣款、发票开具、退费申请与账单对账",
"technical": "涉及系统报错、无法登录、API 异常、连不上服务器",
"sales": "涉及新套餐询价、企业大客户定制、商务合作意向",
"general": "日常功能咨询、使用技巧询问、非技术类通用问题"
}
},
"frustration": {
"type": "score",
"instructions": "评估客户在当前消息中表现出的情绪沮丧或愤怒程度:",
"criteria": [
"情绪冷静克制,仅客观陈述客观事实",
"略带不满或困惑,但仍保持礼貌与克制",
"情绪激动愤怒,使用了强烈的感叹号或严厉指责措辞"
]
}
}三种题型的字段规范对比
| 题型名称 | type 字段取值 | 必填字段 | criteria 格式说明 | 返回结果形态 |
|---|---|---|---|---|
| 是非题 | "noul" | type, instructions | 不需要填写 criteria | 0 到 1 之间的浮点概率(代表“是”的倾向) |
| 单选题 | "choice" | type, instructions, criteria | JSON 键值对对象:key 是英文字段名,value 是选项边界说明 | 选中的 choice 键名,及每个选项的概率分布 |
| 评分题 | "score" | type, instructions, criteria | 有序字符串数组:必须严格从低到高排列 | score 数值(支持按等级内插的小数值) |
读懂模型的真实输出
点击运行后,Jev 会沿着你预定义的键名返回结构化结果:
- `department.choice`:
"billing"(选中的胜出选项); - `department.probabilities`:展示所有选项的离散概率(例如 billing 0.94,technical 0.04,sales 0.01,general 0.01);
- `department.confidence`:当前决策的集中程度指数;
- `is_urgent.noul`:
0.82; - `frustration.score`:
2.15(落在第二档与第三档之间)。
✍️ 动手练习
1. 复制上述标准骨架到本地编辑器中;
2. 将 department 的选项换成你自己业务中的真实分类(如:电商场景的“发货、退换、商品咨询”),注意保持描述互斥;
3. 故意在选项中写一个模糊重叠的词(例如把“退款”拆成“退费”和“退钱”),在 Playground 里观察返回的 confidence 是如何大幅下降的。
📌 一句话带走
先写人话,再选题型;选项严格互斥,Criteria 讲清边界。
学完后记得保存进度
完成标记保存在当前浏览器;登录后,会记住上次阅读的章节与位置。