
30 秒速读:AgentPlaza 是一个自托管的 AI Agent 编排平台,设计哲学是”不信任 Agent”:每个 Agent 都跑在独立的 microVM 里,默认没有网络接口;每次工具调用都要先过一遍人类可读的 JHRL 规则(允许 / 拒绝 / 交人决定);每个 Agent 还有自己的钱包和预算,花超了就停;外加一个 STOP ALL 一键全局暂停。模型调用统一走 Hub 的模型网关,密钥不进虚拟机。适合要在自己机器上跑多个 Agent、又对隔离和治理有强要求的团队;前提是你得有支持 KVM 的 Linux 主机。
软件信息一览
| 软件名称 | AgentPlaza |
| Hub / 控制台平台 | Linux x86_64、Linux arm64、树莓派 4/5、macOS、Windows |
| Agent 运行环境 | 需 hypervisor;Linux 与树莓派 OS 要求 KVM(/dev/kvm) |
| 部署方式 | 自托管(Hub + 节点 + 工作站分层) |
| 模型网关 | Anthropic、OpenAI、Azure OpenAI、Gemini、Bedrock、Vertex AI 及 OpenAI 兼容接口 |
| 控制界面 | Web 控制台 / 桌面应用 / agentplaza 命令行 |
版本选择:Release 安装器 vs 源码构建
结论先行:Release 安装器是唯一推荐的生产路径,源码构建只留给要改 Rust 代码的人。
| 维度 | Release 安装器 | 源码构建 |
|---|---|---|
| 上手速度 | 按文档一步安装 | 需 Rust 工具链,构建耗时 |
| 完整性 | 自带 SHA256SUMS 校验,文件齐 | 需自行处理依赖 |
| 适合人群 | 部署使用者 | 贡献者、深度定制 |
| 风险 | 低 | 构建环境差异可能导致奇怪问题 |
部署的关键步骤
- 确认主机有
/dev/kvm(运行ls /dev/kvm),没有它 Agent 的 microVM 起不来——这是整个部署里最硬的门槛,云服务器要选支持嵌套虚拟化的机型。 - 下载 Release 安装器后先核对 SHA256SUMS,再执行安装(支持 dry-run 先看它要干什么)。
- 部署 Hub,配置模型网关:把各家模型供应商的 API Key 填进 Hub 的加密凭据库——注意密钥只存在 Hub、不进 microVM,这是它的安全设计要点。
- 添加节点与工作站,在 Web 控制台确认三者都在线。
- 写第一条 JHRL 规则(如”禁止删除文件”),跑一个测试 Agent 验证规则确实能拦截。
装完建议改的 3 个设置
- 默认 JHRL 规则集 —— 入口:控制台 → 规则管理。体感差别:默认规则偏宽松,生产前务必加上”高危操作转人工确认”,否则 Agent 半夜删文件的时候你只能看日志。
- Agent 预算上限 —— 入口:Agent 配置 → 钱包/预算。体感差别:不设上限的 Agent 会在你睡觉时把模型账单烧穿;按任务设日限额,超了自动停。
- 模型网关的默认供应商与 fallback —— 入口:Hub → 模型网关。体感差别:主供应商挂了任务就全停,配好备用供应商后故障时自动切换,半夜不用被叫醒。
注意事项与常见问题
- KVM 是硬门槛:Windows / macOS 上跑 Agent 的具体虚拟化后端以项目说明为准,买机器、开云主机前先确认,别装完才发现 /dev/kvm 不存在。
- 这是重型方案:Hub、节点、工作站三层架构是为团队设计的,个人跑单个 Agent 用它属于大炮打蚊子,维护成本会超过收益。
- 规则写不好等于没规则:JHRL 是人类可读的,但”可读”不等于”写得对”,上线前用测试 Agent 把拦截、放行、转人工三条路径都走一遍。
- 凭据轮换要进流程:模型 Key 存在 Hub 的加密库里,定期轮换并验证旧 Key 失效后 Agent 是否正常切换,别等泄露了才想起来。
适合谁 / 不适合谁
适合:需要在自有机器上运行多个 Agent、对执行隔离和调用治理有强要求的团队;已有虚拟化运维经验、能接受维护 Hub / 节点 / 工作站的团队。不适合:个人轻量使用、单进程 Agent 编排、没有 KVM 环境的场景。
| 方案 | 隔离强度 | 治理能力 | 运维成本 |
|---|---|---|---|
| AgentPlaza | microVM 独立虚拟机 | JHRL 规则 + 预算 + STOP ALL | 高(三层架构) |
| Docker 沙箱方案 | 容器级 | 依赖外部编排 | 中 |
| 单机 Agent 框架 | 无 / 进程级 | 基本无 | 低 |
独家整理:它的治理设计为什么是”钱包 + 规则 + 急停”三件套
很多 Agent 平台只做沙箱隔离,AgentPlaza 把治理拆成了三层:JHRL 规则管”能不能做”(每次工具调用前判定),钱包 / 预算管”做多少”(复式记账,超支即停),STOP ALL 管”出事了怎么办”(一键暂停全部工作并拒绝后续模型调用)。三层缺一不可:只有规则没有预算,Agent 会用合法调用把你烧破产;只有预算没有急停,出事时你只能去杀进程。这套设计明显是为”Agent 7×24 无人值守运行”的生产场景准备的,评估时别只看隔离,要看三层是否都配齐了。
开源地址
GitHub 国内访问较慢,如打不开可多刷新几次
安装步骤(核对清单)
- 确认 KVM:主机上确认存在 /dev/kvm,没有它 Agent 的 microVM 起不来;云服务器要选支持嵌套虚拟化的机型。
- 下载后先校验:下载 Release 安装器后先核对 SHA256SUMS,再执行安装,支持 dry-run 的先看它要干什么。
- 部署 Hub 并配模型网关:把各家模型供应商的密钥填进 Hub 的加密凭据库,密钥只存在 Hub、不进 microVM。
- 添加节点与工作站:在 Web 控制台确认 Hub、节点、工作站三者都在线,再跑第一个测试 Agent。
- 写一条规则并实测拦截:先写一条禁止删除文件之类的规则,跑测试 Agent 验证拦截、放行、转人工三条路径都走得通。
版本对比与推荐
| 版本路径 | 特点 | 适合谁 | 推荐 |
|---|---|---|---|
| Release 安装器 | 自带校验文件,上手快,稳定 | 部署使用者 | 推荐 |
| 源码构建 | 需 Rust 工具链,构建耗时,环境差异可能导致问题 | 要改代码的贡献者 | 不推荐日常部署 |
推荐版本:Release 安装器是唯一推荐的生产路径,稳定可用;源码构建只留给要改 Rust 代码的人。
补充设置建议
- 凭据轮换进流程(通用建议):入口:Hub 的加密凭据库。差别:定期轮换并验证旧密钥失效后 Agent 是否正常切换,比等到出问题再处理省事得多。
- 全局暂停要演练一次(通用建议):入口:控制台的 STOP ALL。差别:平时演练过,真遇到 Agent 失控时一键暂停才敢按、才知道按下去会停什么。
- 规则变更留记录(通用建议):入口:控制台的规则管理。差别:谁改了规则、什么时候改的能查到,出问题回查时不用凭记忆猜。
补充常见问题
- 没有 KVM 能不能装:不能绕过,Agent 的 microVM 依赖它;买机器、开云主机前先确认,这是最硬的门槛。
- 个人只跑一个 Agent 值不值:不值,三层架构是为团队设计的,个人轻量使用维护成本会超过收益。
- 规则可读等于写得对吗:不等于,上线前务必用测试 Agent 把拦截、放行、转人工三条路径都走一遍。

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›







