​

Streaming + fragmentación

• Streaming por bloques (canales): emite bloques completados a medida que el asistente escribe. Estos son mensajes normales del canal (no deltas de tokens).
• Streaming de vista previa (Telegram/Discord/Slack): actualiza un mensaje de vista previa temporal mientras se genera.

​

Streaming por bloques (mensajes del canal)

Model output
  └─ text_delta/events
       ├─ (blockStreamingBreak=text_end)
       │    └─ chunker emits blocks as buffer grows
       └─ (blockStreamingBreak=message_end)
            └─ chunker flushes at message_end
                   └─ channel send (block replies)

• text_delta/events: eventos del stream del modelo (pueden ser escasos en modelos sin streaming).
• chunker: EmbeddedBlockChunker que aplica límites mínimos/máximos + preferencia de corte.
• channel send: mensajes salientes reales (respuestas por bloques).

• agents.defaults.blockStreamingDefault: "on"/"off" (on/off) (desactivado por defecto).
• Anulaciones por canal: *.blockStreaming (y variantes por cuenta) para forzar "on"/"off" por canal.
• agents.defaults.blockStreamingBreak: "text_end" o "message_end".
• agents.defaults.blockStreamingChunk: { minChars, maxChars, breakPreference? }.
• agents.defaults.blockStreamingCoalesce: { minChars?, maxChars?, idleMs? } (fusiona bloques transmitidos antes del envío).
• Límite estricto del canal: *.textChunkLimit (por ejemplo, channels.whatsapp.textChunkLimit).
• Modo de fragmentación del canal: *.chunkMode (length por defecto, newline divide en líneas en blanco (límites de párrafo) antes de fragmentar por longitud).
• Límite flexible de Discord: channels.discord.maxLinesPerMessage (17 por defecto) divide respuestas altas para evitar recortes en la UI.

• text_end: transmite bloques en cuanto el chunker los emite; vacía en cada text_end.
• message_end: espera a que termine el mensaje del asistente y luego vacía la salida almacenada.

​

Algoritmo de fragmentación (límites inferior/superior)

• Límite inferior: no emite hasta que el búfer sea >= minChars (salvo que se fuerce).
• Límite superior: prefiere cortes antes de maxChars; si se fuerza, corta en maxChars.
• Preferencia de corte: paragraph → newline → sentence → whitespace → corte forzado.
• Bloques de código: nunca divide dentro de bloques delimitados; cuando se fuerza en maxChars, cierra y vuelve a abrir el bloque para mantener Markdown válido.

​

Coalescencia (fusionar bloques transmitidos)

• La coalescencia espera intervalos de inactividad (idleMs) antes de vaciar.
• Los búferes están limitados por maxChars y se vaciarán si lo superan.
• minChars evita que se envíen fragmentos diminutos hasta que se acumule suficiente texto (el vaciado final siempre envía el texto restante).
• El separador se deriva de blockStreamingChunk.breakPreference (paragraph → \n\n, newline → \n, sentence → espacio).
• Las anulaciones por canal están disponibles mediante *.blockStreamingCoalesce (incluidas las configuraciones por cuenta).
• El valor predeterminado de coalescencia para minChars se eleva a 1500 para Signal/Slack/Discord, salvo que se anule.

​

Ritmo más humano entre bloques

• Configuración: agents.defaults.humanDelay (anulable por agente mediante agents.list[].humanDelay).
• Modos: off (predeterminado), natural (800–2500ms), custom (minMs/maxMs).
• Se aplica solo a las respuestas por bloques, no a las respuestas finales ni a los resúmenes de herramientas.

​

”Transmitir fragmentos o todo”

• Transmitir fragmentos: blockStreamingDefault: "on" + blockStreamingBreak: "text_end" (emitir sobre la marcha). Los canales que no son Telegram también necesitan *.blockStreaming: true.
• Transmitir todo al final: blockStreamingBreak: "message_end" (vaciar una vez, posiblemente en varios fragmentos si es muy largo).
• Sin streaming por bloques: blockStreamingDefault: "off" (solo respuesta final).

​

Modos de streaming de vista previa

• off: desactiva el streaming de vista previa.
• partial: una sola vista previa que se reemplaza con el texto más reciente.
• block: la vista previa se actualiza en pasos fragmentados/anexados.
• progress: vista previa de progreso/estado durante la generación, respuesta final al completarse.

​

Mapeo por canal

• channels.slack.streaming.nativeTransport alterna las llamadas a la API de streaming nativa de Slack cuando channels.slack.streaming.mode="partial" (predeterminado: true).
• El streaming nativo de Slack y el estado del hilo del asistente de Slack requieren un destino de hilo de respuesta; los mensajes directos de nivel superior no muestran esa vista previa estilo hilo.

• Telegram: streamMode + booleano streaming migran automáticamente al enum streaming.
• Discord: streamMode + booleano streaming migran automáticamente al enum streaming.
• Slack: streamMode migra automáticamente a streaming.mode; el booleano streaming migra automáticamente a streaming.mode más streaming.nativeTransport; el valor heredado nativeStreaming migra automáticamente a streaming.nativeTransport.

​

Comportamiento en tiempo de ejecución

• Usa actualizaciones de vista previa con sendMessage + editMessageText en mensajes directos y grupos/temas.
• El streaming de vista previa se omite cuando el streaming por bloques de Telegram está habilitado explícitamente (para evitar streaming doble).
• /reasoning stream puede escribir el razonamiento en la vista previa.

• Usa mensajes de vista previa de envío + edición.
• El modo block usa fragmentación de borrador (draftChunk).
• El streaming de vista previa se omite cuando el streaming por bloques de Discord está habilitado explícitamente.

• partial puede usar el streaming nativo de Slack (chat.startStream/append/stop) cuando está disponible.
• block usa vistas previas de borrador con estilo de anexado.
• progress usa texto de vista previa de estado y luego la respuesta final.

​

Relacionado

• Mensajes — ciclo de vida y entrega de mensajes
• Reintento — comportamiento de reintento en caso de fallo de entrega
• Canales — soporte de streaming por canal