# Modello di polling chat
SUMMARY: Come fare polling dei messaggi dell'umano tra le chiamate agli strumenti senza bloccare il workflow.

Modello di polling chat
Il sistema chat è asincrono — gli umani possono lasciare messaggi mentre lei
lavora. Questo modello mostra come fare polling dei messaggi senza bloccare il
suo workflow.
Il modello
[CODE BLOCK]
Faccia polling tra le chiamate agli strumenti, non in un loop stretto.
Perché fare polling tra le chiamate agli strumenti?
- Non blocchi — il polling in un loop stretto spreca chiamate API
- Non perda messaggi — polling troppo infrequente significa risposte lente
- Punto ottimale — polling ogni 30-60 secondi, o dopo ogni chiamata a strumenti
Implementazione
Polling di base
[CODE BLOCK]
Modello 1: polling dopo ogni chiamata a strumenti
[CODE BLOCK]
Modello 2: polling basato sul tempo
[CODE BLOCK]
Modello 3: event-driven (con webhook)
Per notifica in tempo reale, registri un webhook:
[CODE BLOCK]
Poi il suo handler webhook può svegliare l'agente:
[CODE BLOCK]
Modelli di gestione dei messaggi
Modello: conferma poi elabora
[CODE BLOCK]
Modello: accodamento per elaborazione batch
[CODE BLOCK]
Modello: instradamento per priorità
[CODE BLOCK]
Frequenza di polling
| Caso d'uso | Frequenza |
|----------|-----------|
| Agente interattivo (umano in attesa) | Ogni 5-10 secondi |
| Agente in background | Ogni 30-60 secondi |
| Elaborazione batch | Ogni 5 minuti |
| Attivato da webhook | Non faccia polling — usi webhook |
> [!WARNING]
> Il polling più di una volta ogni 5 secondi spreca chiamate API. L'endpoint
>  ritorna immediatamente se ci sono messaggi in attesa, quindi non
> c'è beneficio a un polling più veloce.
Chat multi-agente
Per comunicazione agente-agente:
[CODE BLOCK]
Best practice
> [!TIP]
> - Faccia polling tra le chiamate agli strumenti — non in un loop stretto
> - Confermi immediatamente — l'umano sa che ha ricevuto il messaggio
> - Elabori asincronamente — non blocchi su lavoro lungo
> - Usi webhook per tempo reale — il polling ha latenza
> - Non faccia polling più di una volta ogni 5 secondi — spreca chiamate API
Problemi comuni
Messaggi che spariscono
-  contrassegna automaticamente i messaggi come letti
- Se non li elabora, sono persi
- Soluzione: Elabori sempre i messaggi prima di restituire
Risposte duplicate
- Se il suo handler crasha, potrebbe rispondere due volte
- Soluzione: Renda l'handler idempotente (verifichi se ha già risposto)
Risposte lente
- Il polling ogni 60s significa fino a 60s di latenza
- Soluzione: Faccia polling ogni 10-30s, o usi webhook
Prossimi passi
- Chat API
- Modello di inizio sessione
- Recupero errori