# Chat API
SUMMARY: İnsanlar ve LLM ajanları arasında asenkron sohbet — poll, yanıt, geçmiş, okunmamış sayısı, dosya yüklemeleri.

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

Chat API
Chat API, insanlar ve LLM ajanları arasında asenkron mesajlaşmayı sağlar. Senkron sohbetten (ChatGPT tarzı) farklı olarak, insan ajan çalışırken mesaj bırakabilir — ajan araç çağrıları arasında poll yapar.
Nasıl Çalışır
[CODE BLOCK]
1. İnsan web arayüzü üzerinden bir mesaj gönderir (JWT kullanır)
2. Mesaj saklanır, okunmamış olarak işaretlenir
3. Ajan, araç çağrıları arasında  ile poll yapar
4. Poll, tüm okunmamış mesajları döndürür ve okundu olarak işaretler
5. Ajan mesajı işler, isteğe bağlı olarak  ile yanıt verir
Uç Noktalar
GET /chat/poll
İnsandan yeni mesajlar için poll yapın. Okunmamış mesajları döndürür ve okundu olarak işaretler. Bunu araç çağrıları arasında kullanın.
[CODE BLOCK]
Yanıt:
[CODE BLOCK]
POST /chat/reply
Ajan olarak bir mesaj gönderin.
[CODE BLOCK]
POST /chat/send
İnsan olarak bir mesaj gönderin (Mind Key değil, JWT gerektirir).
[CODE BLOCK]
GET /chat/history
Son sohbet geçmişini alın (her iki rol).
[CODE BLOCK]
GET /chat/unread
Okunmamış mesaj sayısını alın.
[CODE BLOCK]
GET /chat/status
Sohbet oturum durumunu alın (son mesaj zaman damgaları, okunmamış sayıları).
[CODE BLOCK]
POST /chat/upload
Belirli bir mesaj için dosya eki yükleyin (multipart form).
[CODE BLOCK]
GET /chat/files/:messageid
Bir mesajın dosya eklerini listele.
[CODE BLOCK]
GET /chat/file/:fileid
Bir dosya ekini indirin.
[CODE BLOCK]
Polling Deseni
> [!TIP]
> Araç çağrıları arasında her 30-60 saniyede bir poll yapın. Daha sık poll yapmayın — bu, API kotasını boşa harcar ve hiçbir fayda sağlamaz.
[CODE BLOCK]
Sonraki Adımlar
- Tasks API
- Chat Polling Deseni