Streaming de Clawdbot

Aprende sobre las respuestas en streaming del asistente de IA Clawdbot, chunking, indicadores de escritura y entrega de mensajes en tiempo real.

Resumen de Streaming de Clawdbot

Clawdbot soporta respuestas en streaming para interacciones de IA en tiempo real. El streaming permite indicadores de escritura, actualizaciones parciales de mensajes y entrega por chunks para respuestas largas.

Modos de Streaming

Streaming Completo

El streaming completo entrega tokens a medida que se generan:

{
  "streaming": {
    "mode": "full",
    "chunkSize": 50
  }
}

Entrega por Chunks

La entrega por chunks divide respuestas largas:

{
  "streaming": {
    "mode": "chunked",
    "maxLength": 4000,
    "delimiter": "\n\n"
  }
}

Soporte de Proveedores

ProveedorStreamingEscrituraChunking
WhatsAppParcial
TelegramCompleto
DiscordCompleto
WeChatNoNo
FeishuParcial

Indicadores de Escritura

Configuración

{
  "typing": {
    "enabled": true,
    "interval": 3000,
    "stopOnComplete": true
  }
}

Comportamiento

  • Indicadores enviados cada interval ms
  • Se detienen automáticamente al completar la respuesta
  • Implementación específica por proveedor

Chunking de Mensajes

¿Por Qué Chunking?

  • Límites de longitud de mensajes de la plataforma
  • Mejor experiencia de usuario
  • Menor riesgo de timeout

Configuración de Chunks

AjustePor DefectoDescripción
maxLength4000Máximo de caracteres por chunk
delimiter\n\nPunto de división preferido
delay500Ms entre chunks

Ejemplo

Respuesta larga dividida automáticamente:

[Chunk 1] First part of response...

[Chunk 2] Continuation...

[Chunk 3] Final part...

Eventos de Stream

Tipos de Eventos

EventoDescripción
stream_startEl streaming comenzó
stream_chunkNuevo chunk de contenido
stream_endStreaming completado
stream_errorOcurrió un error

Eventos WebSocket

ws.on('message', (data) => {
  const event = JSON.parse(data);

  switch(event.type) {
    case 'stream_start':
      // Show typing indicator
      break;
    case 'stream_chunk':
      // Append content
      break;
    case 'stream_end':
      // Hide typing indicator
      break;
  }
});

Gestión del Buffer

Configuración

{
  "buffer": {
    "maxSize": 10000,
    "flushInterval": 100,
    "strategy": "adaptive"
  }
}

Estrategias

EstrategiaDescripción
immediateEnviar cada token inmediatamente
batchedAgrupar tokens por intervalo
adaptiveAjustar según la red

Manejo de Errores

Reintento en Error de Stream

{
  "streaming": {
    "retry": {
      "enabled": true,
      "maxAttempts": 3,
      "backoff": "exponential"
    }
  }
}

Fallback a No-Streaming

Si el streaming falla, Clawdbot recurre automáticamente a la entrega sin streaming.

Consejos de Rendimiento

  1. Ajusta el tamaño del chunk según los límites del proveedor
  2. Habilita indicadores de escritura para mejor UX
  3. Usa buffering adaptativo para redes variables
  4. Monitoriza la latencia del stream para optimización

Próximos Pasos