​

Streaming y fragmentación

• Streaming por bloques (canales): emite bloques completados mientras el asistente escribe. 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 de 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 y máximos + preferencia de corte.
• channel send: mensajes salientes reales (respuestas por bloques).

• agents.defaults.blockStreamingDefault: "on"/"off" (predeterminado: desactivado).
• 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 rígido del canal: *.textChunkLimit (por ejemplo, channels.whatsapp.textChunkLimit).
• Modo de fragmentación del canal: *.chunkMode (length predeterminado, 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 (predeterminado: 17) divide respuestas altas para evitar recortes de la interfaz.

• text_end: transmite bloques tan pronto como los emite el chunker; vacía en cada text_end.
• message_end: espera a que termine el mensaje del asistente y luego vacía la salida en búfer.

​

Algoritmo de fragmentación (límites bajos/altos)

• Límite bajo: no emite hasta que el búfer sea >= minChars (salvo que se fuerce).
• Límite alto: prefiere cortes antes de maxChars; si se fuerza, corta en maxChars.
• Preferencia de corte: paragraph → newline → sentence → whitespace → corte rígido.
• Bloques de código: nunca se dividen 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 vacían si lo superan.
• minChars evita enviar fragmentos muy pequeños 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 configuraciones por cuenta).
• El valor predeterminado de coalescencia minChars aumenta a 1500 para Signal/Slack/Discord salvo que se anule.

​

Ritmo humano entre bloques

• Configuración: agents.defaults.humanDelay (anular por agente mediante agents.list[].humanDelay).
• Modos: off (predeterminado), natural (800–2500 ms), custom (minMs/maxMs).
• Se aplica solo a respuestas por bloques, no a respuestas finales ni a 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 por el texto más reciente.
• block: la vista previa se actualiza en pasos fragmentados o anexados.
• progress: vista previa de progreso/estado durante la generación, respuesta final al completarse.

​

Asignación por canal

• channels.slack.nativeStreaming alterna llamadas a la API nativa de streaming de Slack cuando streaming=partial (predeterminado: true).

• 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 al enum streaming; el booleano streaming migra automáticamente a nativeStreaming.

​

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 doble streaming).
• /reasoning stream puede escribir razonamiento en la vista previa.

• Usa mensajes de vista previa con 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 la API nativa de streaming 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

• Messages — ciclo de vida y entrega de mensajes
• Retry — comportamiento de reintento en fallos de entrega
• Channels — compatibilidad de streaming por canal