概览
系统提供两个 WebSocket 端点:
两者均通过 JWT token 进行认证(query 参数传递)。
聊天 WebSocket
连接
客户端发送
服务端响应
内部消息格式
服务端将 WebSocket 消息标准化为UnifiedMessage:
通知 WebSocket
连接
工作模式
- 单向推送:服务端主动向客户端发送通知,客户端只需保持连接
- 心跳:客户端通过
receive_text()保持连接存活 - 多连接:同一用户可同时打开多个连接,所有连接都会收到通知
推送消息格式
NotificationHub 架构
SSE 流式输出
除 WebSocket 外,HTTP 端点也支持 SSE(Server-Sent Events)流式输出:text/event-stream,逐块推送 Agent 输出。