思考级别(/think 指令)
它的作用
- 任何入站消息体中的内联指令:/t <level>、/think:<level> 或 /thinking <level>。
- 级别(别名):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/*)仅支持二进制思考(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:)不带参数以查看当前思考级别。
Agent 应用
- 嵌入式 Pi:解析的级别传递给进程内 Pi agent 运行时。
详细指令(/verbose 或 /v)
- 级别:on(最小)| full | off(默认)。
- 仅指令消息切换会话详细模式并回复 Verbose logging enabled. / Verbose logging disabled.;无效级别返回提示而不改变状态。
- /verbose off 存储显式的会话覆盖;通过会话 UI 选择 inherit 清除它。
- 内联指令仅影响该消息;否则应用会话/全局默认值。
- 发送 /verbose(或 /verbose:)不带参数以查看当前详细级别。
- 当详细模式开启时,发出结构化工具结果的 agent(Pi,其他 JSON agent)将每个工具调用作为其自己的纯元数据消息发送回来,在可用时以 <emoji> <tool-name>: <arg> 为前缀(路径/命令)。这些工具摘要在每个工具启动时立即发送(单独的气泡),而不是流式增量。
- 当详细模式为 full 时,工具输出在完成后也会转发(单独的气泡,截断到安全长度)。如果你在运行过程中切换 /verbose on|full|off,后续的工具气泡会遵守新设置。
推理可见性(/reasoning)
- 级别:on|off|stream。
- 仅指令消息切换是否在回复中显示思考块。
- 启用时,推理作为单独的消息发送,以 Reasoning: 为前缀。
- stream(仅限 Telegram):在回复生成时将推理流式传输到 Telegram 草稿气泡,然后发送不带推理的最终答案。
- 别名:/reason。
- 发送 /reasoning(或 /reasoning:)不带参数以查看当前推理级别。
相关
- 提升模式文档位于 Elevated mode。
心跳
- 心跳探测主体是配置的心跳提示(默认:Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.)。心跳消息中的内联指令照常应用(但避免从心跳更改会话默认值)。
- 心跳传递默认仅传递最终有效负载。要同时发送单独的 Reasoning: 消息(如果可用),设置 agents.defaults.heartbeat.includeReasoning: true 或按 agent 设置 agents.list[].heartbeat.includeReasoning: true。
Web 聊天 UI
- Web 聊天思考选择器在页面加载时从入站会话存储/配置镜像会话存储的级别。
- 选择另一个级别仅应用于下一条消息(thinkingOnce);发送后,选择器会跳回到存储的会话级别。
- 要更改会话默认值,发送 /think:<level> 指令(如前所述);选择器将在下次重新加载后反映它。