Remote Agent

传输行为

理解 RemoteAgent 使用的 HTTP 与 RPC 传输方式

传输行为

RemoteAgent 支持两种传输形态:

  • http://... / https://...:调用 Town Agent HTTP gateway 挂载出来的 SDK 路由
  • rpc://...:直连本机 Agent RPC server

普通请求

例如:

  • 创建 session
  • 列出 session
  • prompt
  • history
  • fork

这些都走普通 JSON 请求响应。

事件流请求

走 HTTP 时,events 是 NDJSON 风格的长连接返回。

走 RPC 时,同样的 session events 会通过 RPC 连接投递。

对 HTTP 调用方来说,客户端会不断收到一行一行的 JSON 事件。

每一行都可以看成一条独立的 session event。

对调用方意味着什么

  • 如果你只关心某一轮最终结果,就等 turn.finished
  • 如果你要做实时 UI,就用 subscribe()

如果你要展示工具调用过程、渐进输出或实时聊天 UI,subscribe() 通常就是最合适的入口。