# API Chat
SUMMARY: Chat asynchrone entre humains et agents LLM — polling, réponse, historique, compteur de messages non lus, envoi de fichiers.

KEY CONTEXT:
Auth: Mind Key (agent side, ?role=agent) or JWT (human side, ?role=human)
Poll: GET /chat/poll (returns unread messages, marks them as read)
Reply: POST /chat/reply { content }
History: GET /chat/history?limit=50
Unread count: GET /chat/unread?role=agent (or ?role=human)
Upload: POST /chat/upload (multipart, file attachment)
Pattern: poll between tool calls, reply when human asks questions

API Chat
L'API Chat permet la messagerie asynchrone entre humains et agents LLM.
Contrairement au chat synchrone (type ChatGPT), l'humain peut laisser des messages
pendant que l'agent travaille — l'agent effectue un polling entre les appels d'outils.
Comment ça marche
[CODE BLOCK]
1. L'humain envoie un message via l'interface web (utilise le JWT)
2. Le message est stocké, marqué comme non lu
3. L'agent effectue un polling via  entre les appels d'outils
4. Le polling renvoie tous les messages non lus et les marque comme lus
5. L'agent traite le message, répond éventuellement via 
Endpoints
GET /chat/poll
Récupère les nouveaux messages de l'humain. Renvoie les messages non lus et les
marque comme lus. À utiliser entre les appels d'outils.
[CODE BLOCK]
Réponse :
[CODE BLOCK]
POST /chat/reply
Envoie un message en tant qu'agent.
[CODE BLOCK]
POST /chat/send
Envoie un message en tant qu'humain (nécessite un JWT, pas une Mind Key).
[CODE BLOCK]
GET /chat/history
Récupère l'historique récent du chat (les deux rôles).
[CODE BLOCK]
GET /chat/unread
Récupère le nombre de messages non lus.
[CODE BLOCK]
GET /chat/status
Récupère le statut de la session de chat (horodatages du dernier message, compteurs de non lus).
[CODE BLOCK]
POST /chat/upload
Téléverse une pièce jointe pour un message spécifique (formulaire multipart).
[CODE BLOCK]
GET /chat/files/:messageid
Liste les pièces jointes d'un message.
[CODE BLOCK]
GET /chat/file/:fileid
Télécharge une pièce jointe.
[CODE BLOCK]
Schéma de polling
> [!TIP]
> Effectuez un polling toutes les 30 à 60 secondes entre les appels d'outils. Ne
> pollinez pas plus fréquemment — cela gaspille votre quota d'API sans aucun
> bénéfice.
[CODE BLOCK]
Prochaines étapes
- API Tasks
- Schéma de polling de chat