Typing Indicators

“打字指示器”就是当机器人朋友在思考或准备说话时，在聊天窗口里显示的“对方正在输入…”的小提示。这就像你和朋友发消息时，能看到他正在打字一样。

你可以通过两个小开关来控制这个提示：

1. agents.defaults.typingMode：这个开关决定“什么时候”开始显示“正在输入”的提示。
2. typingIntervalSeconds：这个开关决定提示闪动的“快慢”，就像心跳的节奏一样。

如果你没有设置第一个开关，机器人会按照以前的老办法来：

• 如果是和机器人单独聊天，或者在一个群里@了它，它一开动脑筋就会立刻显示“正在输入”。
• 如果在一个群里但没有@它，它要等到真正开始打出文字时，才会显示提示。
• 有一种叫“心跳”的特殊任务，是永远不会显示这个提示的。

第一个开关typingMode有四个选项，你可以选一个：

• never：意思是“永远不”，就像把提示灯关掉了，永远不显示。
• instant：意思是“立刻”，机器人一开始思考，哪怕最后它什么也不说，也会立刻亮起提示灯。
• thinking：意思是“思考时”，只有当机器人开始“自言自语”地推理时（这需要另一个叫reasoningLevel: "stream"的开关打开），才会亮灯。
• message：意思是“说话时”，只有当机器人开始打出真正的文字时，才会亮灯。

这四个选项，按亮灯“从晚到早”的顺序排队是：never → message → thinking → instant。

设置的方法就像搭积木。下面是一个例子，告诉机器人平时怎么工作：

agent: {
  typingMode: "thinking",
  typingIntervalSeconds: 6,
}

这表示：默认在“思考时”亮灯，并且让提示灯每6秒钟闪动一下。

你还可以在每次聊天时，单独告诉机器人这次怎么做，这会覆盖掉上面的默认设置：

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

这表示：这次聊天，改成在“说话时”才亮灯，并且让提示灯闪得快一点，每4秒一次。

最后，有几个重要的提醒要记好：

• 如果选了message模式，但机器人最后只发了一个“沉默”的信号（比如NO_REPLY，意思是不回复），那么提示灯是不会亮的。
• 如果选了thinking模式，必须同时打开让机器人“自言自语”的开关（reasoningLevel: "stream"），提示灯才会在思考时亮起。如果机器人不“自言自语”，灯就不会亮。
• 那种叫“心跳”的特殊任务，不管选什么模式，都永远不会显示打字提示。
• typingIntervalSeconds这个数字只控制提示灯闪动的“节奏快慢”，不控制它“什么时候开始亮”。默认的节奏是每6秒闪一下。