Appearance
HTTP 与 Streaming(Harness Service Engineering)
围绕 Run API、event stream、disconnect 与 gateway boundary 学 HTTP/SSE/WebSocket。
推荐阅读顺序
1. 一次 HTTP 调用经历什么:Lifecycle、Connection Pool 与 Timeout Layers
回答:一次 HTTP 调用从 acquire connection 到释放连接经历哪些阶段,每一层 timeout 应该约束什么?
2. 长任务 API 用普通 REST 还是 Streaming HTTP
回答:普通 REST 和 Streaming HTTP 的生命周期、失败语义和客户端体验有什么差别,长任务该如何选?
3. Agent 事件怎么推给前端:SSE、WebSocket 与 Event Stream
回答:SSE 与 WebSocket 各适合怎样的事件方向和连接模型,Runtime event 应怎样映射到 transport?
4. 客户端断开后上游该不该停:Disconnect 与 Cancellation Propagation
回答:客户端断开是否等于取消 Run;如果要取消,cancellation 应怎样从 transport 传播到 Model / Tool?
5. 流式响应为什么会堵住:Backpressure 与 Gateway Timeout
回答:consumer 读得慢或 gateway 有连接时限时,streaming pipeline 怎样控制 buffer,并让 transport 断开不破坏 Run 生命周期?
本模块学习边界
- 暂不展开:Gateway 大规模容量与完整 benchmark 后移 W12