入力中インジケーター

実行中は、チャットチャンネルに入力中インジケーターが送信されます。入力中表示をいつ開始するかは agents.defaults.typingMode で、どの頻度で更新するかは typingIntervalSeconds で制御します（キープアライブ間隔、デフォルトは 6 秒）。

デフォルト

agents.defaults.typingMode が未設定の場合：

• ダイレクトチャット：モデルループが開始すると、入力中表示が即座に開始されます。
• メンションありのグループチャット：入力中表示が即座に開始されます。
• メンションなしのグループチャット：許可された実行で、ハーネスの実行アクティビティやメッセージテキストなど、ユーザーに見えるアクティビティが発生すると入力中表示が開始されます。
• Heartbeat 実行：解決された Heartbeat の送信先が入力中表示に対応するチャットであり、入力中表示が無効化されていない場合、Heartbeat 実行の開始時に入力中表示が開始されます。

モード

agents.defaults.typingMode を次のいずれかに設定します：

• never - 入力中インジケーターを一切表示しません。
• instant - 後で実行がサイレント応答トークンのみを返す場合でも、モデルループが開始するとすぐに入力中表示を開始します。
• thinking - 最初の推論差分、またはターンが受理された後のアクティブなハーネス実行時に入力中表示を開始します。
• message - アクティブなハーネス実行やサイレントではないテキスト差分など、ユーザーに見える最初の応答アクティビティで入力中表示を開始します。NO_REPLY などのサイレント応答トークンは、テキストアクティビティとしてカウントされません。

「どの程度早く作動するか」の順序：never -> message/thinking -> instant。

設定

エージェントレベルのデフォルトを設定します：

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

1 つのエージェントについてポリシーを上書きします：

{  agents: {    entries: {      support: {        typingMode: "message",      },    },  },}

注意事項

• message モードはサイレント応答トークンでは開始されませんが、アクティブな実行により、アシスタントのテキストが利用可能になる前でも入力中表示が行われることがあります。
• thinking はストリーミングされた推論（reasoningLevel: "stream"）にも反応し、推論差分が到着する前にアクティブな実行によって開始されることもあります。
• Heartbeat の入力中表示は、解決された送信先に対する稼働中シグナルです。message または thinking のストリームタイミングに従うのではなく、Heartbeat 実行の開始時に開始されます。無効にするには typingMode: "never" を設定します。
• Heartbeat の送信先が "none" の場合、送信先を解決できない場合、Heartbeat のチャット送信が無効な場合、またはチャンネルが入力中表示をサポートしていない場合、Heartbeat は入力中表示を行いません。
• agents.defaults.typingIntervalSeconds は、開始時刻ではなく、すべてのエージェントの更新間隔を制御します。デフォルト：6 秒。

関連項目