2.1 输入与输出：状态 + 问题 → 约束答案 + 概率

2.1 输入与输出：状态 + 问题 → 约束答案 + 概率

本节摘要：本节拆开 Jev 的一次调用。输入有两个：state——程序状态，模型看到的"世界"，可以是字符串、对象或数组；questions——一组带类型的约束问题，每个问题的 ID 由你命名且不会发给模型，纯粹是你代码里的变量名。输出是每个问题一个受约束答案：答案空间在请求里被你预先枚举死，模型结构上不可能产出列表之外的值——这就是官方"0% 幻觉 / 0% 类型错误"的准确含义：数学上由结构保证的形状安全，而判断的正确性是另一回事。本节最后看一个完整请求与响应的样子，为第 3 章的三种类型做铺垫。

学习目标

阅读完本节，你应当能够：

1. 说出请求的四个组成部分及各自作用。
2. 解释 state 用对象（而非揉成一段话）的好处。
3. 准确表述"不能幻觉"保证什么、不保证什么。

一、输入：state 与 questions

                ┌────────────────────────────┐
   state ─────▶ │                            │ ───▶ 受约束的答案（类型安全，绝不越界）
 （程序状态）     │           Jev              │
                │      （System One 模型）      │
questions ───▶ │                            │ ───▶ 概率分布 + 置信度（RLCD 校准）
 （带类型的问题）  └────────────────────────────┘
​

state（状态）：模型看到的"程序当前的世界"——一段用户消息、一张工单的 JSON、一次工具调用的参数。支持三种形态：字符串、对象、数组。

💡 优先用对象：对象让每个问题的 instructions 可以用反引号路径引用具体字段（如 `ticket.body`），比把所有信息揉成一段自然语言更稳、更可维护（第 8.1 节展开状态设计）。

questions（问题）：一个字典，key 是你起的问题 ID——它不发给模型，纯粹是你代码里的变量名，起有意义、稳定的名字（is_urgent 而非 q1）。每个问题包含：

• type：三种类型之一（noul / choice / score，第 3 章逐一拆解）；
• instructions：自然语言判别标准，写给"阅卷老师"看；
• criteria：类型对应的答案空间定义（选项表 / 等级表；是非题没有此字段）。

二、输出：受约束的答案 + 概率

每个问题返回一个答案，形态由类型决定（第 3 章详表）。共同点有两个：

1. 答案永远落在你声明的空间里。Choice 的胜出项必是 criteria 里定义过的选项；Score 的分值必落在等级刻度上；Noul 必是 0~1 的数。模型没有能力产出空间之外的值——这是结构保证（由请求定义直接约束），不需要"祈祷模型守规矩"。
2. 每个答案自带概率语义。Noul 返回命题为真的概率；Choice 返回全选项的概率分布 + 整体置信度；Score 返回各级分布 + 加权分 + 置信度。概率经 RLCD 训练校准（第 5.2 节），可作为阈值判断的工程契约。

三、"0% 幻觉"的准确含义

官方宣称 Jev "0% 幻觉 / 0% 类型错误"，这句话需要精确理解：

一个设计糟糕的选项表不会因为"类型安全"而变好——错误会被包装成一个看起来合法自信的答案。所以本教程把 schema 设计当作一等编程技能来讲（第 3 章的设计准则、第 9 章的回归集循环都是为此）。

四、一次完整调用（预览）

// POST https://api.typesafe.ai/v1/systemone
{
  "model": "jev-latest",
  "state": {
    "ticket": { "subject": "Stripe 连接失败", "body": "试了三天，客户付不了款，每小时都在损失", "tier": "paid" }
  },
  "questions": {
    "is_urgent": {
      "type": "noul",
      "instructions": "`ticket.body` 表达了紧迫性或时间敏感性"
    },
    "route": {
      "type": "choice",
      "instructions": "该工单应路由到哪个团队",
      "criteria": { "billing": "计费与支付问题", "technical": "产品故障", "other": "以上皆非" }
    }
  }
}
// 响应（示意）：
// "is_urgent": {"noul": 0.97}
// "route": {"choice": "billing", "probabilities": {...}, "confidence": 0.8}
​

两个问题并行求值、一次返回——这是 Jev 扇出经济学（第 5.1 节）的基础。

本节要点回顾

1. 输入：state（模型看到的世界，优先用对象）+ questions（你命名的问题 + 类型 + 判别标准 + 答案空间）。
2. 输出：答案必落在声明的空间内，且自带校准概率。
3. "不能幻觉"：结构保证形状安全；不保证判断正确——schema 设计因此成为一等技能。

骨架清楚了，但什么任务适合塞进这个骨架？下一节给出全书第一使用心法：选牌，不报牌名。