SuperAPI AI 工具集

Agent Runtime Overview

智能体与模型

查看项目

更新于 10-15 22:13

技能介绍

用途:Agent Runtime 用于按需启动任意 AI 智能体工作负载,在隔离的 Modal 沙箱中编排智能体(Claude via Agent SDK、OpenCode),并提供 Node.js 后端运行时与 React 客户端库,便于构建带 AI 智能体的应用。其核心原则是运行时只负责会话管理与智能体编排,不对调用方应用强制任何数据模式,数据类型回传给应用自行处理。

主要能力:隔离方面,智能体在 Modal 沙箱而非应用服务器上执行,提供安全隔离、资源隔离(CPU、内存、磁盘)与每会话干净环境。流式方面,通过 WebSocket 实时逐块输出,事件包括 block_start、text_delta、block_update、block_complete。会话管理内置生命周期:懒创建沙箱(首条消息才启动)、空闲超时清理、周期性状态同步到持久化、优雅关闭。多架构支持 Claude Agent SDK 与 OpenCode,创建会话时通过 AGENT_ARCHITECTURE_TYPE 配置。React 集成提供会话生命周期、消息发送与流式、文件工作区跟踪、子智能体记录访问等 hooks。

使用方式:monorepo 提供两个包:@hhopkins/agent-runtime(Node.js 后端运行时)与 @hhopkins/agent-runtime-react(React hooks 与 context)。数据流为:客户端经 REST API 创建会话;运行时创建 AgentSession(此时不创建沙箱,懒初始化);客户端加入该会话的 WebSocket 房间;首条消息触发沙箱创建并开始执行;输出以块事件经 WebSocket 流式返回;会话状态周期性同步到 PersistenceAdapter。输出被解析为类型化块:UserMessageBlock、AssistantTextBlock、ToolUseBlock、ToolResultBlock、ThinkingBlock、SystemBlock、SubagentBlock、ErrorBlock。智能体配置(Agent Profiles)定义系统提示与记忆文件(CLAUDE.md/AGENT.md)、可用工具、技能及支持文件、子智能体、命令与 MCP 服务器集成。PersistenceAdapter 是运行时与应用存储的主要集成点,由应用实现以存储检索会话、保存记录、跟踪工作区文件、管理智能体配置。

适用场景:需要智能体在隔离环境运行的应用、按需启动任意智能体工作负载、需要实时流式输出的应用、重视智能体隔离的多租户系统,以及构建自定义 AI 界面(聊天 UI、IDE、自动化工具)。

限制:若只需运行单个长期存活的智能体进程、不需要沙箱隔离,或只需简单请求/响应而无流式,则应考虑其他方案。资料未提供具体收费、价格、平台支持范围与性能指标。