# Chat API
SUMMARY: मानव और LLM एजेंट्स के बीच अतुल्यकालिक चैट — poll, reply, history, अपठित गिनती, फ़ाइल अपलोड।

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 मानव और LLM एजेंट्स के बीच अतुल्यकालिक मैसेजिंग सक्षम करता है। तुल्यकालिक चैट (ChatGPT-शैली) के विपरीत, मानव एजेंट के काम कर रहे होने पर भी संदेश छोड़ सकता है — एजेंट टूल कॉल्स के बीच poll करता है।
यह कैसे काम करता है
[CODE BLOCK]
1. मानव वेब UI के माध्यम से संदेश भेजता है (JWT का उपयोग करता है)
2. संदेश स्टोर किया जाता है, अपठित के रूप में चिह्नित किया जाता है
3. एजेंट टूल कॉल्स के बीच  कॉल करता है
4. Poll सभी अपठित संदेश लौटाता है और उन्हें पठित के रूप में चिह्नित करता है
5. एजेंट संदेश को प्रोसेस करता है, वैकल्पिक रूप से  के माध्यम से उत्तर देता है
एंडपॉइंट्स
GET /chat/poll
मानव के नए संदेशों के लिए poll करें। अपठित संदेश लौटाता है और उन्हें पठित के रूप में चिह्नित करता है। इसे टूल कॉल्स के बीच उपयोग करें।
[CODE BLOCK]
प्रतिक्रिया:
[CODE BLOCK]
POST /chat/reply
एजेंट के रूप में संदेश भेजें।
[CODE BLOCK]
POST /chat/send
मानव के रूप में संदेश भेजें (Mind Key नहीं, JWT आवश्यक)।
[CODE BLOCK]
GET /chat/history
हाल का चैट इतिहास प्राप्त करें (दोनों भूमिकाएँ)।
[CODE BLOCK]
GET /chat/unread
अपठित संदेश गिनती प्राप्त करें।
[CODE BLOCK]
GET /chat/status
चैट सत्र की स्थिति प्राप्त करें (अंतिम संदेश टाइमस्टैम्प्स, अपठित गिनती)।
[CODE BLOCK]
POST /chat/upload
किसी विशिष्ट संदेश के लिए फ़ाइल अटैचमेंट अपलोड करें (multipart फ़ॉर्म)।
[CODE BLOCK]
GET /chat/files/:messageid
किसी संदेश के लिए फ़ाइल अटैचमेंट्स की सूची बनाएँ।
[CODE BLOCK]
GET /chat/file/:fileid
फ़ाइल अटैचमेंट डाउनलोड करें।
[CODE BLOCK]
Polling पैटर्न
> [!TIP]
> टूल कॉल्स के बीच हर 30-60 सेकंड में poll करें। अधिक बार poll न करें — यह API कोटा बर्बाद करता है और कोई लाभ नहीं देता।
[CODE BLOCK]
अगले कदम
- Tasks API
- Chat Polling Pattern