思考级别(/think 指令)
作用
- 任意入站正文中的行内指令:
/t <级别>、/think:<级别>或/thinking <级别>。 - 级别(别名):
off | minimal | low | medium | high | xhigh(仅 GPT-5.2 + Codex 模型)- minimal → “think”
- low → “think hard”
- medium → “think harder”
- high → “ultrathink”(最大预算)
- xhigh → “ultrathink+”(仅 GPT-5.2 + Codex 模型)
highest、max映射为high。
- 提供商说明:Z.AI(
zai/*)仅支持二值 thinking(on/off)。任何非off级别均视为on(映射为low)。
解析顺序
- 消息中的行内指令(仅对该条消息)。
- 发送仅含指令的消息所设的会话覆盖。
- 全局默认(配置中的
agents.defaults.thinkingDefault)。 - 回退:具备推理能力的模型为 low,否则为 off。
设置会话默认
- 发送仅含该指令的消息(可含空白),例如
/think:medium或/t high。 - 对当前会话生效(默认按发送方);通过
/think:off或会话空闲重置清除。 - 会发送确认回复(
Thinking level set to high./Thinking disabled.)。若级别无效(如/thinking big),命令会被拒绝并提示,会话状态不变。 - 发送
/think(或/think:)且无参数可查看当前思考级别。
按代理应用
- 内嵌 Pi:解析出的级别传给进程内 Pi 代理运行时。
详细指令(/verbose 或 /v)
- 级别:
on(最小)|full|off(默认)。 - 仅含指令的消息切换会话 verbose 并回复
Verbose logging enabled./Verbose logging disabled.;无效级别返回提示且不改变状态。 /verbose off存储显式会话覆盖;可在 Sessions UI 中选择inherit清除。- 行内指令仅对该条消息生效;会话/全局默认其余适用。
- 发送
/verbose(或/verbose:)且无参数可查看当前 verbose 级别。 - verbose 开启时,发出结构化工具结果的代理(Pi 等)将每次工具调用作为单独的仅元数据消息发回,有路径/命令时带
<emoji> <tool-name>: <arg>前缀。这些工具摘要随每次工具启动立即发送(独立气泡),而非流式增量。 - verbose 为
full时,工具输出在完成后也会转发(独立气泡,截断到安全长度)。若在运行中切换/verbose on|full|off,后续工具气泡按新设置。
推理可见性(/reasoning)
- 级别:
on|off|stream。 - 仅含指令的消息切换是否在回复中显示思考块。
- 开启时,推理作为单独消息发送,前缀为
Reasoning:。 stream(仅 Telegram):在生成回复时将推理流式写入 Telegram 草稿气泡,再发送最终答案且不含推理。- 别名:
/reason。 - 发送
/reasoning(或/reasoning:)且无参数可查看当前推理级别。
相关
- Elevated 模式文档见 Elevated 模式。
心跳
- 心跳探测正文为配置的心跳提示(默认:
Read HEARTBEAT.md if it exists (workspace context). Follow it strictly...)。心跳消息中的行内指令照常生效(但避免在心跳中修改会话默认)。 - 心跳投递默认仅发送最终负载。若也要发送单独的
Reasoning:消息(当存在时),设置agents.defaults.heartbeat.includeReasoning: true或每代理agents.list[].heartbeat.includeReasoning: true。
Web 聊天 UI
- Web 聊天中的 thinking 选择器在页面加载时从入站会话存储/配置读取并反映会话中存储的级别。
- 选择其他级别仅对下一条消息生效(thinkingOnce);发送后选择器恢复为存储的会话级别。
- 要修改会话默认,发送
/think:<级别>指令(同上);选择器在下次刷新后更新。
最后更新于: