AgentRT 是什么?一文读懂 OS 级 AI 智能体运行底座的 8 大核心能力
AgentRT 是什么?一文读懂 OS 级 AI 智能体运行底座的 8 大核心能力
AgentRT(全称 AirymaxAgentRT)是一个面向 AI 智能体团队的 OS 级 AI 智能体运行底座(runtime substrate)。它把智能体"如何思考、如何执行、如何记忆、如何彼此通信"标准化为一套运行时——就像容器运行时之于微服务,AgentRT 之于 AI 智能体。核心设计目标是:突破上下文限制,让智能体拥有接近无限的记忆,并在真实硬件上长期稳定运行。
下面一文带你读懂它的 8 大核心能力,并附上快速上手指南。
AgentRT 一分钟速览
AgentRT 是 Airymax 平台的运行时层,运行时核心以 C11 实现,并提供 Python、Go、Rust、TypeScript 四种语言绑定。无论是笔记本上的单智能体,还是规模化多智能体部署,都使用完全相同的编程模型。
| 项目信息 | 说明 |
|---|---|
| 当前版本 | v0.1.18(见 VERSION 与 latest/manifest.stable.json) |
| 支持平台 | Linux(x86-64 / x86-32 / arm-64 / arm-32)、macOS(Apple Silicon / Intel)、Windows(x86-64 / x86-32) |
| 许可证 | AGPL-3.0-or-later 或 Apache-2.0 双许可(详见 LICENSE) |
| 语言 | C11 核心 + Python / Go / Rust / TypeScript 绑定 |
| 仓库形态 | 发布聚合仓库,各组件以 git submodule 固定到确切提交,任一版本可逐提交复现 |
8 大核心能力总览
| # | 能力 | 一句话理解 |
|---|---|---|
| 1 | 对话 / 任务双模式 | 聊天与干活两档切换,大任务自动"先规划、后执行" |
| 2 | 多智能体协作 | 一个主智能体编排多个子智能体,并行拆活、汇总结果 |
| 3 | 规划与反思 | 含糊目标先澄清,再编译为任务图调度,失败自动重调度 |
| 4 | 持久记忆 | L1 会话级 + L2 跨会话两层记忆,支持检索与遗忘 |
| 5 | 工具回路 | 真实调用 web_search、web_fetch 等工具并回填结果 |
| 6 | 安全穹顶 | 四层防护、默认 fail-closed,出问题先关门 |
| 7 | 统一网关 | 六种外部协议统一翻译为一条 JSON-RPC 2.0 流 |
| 8 | 15 个运行时服务 | 长驻守护进程按依赖顺序启动、可自愈 |
1️⃣ 对话与任务双模式
AgentRT 提供两种工作模式:模式一(对话) 面向日常交流,模式二(任务) 面向复杂工作,均由命令行与终端界面驱动。最有意思的一点是:同一条指令在任务较大时会自动进入"先规划、后执行"的闭环,不需要你手动切换。
2️⃣ 多智能体协作
一个主智能体(lead agent)可以编排多个子智能体:并行拆分工作、各自执行、再汇总结果。智能体之间通过公开定义的 A2A(Agent-to-Agent)协议互通,协议实现位于 protocols/ 目录。
3️⃣ 规划与反思
面对含糊的目标,AgentRT 会先做交互式澄清,再把目标编译为可执行的**任务图(task graph)**并交给调度器;执行过程中具备自我反思能力,遇到失败会自动重新调度。相关机制源码在微核心层 atoms/ 的 taskflow(任务图与调度)与 coreloopthree(认知 → 执行 → 记忆三阶段循环)模块中。
4️⃣ 持久记忆(近无限上下文的关键)
这正是 AgentRT "Transcend context limits" 愿景的落地方式:
- L1 会话级记忆:当前会话内的上下文;
- L2 跨会话记忆:跨会话沉淀,重启后依然可检索;
- 内置免费记忆后端,支持检索与遗忘(forgetting);
- 可插接商业记忆提供方(
memoryrovol),缺失时自动降级为内置后端,不破坏构建。
记忆原语与后端位于 atoms/ 的 memory 模块,持久化由存储层 heapstore/ 承载。
5️⃣ 工具回路
聊天回路会向模型暴露 web_search、web_fetch 等真实工具:模型发起调用 → 运行时执行 → 以 tool 消息回填结果 → 最终回复以 markdown 渲染。这意味着智能体不是"只会说",而是真的能上网查资料。
6️⃣ 安全穹顶(Security Dome)
四层防护,默认姿态为 fail-closed(拿不准就先拒绝):
| 层级 | 机制 |
|---|---|
| 沙箱隔离 | 执行环境与宿主隔离 |
| RBAC 授权 | 基于角色的访问控制 |
| 输入/输出净化 | 净化进出内容,防注入 |
| 审计日志 | 全链路留痕可追溯 |
策略由策略决策点(PDP)统一下发、秒级生效、可回滚,每个守护进程通过本地执行点(PEP)应用策略。
7️⃣ 统一网关(Gateway)
gateway_d 是整个运行时唯一的进程边界:将 HTTP、WebSocket、SSE、MCP、A2A、OpenAI 六种传输统一翻译为一条 JSON-RPC 2.0 流。网关只做协议翻译、不含业务逻辑,外部系统从此只需要对接一个入口。源码位于 gateway/。
8️⃣ 15 个运行时服务 + 可观测
运行时由一组长驻守护进程(daemon) 组成,覆盖调度(sched_d)、智能体执行(agent_d)、LLM 桥接(llm_d)、工具分发(tool_d)、双思考认知(think_d)、记忆(mem_d)、市场(market_d)、监控(monit_d)、通知(notify_d)、通道(channel_d)、A2A(a2a_d)、策略执行、数学(maths_d)、钩子与监管(supervisor_d)等,按依赖顺序启动并可自愈。
可观测方面提供:全局事件流 + 任务看板 + 健康监控,通过 airymaxrt status 与 airymaxrt doctor 呈现,日志按进程落盘。
架构分层:每一层只依赖其下的层
AgentRT 采用严格分层结构,依赖关系一目了然:
| 层 | 职责 | 目录 |
|---|---|---|
| SDK 层 | 命令行、终端界面、四语言绑定 | 同级 sdk/ |
| 服务层 | 长驻守护进程,编排运行时 | daemons/ |
| 协议层 | AgentsIPC(128 字节消息头)、A2A / A2T | protocols/ |
| 网关层 | 各类传输 → JSON-RPC 2.0 | gateway/ |
| 存储层 | 运行时数据存储 | heapstore/ |
| 安全层 | 四层安全穹顶 | cupolas 产品仓 |
| 微核心系统层 | corekern / coreloopthree / syscall / taskflow / memory 五个机制模块 |
atoms/ |
| 支撑层 | 32 个内聚工具模块 + 共享头文件 | commons/ |
工程治理上同样"OS 级":构建期通过 link-whitelist.txt 链接白名单做 fail-closed 门禁,越权链接直接构建失败;契约代码由 tools/codegen/ 从唯一真值源生成;交互式产品入口是 tools/airy_cli/(C11 实现);端到端回归脚本在 tests/e2e/。顶层构建入口为 CMakeLists.txt。
快速上手:一键安装与首次运行
Linux / macOS 一键安装
官方发布提供一行安装脚本(无需编译,自动识别平台、下载预构建包并校验),脚本源文件见 scripts/install.sh。常用参数:
--prefix "$HOME/.airymaxrt":自定义安装路径(默认即此值,仅首次安装时有效)--channel rc:安装候选版本通道--reinstall:强制重装(清理缓存并停止运行中的守护进程)--uninstall --keep-data:卸载但保留记忆数据
小提示:管道安装请用
bash而非sh执行,否则--prefix、--channel等选项会静默失效。
Windows 与 npm
- Windows:提供 x86-64 与 x86-32 原生 PowerShell 安装器(scripts/install.ps1)
- Node.js 用户:
npm install -g @openairymax/agentrt(零逻辑薄壳包,优先复用本机已有安装) - 从源码构建:
git clone --recursive https://gitcode.com/gh_mirrors/agen/agentrt,前置条件为 Ubuntu 22.04+ / macOS 13+ / 带 MSVC 的 Windows,GCC 11+ 或 Clang 14+,CMake 3.20+
首次运行常用命令
airymaxrt # 启动终端界面(非交互终端下自动回退为 CLI)
airymaxrt status # 查看当前运行状态
airymaxrt doctor # 组件健康检查
airymaxrt logs 100 # 查看最近 100 行运行日志
airymaxrt profile # 查看/切换运行画像(full / minimal / auto)
airymaxrt monitor --daemon 会持续观察硬件:后续扩充内存或加装 GPU 时,此前被裁剪的能力会自动恢复。
版本通道与更新
- stable(默认)/ rc(候选)/ beta(定向验证)三个发布通道
- 每个版本在 latest/ 中提供 GPG 签名的发布清单,更新器只信任它
- 常用命令:
airymaxrt update(更新)、--check(只检查)、--channel rc(切通道)、--rollback(回滚)
完整版本演进历史见 CHANGELOG.md,参与贡献流程见 CONTRIBUTING.md,安全漏洞上报见 SECURITY.md。
总结:为什么值得关注 AgentRT?
🎯 用一句话概括:AgentRT 就是 AI 智能体世界的"操作系统"。
- 🧠 三阶段认知循环(认知 → 执行 → 记忆)+ 两层持久记忆,让智能体接近"无限记忆";
- 🤝 多智能体协作、规划反思、工具回路,让智能体能干复杂活;
- 🔒 四层 fail-closed 安全穹顶 + 唯一网关入口,企业级可控;
- ⚙️ 15 个可自愈守护进程 + 全局可观测,笔记本单机到集群部署同一套编程模型。
如果你正在寻找一个能长期稳定运行、可扩展到多智能体规模的 AI 智能体运行底座,AgentRT 值得放进你的技术清单。