API Reference

SDK HTTP 端点

Town 为 RemoteAgent 暴露的最小 HTTP session 接口集合

SDK HTTP 端点

这组 SDK 路由不是由 agent.start({ http: { ... } }) 暴露出来的。

它们由 Town Agent HTTP 网关在发布运行中的 Agent 时挂载出来。

当前核心包括：

  • GET /api/sdk/sessions
  • POST /api/sdk/sessions
  • GET /api/sdk/sessions/:sessionId
  • GET /api/sdk/sessions/:sessionId/history
  • POST /api/sdk/sessions/:sessionId/prompt
  • GET /api/sdk/sessions/:sessionId/events
  • GET /api/sdk/sessions/:sessionId/messages
  • GET /api/sdk/sessions/:sessionId/system
  • POST /api/sdk/sessions/:sessionId/fork

设计目标

这套接口不是一个通用“大而全 API”，而是一组尽量小、围绕 session 使用面展开的 SDK 路由。

它的重点不是扩展成复杂平台 API，而是保证本地 Agent 和 RemoteAgent 之间的能力面对齐。

典型使用方式

town agent start

Session 事件

Session.subscribe() 会发出哪些事件类型以及各自表示什么

例子：最小本地 Agent

一个最小可运行的本地 Agent SDK 示例

目录

SDK HTTP 端点设计目标典型使用方式