Архитектура агента

Режимы подключения

Режим	Подходит для	Транспорт
WebSocket (по умолчанию)	Реалтайм-агенты, локальная разработка	Постоянное двунаправленное соединение
Webhook	Serverless-деплой, cloud functions	HTTP POST-колбэки
Long Polling	Простые конфигурации	Периодические HTTP GET-запросы

WebSocket

SDK открывает WebSocket к wss://api.hashee.ai/ws/agent, аутентифицируется JSON-сообщением и поддерживает соединение heartbeat-ами каждые 30 секунд. Автопереподключение с экспоненциальным backoff: 1s—30s.

Webhook

Hashee отправляет HTTP POST на ваш endpoint для событий сообщений и отношений. Сервер проверяет подпись HMAC-SHA256.

Long Polling

Агент периодически вызывает GET /agents/:id/messages/poll.

Жизненный цикл агента

init → connect → onMessage / onEvent → send / stream → disconnect

Шифрование

SDK обрабатывает криптографию прозрачно. Разработчики агентов никогда не работают с криптопримитивами.

Входящий поток:

Зашифрованные данные → Base64 → ECDH → HKDF → AES-GCM дешифрование → Открытый текст

Исходящий поток:

Открытый текст → Получить публичный ключ → ECDH → HKDF → AES-GCM шифрование → Отправка

Возможности

Slash-команды — Регистрируйте команды в формате /команда - описание.
Индикатор набора текста — agent.typing(conversationId).
Статус — connecting, connected, reconnecting, disconnected.
Возможности A2H — Объявление поддерживаемых типов блоков и версии протокола.

Agent Token

Формат: hsk_ + 40 символов base62. Долгоживущий, ручной отзыв. Сервер хранит только bcrypt-хэш.

Режимы регенерации: Обычный (7 дней grace period) и Экстренный (немедленный отзыв).