​

Streaming + fragmentação

• Streaming em blocos (canais): emite blocos concluídos conforme o assistente escreve. Essas são mensagens normais do canal (não deltas de token).
• Streaming de prévia (Telegram/Discord/Slack): atualiza uma mensagem de prévia temporária durante a geração.

​

Streaming em blocos (mensagens do 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 de stream do modelo (podem ser esparsos para modelos sem streaming).
• chunker: EmbeddedBlockChunker aplicando limites mínimos/máximos + preferência de quebra.
• channel send: mensagens de saída reais (respostas em bloco).

• agents.defaults.blockStreamingDefault: "on"/"off" (padrão: desativado).
• Sobrescritas por canal: *.blockStreaming (e variantes por conta) para forçar "on"/"off" por canal.
• agents.defaults.blockStreamingBreak: "text_end" ou "message_end".
• agents.defaults.blockStreamingChunk: { minChars, maxChars, breakPreference? }.
• agents.defaults.blockStreamingCoalesce: { minChars?, maxChars?, idleMs? } (mescla blocos transmitidos antes do envio).
• Limite rígido do canal: *.textChunkLimit (por exemplo, channels.whatsapp.textChunkLimit).
• Modo de fragmentação do canal: *.chunkMode (length por padrão, newline divide em linhas em branco [limites de parágrafo] antes da fragmentação por comprimento).
• Limite flexível do Discord: channels.discord.maxLinesPerMessage (padrão: 17) divide respostas altas para evitar corte na UI.

• text_end: transmite blocos assim que o chunker os emite; descarrega em cada text_end.
• message_end: espera até que a mensagem do assistente termine e, então, descarrega a saída em buffer.

​

Algoritmo de fragmentação (limites baixo/alto)

• Limite baixo: não emite até que o buffer >= minChars (a menos que seja forçado).
• Limite alto: prefere divisões antes de maxChars; se forçado, divide em maxChars.
• Preferência de quebra: paragraph → newline → sentence → whitespace → quebra rígida.
• Blocos de código: nunca divide dentro de blocos; quando é forçado em maxChars, fecha + reabre o bloco para manter o Markdown válido.

​

Coalescência (mesclar blocos transmitidos)

• A coalescência espera por intervalos de inatividade (idleMs) antes de descarregar.
• Os buffers são limitados por maxChars e serão descarregados se o excederem.
• minChars evita que fragmentos muito pequenos sejam enviados até que texto suficiente se acumule (o descarregamento final sempre envia o texto restante).
• O joiner é derivado de blockStreamingChunk.breakPreference (paragraph → \n\n, newline → \n, sentence → espaço).
• Sobrescritas por canal estão disponíveis via *.blockStreamingCoalesce (incluindo configs por conta).
• O valor padrão de coalescência minChars é elevado para 1500 em Signal/Slack/Discord, a menos que seja sobrescrito.

​

Ritmo humano entre blocos

• Configuração: agents.defaults.humanDelay (sobrescreva por agente via agents.list[].humanDelay).
• Modos: off (padrão), natural (800–2500ms), custom (minMs/maxMs).
• Aplica-se apenas a respostas em bloco, não a respostas finais nem a resumos de ferramentas.

​

”Transmitir fragmentos ou tudo”

• Transmitir fragmentos: blockStreamingDefault: "on" + blockStreamingBreak: "text_end" (emite conforme avança). Canais que não sejam Telegram também precisam de *.blockStreaming: true.
• Transmitir tudo no final: blockStreamingBreak: "message_end" (descarrega uma vez, possivelmente em vários fragmentos se for muito longo).
• Sem streaming em blocos: blockStreamingDefault: "off" (apenas resposta final).

​

Modos de streaming de prévia

• off: desativa o streaming de prévia.
• partial: uma única prévia que é substituída pelo texto mais recente.
• block: atualizações de prévia em etapas fragmentadas/anexadas.
• progress: prévia de progresso/status durante a geração, resposta final ao concluir.

​

Mapeamento por canal

• channels.slack.streaming.nativeTransport alterna chamadas da API nativa de streaming do Slack quando channels.slack.streaming.mode="partial" (padrão: true).
• O streaming nativo do Slack e o status de thread do assistente no Slack exigem um destino de thread de resposta; DMs de nível superior não mostram essa prévia no estilo de thread.

• Telegram: streamMode + booleano streaming são migrados automaticamente para o enum streaming.
• Discord: streamMode + booleano streaming são migrados automaticamente para o enum streaming.
• Slack: streamMode é migrado automaticamente para streaming.mode; o booleano streaming é migrado automaticamente para streaming.mode mais streaming.nativeTransport; o legado nativeStreaming é migrado automaticamente para streaming.nativeTransport.

​

Comportamento em tempo de execução

• Usa atualizações de prévia com sendMessage + editMessageText em DMs e grupos/tópicos.
• O streaming de prévia é ignorado quando o streaming em blocos do Telegram está explicitamente ativado (para evitar streaming duplo).
• /reasoning stream pode gravar o raciocínio na prévia.

• Usa mensagens de prévia com envio + edição.
• O modo block usa fragmentação de rascunho (draftChunk).
• O streaming de prévia é ignorado quando o streaming em blocos do Discord está explicitamente ativado.

• partial pode usar o streaming nativo do Slack (chat.startStream/append/stop) quando disponível.
• block usa prévias de rascunho no estilo append.
• progress usa texto de prévia de status e, depois, a resposta final.

​

Relacionado

• Mensagens — ciclo de vida e entrega de mensagens
• Retry — comportamento de repetição em falhas de entrega
• Canais — suporte a streaming por canal