輸入指示器

​

預設值

• 直接聊天：模型迴圈開始後，輸入狀態會立即開始。
• 含提及的群組聊天：輸入狀態會立即開始。
• 不含提及的群組聊天：當已准入的執行有使用者可見活動時，輸入狀態會開始，例如 harness 執行活動或訊息文字。
• 心跳偵測執行：如果解析出的心跳偵測目標是支援輸入狀態的聊天，且輸入狀態未停用，輸入狀態會在心跳偵測執行開始時開始。

​

模式

• never - 永遠不顯示輸入指示器。
• instant - 模型迴圈一開始就開始輸入狀態，即使該執行稍後只回傳靜默回覆權杖。
• thinking - 在第一個推理增量時開始輸入狀態，或在該輪次被接受後的作用中 harness 執行時開始。
• message - 在第一個使用者可見的回覆活動時開始輸入狀態，例如作用中 harness 執行或非靜默文字增量。像 NO_REPLY 這類靜默回覆權杖不算文字活動。

​

設定

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

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

​

注意事項

• message 模式不會從靜默回覆權杖開始，但作用中執行仍可能在任何助理文字可用前顯示輸入狀態。
• thinking 仍會回應串流推理（reasoningLevel: "stream"），也可以在推理增量抵達前，從作用中執行開始。
• 心跳偵測輸入狀態是解析出的傳遞目標的存活訊號。它會在心跳偵測執行開始時開始，而不是遵循 message 或 thinking 的串流時機。設定 typingMode: "never" 可停用它。
• 當心跳偵測目標是 "none"、目標無法解析、該心跳偵測的聊天傳遞已停用，或頻道不支援輸入狀態時，心跳偵測不會顯示輸入狀態。
• typingIntervalSeconds 控制的是重新整理節奏，不是開始時間。預設：6 秒。

​

相關