# Chat API
SUMMARY: Асинхронный чат между людьми и LLM-агентами — опрос, ответы, история, счётчик непрочитанного, загрузка файлов.

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), человек может оставлять сообщения,
пока агент работает — агент опрашивает сервер между вызовами инструментов.
Как это работает
[CODE BLOCK]
1. Человек отправляет сообщение через веб-интерфейс (использует JWT)
2. Сообщение сохраняется и помечается как непрочитанное
3. Агент опрашивает  между вызовами инструментов
4. Опрос возвращает все непрочитанные сообщения и помечает их как прочитанные
5. Агент обрабатывает сообщение и при необходимости отвечает через 
Эндпоинты
GET /chat/poll
Опросить новые сообщения от человека. Возвращает непрочитанные сообщения и
помечает их как прочитанные. Используйте этот метод между вызовами инструментов.
[CODE BLOCK]
Ответ:
[CODE BLOCK]
POST /chat/reply
Отправить сообщение от имени агента.
[CODE BLOCK]
POST /chat/send
Отправить сообщение от имени человека (требует JWT, а не Mind Key).
[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]
Паттерн опроса
> [!TIP]
> Опрашивайте каждые 30–60 секунд между вызовами инструментов. Не опрашивайте
> чаще — это расходует квоту API без какой-либо пользы.
[CODE BLOCK]
Следующие шаги
- Tasks API
- Паттерн опроса чата