agents.defaults.typingMode で、どの頻度で更新するかは typingIntervalSeconds で制御します(キープアライブ間隔、デフォルトは 6 秒)。
デフォルト
agents.defaults.typingMode が未設定の場合:
- ダイレクトチャット:モデルループが開始すると、入力中表示が即座に開始されます。
- メンションありのグループチャット:入力中表示が即座に開始されます。
- メンションなしのグループチャット:許可された実行で、ハーネスの実行アクティビティやメッセージテキストなど、ユーザーに見えるアクティビティが発生すると入力中表示が開始されます。
- Heartbeat 実行:解決された Heartbeat の送信先が入力中表示に対応するチャットであり、入力中表示が無効化されていない場合、Heartbeat 実行の開始時に入力中表示が開始されます。
モード
agents.defaults.typingMode を次のいずれかに設定します:
never- 入力中インジケーターを一切表示しません。instant- 後で実行がサイレント応答トークンのみを返す場合でも、モデルループが開始するとすぐに入力中表示を開始します。thinking- 最初の推論差分、またはターンが受理された後のアクティブなハーネス実行時に入力中表示を開始します。message- アクティブなハーネス実行やサイレントではないテキスト差分など、ユーザーに見える最初の応答アクティビティで入力中表示を開始します。NO_REPLYなどのサイレント応答トークンは、テキストアクティビティとしてカウントされません。
never -> message/thinking -> instant。
設定
エージェントレベルのデフォルトを設定します:注意事項
messageモードはサイレント応答トークンでは開始されませんが、アクティブな実行により、アシスタントのテキストが利用可能になる前でも入力中表示が行われることがあります。thinkingはストリーミングされた推論(reasoningLevel: "stream")にも反応し、推論差分が到着する前にアクティブな実行によって開始されることもあります。- Heartbeat の入力中表示は、解決された送信先に対する稼働中シグナルです。
messageまたはthinkingのストリームタイミングに従うのではなく、Heartbeat 実行の開始時に開始されます。無効にするにはtypingMode: "never"を設定します。 - Heartbeat の送信先が
"none"の場合、送信先を解決できない場合、Heartbeat のチャット送信が無効な場合、またはチャンネルが入力中表示をサポートしていない場合、Heartbeat は入力中表示を行いません。 agents.defaults.typingIntervalSecondsは、開始時刻ではなく、すべてのエージェントの更新間隔を制御します。デフォルト:6 秒。
関連項目
プレゼンス
Gateway が Control UI の Devices ページと macOS の Instances タブのために、接続中のクライアントを追跡する仕組み。
ストリーミングとチャンク分割
送信ストリーミングの動作、チャンク境界、チャンネル固有の配信。