Jev 粉皮书
上手篇4

第 4 课 · Questions 怎么写:试卷设计与避坑指南

模块上手篇预计学习12 分钟难度

🎯 学完这一课,你将能够

  • 掌握 Jev 试卷(Questions)的核心 JSON 结构与字段设计规范
  • 掌握三种题型在代码中 criteria 属性的严格格式要求
  • 规避最常见的选项重叠、描述模糊与语言漂移陷阱
  • 能够看懂社区 Schema 图与模型真实输出解析图

为什么这一步最容易卡死?

在传统的 Prompt 工程中,大家习惯于让大模型自由发挥。但在 Jev 体系下,模型好不好用,80% 取决于你出的试卷专不专业。

社区有一张流传极广的高清中文上手图,将试卷的键名(Key)、题型(Type)、准则描述(Criteria)与模型返回结构(Output)的对应关系讲解得十分清晰:

Jev 的输入、问题与判断检查

出题的三大黄金原则

原则 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不需要填写 criteria0 到 1 之间的浮点概率(代表“是”的倾向)
单选题"choice"type, instructions, criteriaJSON 键值对对象: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 讲清边界。

学完后记得保存进度

完成标记保存在当前浏览器;登录后,会记住上次阅读的章节与位置。