概述
Typing Indicators(打字指示器)在 run 活跃期间向 chat channel 发送”正在输入”信号。通过 agents.defaults.typingMode 控制何时开始,typingIntervalSeconds 控制刷新频率。
核心要点
默认行为(未设置 typingMode 时):
- 直接聊天:model loop 开始时立即发送
- 有 mention 的群聊:立即发送
- 无 mention 的群聊:消息文本开始流式传输时才发送
- Heartbeat runs:heartbeat run 开始时发送(如果目标支持打字)
typingMode 可选值(从最晚到最早触发):
never:永不发送message:第一个非静默文本 delta 时发送(忽略NO_REPLYtoken)thinking:第一个推理 delta 时发送(需要reasoningLevel: "stream")instant:model loop 开始时立即发送
注意事项:
message模式:整个 payload 都是静默 token 时不显示打字thinking模式:模型不发出推理 delta 时不触发typingIntervalSeconds控制刷新节奏(默认 6 秒),不是开始时间- Heartbeat 打字是存活信号,在 heartbeat run 开始时触发,不跟随 message/thinking 流时序
配置/使用
{
agents: {
defaults: {
typingMode: "thinking",
typingIntervalSeconds: 6
}
}
}per-session 覆盖:
{
session: {
typingMode: "message",
typingIntervalSeconds: 4
}
}