API Reference

SDK HTTP 端点

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

SDK HTTP 端点

这组 SDK 路由不属于 Agent 自身。

它们由 city.http() 返回的 City HTTP transport 暴露。City 可以直接启动 HTTP server， 也可以将 router 挂载到 Downcity gateway 等宿主 server 上。

当前核心包括：

  • GET /api/sdk/sessions
  • POST /api/sdk/sessions
  • GET /api/sdk/sessions/:session_id
  • POST /api/sdk/sessions/:session_id/prompt
  • GET /api/sdk/sessions/:session_id/events
  • GET /api/sdk/sessions/:session_id/messages
  • GET /api/sdk/sessions/:session_id/system
  • GET /api/sdk/sessions/:session_id/interactions
  • GET /api/sdk/sessions/:session_id/status
  • POST /api/sdk/sessions/:session_id/set
  • POST /api/sdk/sessions/:session_id/respond
  • POST /api/sdk/sessions/:session_id/fork
  • POST /api/sdk/sessions/:session_id/archive
  • GET / DELETE /api/sdk/archived-sessions
  • POST /api/plugins/action

设计目标

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

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

典型使用方式

downcity on

Session Mutation

Session.subscribe() 返回的 Mutation 类型与 UI 使用方式

City RPC

由 City 持有的 Agent 与 Workspace RPC transport

目录

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