概念内部机制

输入状态指示器

运行处于活动状态时，会向聊天渠道发送“正在输入”指示。使用 agents.defaults.typingMode 控制何时开始显示正在输入状态，使用 typingIntervalSeconds 控制其多久刷新一次（保活频率，默认为 6 秒）。

默认值

当 agents.defaults.typingMode 未设置时：

直接聊天：模型循环开始后立即显示正在输入状态。
带提及的群聊：立即显示正在输入状态。
不带提及的群聊：当已准入的运行出现用户可见活动时开始显示正在输入状态，例如 harness 执行活动或消息文本。
Heartbeat 运行：Heartbeat 运行开始时显示正在输入状态，前提是解析后的 Heartbeat 目标是支持正在输入状态的聊天，并且该状态未被禁用。

将 agents.defaults.typingMode 设置为以下值之一：

never - 永不显示正在输入指示。
instant - 模型循环一开始就显示正在输入状态，即使该运行随后仅返回静默回复令牌。
thinking - 在出现第一个推理增量时开始显示正在输入状态，或在轮次被接受后进行活跃的 harness 执行时开始显示。
message - 在出现第一个用户可见的回复活动时开始显示正在输入状态，例如活跃的 harness 执行或非静默文本增量。NO_REPLY 等静默回复令牌不计为文本活动。

按“触发早晚”排序：never -> message/thinking -> instant。

设置智能体级默认值：

json5

{  agents: {    defaults: {      typingMode: "thinking",      typingIntervalSeconds: 6,    },  },}

按会话覆盖模式或频率：

json5

{  session: {    typingMode: "message",    typingIntervalSeconds: 4,  },}

message 模式不会因静默回复令牌而启动，但在任何助手文本可用之前，活跃的执行仍可能显示正在输入状态。
thinking 仍会响应流式推理（reasoningLevel: "stream"），也可以在推理增量到达之前因活跃的执行而启动。
Heartbeat 的正在输入状态是解析后的投递目标的活跃性信号。它在 Heartbeat 运行开始时启动，而不是遵循 message 或 thinking 的流式时序。设置 typingMode: "never" 可将其禁用。
当 Heartbeat 目标为 "none"、目标无法解析、Heartbeat 的聊天投递已禁用，或渠道不支持正在输入状态时，Heartbeat 不会显示正在输入状态。
typingIntervalSeconds 控制刷新频率，而非开始时间。默认值：6 秒。