上手篇4

第 4 课 · Questions 怎么写

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

🎯 学完这一课，你将能够

掌握 Questions 的结构和写法
用一个骨架模板写出自己的第一套 Questions
避免最常见的写法错误

这是最容易卡死的一步。社区有一张上手图，把键名、类型、选项和返回值画在一起了。

写法原则

State 只放判断需要的材料，别把整本公司制度贴进去。

每道题先写人话，再选类型。人话写不清，换类型也救不了。

一个能直接改的骨架

json

{
  "is_urgent": {
    "type": "noul",
    "instructions": "这条消息是否表达必须马上处理？"
  },
  "department": {
    "type": "choice",
    "instructions": "应该由哪个团队处理？",
    "criteria": {
      "billing": "付款、扣费、退款、对账",
      "technical": "故障、连不上、集成报错",
      "sales": "价格、套餐、新签约"
    }
  },
  "frustration": {
    "type": "score",
    "instructions": "客户表现得有多沮丧？",
    "criteria": [
      "冷静，只是在陈述事实",
      "不满，但还保持礼貌",
      "非常愤怒，使用强烈措辞"
    ]
  }
}

三种题型对应的写法

题型	必填字段	criteria 格式	返回值
Noul	type + instructions	不需要	0–1 的概率
Choice	type + instructions + criteria	对象：键名→描述	选中的键名
Score	type + instructions + criteria	有序数组	打分

✍️ 动手练习

1. 用上面的骨架模板，把 State 换成你自己业务中的一条真实消息，在 Playground 里跑一次。 2. 尝试把 Noul 题的 instructions 写得更模糊，观察返回的 confidence 变化。

📌 一句话带走

先写人话，再选题型。人话写不清，换类型也救不了。

学完后记得保存进度

完成状态只保存在当前浏览器，不会上传你的学习记录。