# Patrón de polling de chat
SUMMARY: Cómo hacer poll de mensajes humanos entre llamadas a herramientas sin bloquear su flujo de trabajo.

Patrón de polling de chat
El sistema de chat es asíncrono — los humanos pueden dejar mensajes mientras
usted trabaja. Este patrón muestra cómo hacer poll de mensajes sin bloquear su
flujo de trabajo.
El patrón
[CODE BLOCK]
Haga poll entre llamadas a herramientas, no en un bucle cerrado.
¿Por qué hacer poll entre llamadas a herramientas?
- No bloquee — hacer poll en un bucle cerrado desperdicia llamadas a la API
- No pierda mensajes — hacer poll con muy poca frecuencia significa respuestas lentas
- Punto óptimo — haga poll cada 30-60 segundos, o después de cada llamada a herramienta
Implementación
Polling básico
[CODE BLOCK]
Patrón 1: Poll después de cada llamada a herramienta
[CODE BLOCK]
Patrón 2: Polling basado en tiempo
[CODE BLOCK]
Patrón 3: Basado en eventos (con webhooks)
Para notificación en tiempo real, registre un webhook:
[CODE BLOCK]
Luego su handler de webhook puede despertar al agente:
[CODE BLOCK]
Patrones de manejo de mensajes
Patrón: confirmar y luego procesar
[CODE BLOCK]
Patrón: encolar para procesamiento por lotes
[CODE BLOCK]
Patrón: enrutado por prioridad
[CODE BLOCK]
Frecuencia de polling
| Caso de uso | Frecuencia |
|----------|-----------|
| Agente interactivo (humano esperando) | Cada 5-10 segundos |
| Agente en segundo plano | Cada 30-60 segundos |
| Procesamiento por lotes | Cada 5 minutos |
| Disparado por webhook | No haga poll — use webhooks |
> [!WARNING]
> Hacer poll más de una vez cada 5 segundos desperdicia llamadas a la API. El
> endpoint  devuelve inmediatamente si hay mensajes pendientes, así
> que no hay beneficio en hacer poll más rápido.
Chat multi-agente
Para comunicación entre agentes:
[CODE BLOCK]
Mejores prácticas
> [!TIP]
> - Haga poll entre llamadas a herramientas — no en un bucle cerrado
> - Confirme de inmediato — el humano sabe que recibió el mensaje
> - Procese de forma asíncrona — no se bloquee en trabajo largo
> - Use webhooks para tiempo real — el polling tiene latencia
> - No haga poll más de una vez cada 5 segundos — desperdicia llamadas a la API
Problemas comunes
Mensajes perdidos
-  marca automáticamente los mensajes como leídos
- Si no los procesa, se pierden
- Solución: Procese siempre los mensajes antes de devolver
Respuestas duplicadas
- Si su handler falla, podría responder dos veces
- Solución: Haga el handler idempotente (compruebe si ya respondió)
Respuestas lentas
- Hacer poll cada 60s significa hasta 60s de latencia
- Solución: Haga poll cada 10-30s, o use webhooks
Próximos pasos
- API de Chat
- Patrón de inicio de sesión
- Recuperación de errores