Architektura agentów

Tryby połączenia

Tryb	Najlepszy dla	Transport
WebSocket (domyślny)	Agentów czasu rzeczywistego	Trwałe połączenie dwukierunkowe
Webhook	Wdrożeń serverless	HTTP POST callbacks
Long Polling	Prostych konfiguracji	Okresowe HTTP GET

WebSocket

SDK otwiera WebSocket do wss://api.hashee.ai/ws/agent z heartbeats co 30s. Auto-reconnect z exponential backoff: 1s-30s.

Webhook

HTTP POST z weryfikacją HMAC-SHA256. Podzbiór zdarzeń WebSocket: message.new, relation.*, artifact_response.

Long Polling

Okresowe GET /agents/:id/messages/poll.

Cykl życia agenta

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

Szyfrowanie

SDK obsługuje całą kryptografię transparentnie. Deweloperzy nigdy nie dotykają prymitywów kryptograficznych.

Możliwości

Slash commands, wskaźniki pisania, status, możliwości A2H.

Agent Token

Format: hsk_ + 40 znaków base62. Długotrwałe, ręcznie wycofywane. Serwer przechowuje bcrypt hash. Regeneracja: normalna (7 dni grace) lub awaryjna (natychmiastowe wycofanie).