概述

Typing Indicators(打字指示器)在 run 活跃期间向 chat channel 发送”正在输入”信号。通过 agents.defaults.typingMode 控制何时开始,typingIntervalSeconds 控制刷新频率。

核心要点

默认行为(未设置 typingMode 时):

  • 直接聊天:model loop 开始时立即发送
  • 有 mention 的群聊:立即发送
  • 无 mention 的群聊:消息文本开始流式传输时才发送
  • Heartbeat runs:heartbeat run 开始时发送(如果目标支持打字)

typingMode 可选值(从最晚到最早触发):

  • never:永不发送
  • message:第一个非静默文本 delta 时发送(忽略 NO_REPLY token)
  • 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
  }
}

相关页面

  • presence - Gateway 在线状态与客户端可见性
  • streaming - 出站流式传输与 chunking
  • messages - 消息处理流水线