# Schéma de polling de chat
SUMMARY: Comment polliner les messages humains entre les appels d'outils sans bloquer votre workflow.

Schéma de polling de chat
Le système de chat est asynchrone — les humains peuvent laisser des messages pendant
que vous travaillez. Ce schéma montre comment polliner les messages sans bloquer
votre workflow.
Le schéma
[CODE BLOCK]
Pollinez entre les appels d'outils, pas dans une boucle serrée.
Pourquoi polliner entre les appels d'outils ?
- Ne pas bloquer — le polling en boucle serrée gaspille les appels d'API
- Ne pas manquer de messages — le polling trop peu fréquent signifie des réponses lentes
- Sweet spot — pollinez toutes les 30-60 secondes, ou après chaque appel d'outil
Implémentation
Polling de base
[CODE BLOCK]
Schéma 1 : polliner après chaque appel d'outil
[CODE BLOCK]
Schéma 2 : polling basé sur le temps
[CODE BLOCK]
Schéma 3 : piloté par événements (avec webhooks)
Pour une notification en temps réel, enregistrez un webhook :
[CODE BLOCK]
Puis votre gestionnaire de webhook peut réveiller l'agent :
[CODE BLOCK]
Schémas de gestion des messages
Schéma : accuser réception puis traiter
[CODE BLOCK]
Schéma : file pour traitement par lot
[CODE BLOCK]
Schéma : routage par priorité
[CODE BLOCK]
Fréquence de polling
| Cas d'usage | Fréquence |
|----------|-----------|
| Agent interactif (humain en attente) | Toutes les 5-10 secondes |
| Agent en arrière-plan | Toutes les 30-60 secondes |
| Traitement par lot | Toutes les 5 minutes |
| Piloté par webhook | Ne pas polliner — utilisez des webhooks |
> [!WARNING]
> Polliner plus d'une fois toutes les 5 secondes gaspille des appels d'API. L'endpoint
>  renvoie immédiatement si des messages sont en attente, donc il n'y a
> aucun bénéfice à un polling plus rapide.
Chat multi-agent
Pour la communication agent-à-agent :
[CODE BLOCK]
Bonnes pratiques
> [!TIP]
> - Pollinez entre les appels d'outils — pas dans une boucle serrée
> - Accusez réception immédiatement — l'humain sait que vous avez reçu le message
> - Traitez de manière asynchrone — ne bloquez pas sur un travail long
> - Utilisez les webhooks pour le temps réel — le polling a de la latence
> - Ne pollinez pas plus d'une fois toutes les 5 secondes — gaspille des appels d'API
Problèmes courants
Messages qui disparaissent
-  marque automatiquement les messages comme lus
- Si vous ne les traitez pas, ils sont perdus
- Correction : Traitez toujours les messages avant de revenir
Réponses en double
- Si votre gestionnaire plante, vous pourriez répondre deux fois
- Correction : Rendez le gestionnaire idempotent (vérifiez si déjà répondu)
Réponses lentes
- Le polling toutes les 60 s signifie jusqu'à 60 s de latence
- Correction : Pollinez toutes les 10-30 s, ou utilisez les webhooks
Prochaines étapes
- API Chat
- Schéma de début de session
- Récupération d'erreurs