用途:搭建智能体运行时(agent runtime)后端,包括配置环境变量、实现 PersistenceAdapter、创建运行时并启动 REST 与 WebSocket 服务器。
主要能力:通过 createAgentRuntime 创建运行时,接入 Modal 沙箱与 Anthropic Claude 智能体;提供 REST 端点(POST /sessions/create、GET /sessions/:id、POST /sessions/:id/message、GET /sessions、GET /agent-profiles、GET /health)与 WebSocket 事件(块流式、会话状态、文件、子智能体、错误等)。沙箱采用惰性创建:创建会话时不建沙箱,首条消息才触发,后续复用,空闲超时后终止。
必要用法:需设置环境变量 MODAL_TOKEN_ID、MODAL_TOKEN_SECRET(从 modal.com 获取)与 ANTHROPIC_API_KEY。实现 PersistenceAdapter 接口(会话、存储、智能体配置操作),再调用 createAgentRuntime 传入 persistence 与 modal 配置(tokenId、tokenSecret、appName),可选 idleTimeoutMs(默认 15 分钟)与 syncIntervalMs(默认 30 秒)。随后 runtime.start(),用 runtime.createRestServer({apiKey}) 创建 REST 应用,挂载到 HTTP 服务器,并用 runtime.createWebSocketServer(httpServer) 创建 WebSocket 服务,最后 listen 端口。可通过 runtime.sessionManager 访问会话管理,如 getLoadedSessions、getSession、unloadSession。
适用场景:需要自建智能体后端、集成 Modal 沙箱与 Claude、为前端提供 REST/WebSocket 接口的部署。
限制:资料未提供具体依赖版本、鉴权细节、错误处理策略、性能与安全说明;PersistenceAdapter 完整接口需参考 references/types.md,本资料未展开。