基于事件驱动运行时与容器化概念模型的下一代开源 AI 智能体开发框架,支持本地、WebSocket 服务端与远程客户端三种部署模式,通过 Vercel AI SDK 统一接入多家 LLM 供应商。
AgentX 是由 Deepractice 组织开发的 AI 智能体开发框架与运行时平台,以 TypeScript 为主语言(98.1%),基于 Node.js 运行时(支持 Bun),采用 MIT 许可证,目前活跃开发中(871+ commits,60 releases,最新 v2.9.0)。
核心架构 项目采用分层事件驱动架构,底层基于 RxJS Pub/Sub 的 EventBus 实现模块间解耦通信,定义了 Stream / State / Message / Turn 四层事件体系。所有输入(Client → WebSocket → BUS → LLM Driver)与输出(Driver → BUS → AgentEngine → BUS → Client)均通过事件总线流转。
容器化概念模型 借鉴容器运行时理念,AgentX 定义了三级抽象:Prototype(Agent 模板,类比 Dockerfile)→ Image(持久化配置,类比 Docker image)→ Agent(运行时实例,类比 Container)。Image 中可声明 mcpServers、RoleX 配置等。
三种运行模式
- Local Mode:进程内嵌入式创建 Agent,适合单进程开发调试
- Server Mode:一行
ax.serve({ port })将 Agent 暴露为 WebSocket 服务器 - Remote Mode:
ax.connect("ws://...")连接远程服务器,API 与本地模式完全一致
多模型支持 通过 Vercel AI SDK 统一封装,支持 Anthropic (Claude)、OpenAI (GPT)、Google (Gemini)、DeepSeek、Mistral、xAI (Grok) 及 OpenAI-compatible 供应商。提供 Per-Request Overrides 能力,每次 send 调用可动态切换模型、推理深度等参数。
工具与扩展
支持 MCP Servers 声明式接入(Image 配置级别);集成同组织 RoleX 角色管理系统实现身份认知与成长周期管理;提供 @agentxjs/devtools BDD 测试工具包(MockDriver、RecordingDriver、Fixtures)。
包结构
采用 npm monorepo(Turbo 构建),核心包包括 agentxjs(Client SDK)、@agentxjs/core(核心抽象)、@agentxjs/node-platform(Node.js 平台适配含 SQLite 持久化)、@agentxjs/mono-driver(多供应商 Driver)、@agentxjs/claude-driver(Claude 扩展 Driver)、@agentxjs/devtools(测试工具)。
API 层次
ax.chat.*— 对话管理(create、list、get → AgentHandle)ax.provider.*— LLM Provider 配置与切换ax.runtime.*— 底层子系统(image、session、container)
生态协同 同属 Deepractice AI 基础设施的项目包括 RoleX(AI 角色管理系统)、ResourceX(统一资源管理器)、IssueX(AI 协作结构化 Issue 追踪),具体仓库链接待确认。
待确认:独立官网/文档站地址、npm 包发布状态(agentxjs 等是否已公开发布)、Hugging Face 页面、配套学术论文。