AgentPlaza:自托管 AI Agent

25次阅读
没有评论
AgentPlaza 免费下载|自托管 AI Agent
获取下载链
微信关注「软件教程管家」公众号,回复 agentplaza
官方渠道:GitHub 仓库

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 校验,文件齐 需自行处理依赖
适合人群 部署使用者 贡献者、深度定制
风险 低 构建环境差异可能导致奇怪问题

部署的关键步骤

  1. 确认主机有 /dev/kvm(运行 ls /dev/kvm),没有它 Agent 的 microVM 起不来——这是整个部署里最硬的门槛,云服务器要选支持嵌套虚拟化的机型。
  2. 下载 Release 安装器后先核对 SHA256SUMS,再执行安装(支持 dry-run 先看它要干什么)。
  3. 部署 Hub,配置模型网关:把各家模型供应商的 API Key 填进 Hub 的加密凭据库——注意密钥只存在 Hub、不进 microVM,这是它的安全设计要点。
  4. 添加节点与工作站,在 Web 控制台确认三者都在线。
  5. 写第一条 JHRL 规则(如”禁止删除文件”),跑一个测试 Agent 验证规则确实能拦截。

装完建议改的 3 个设置

  1. 默认 JHRL 规则集 —— 入口:控制台 → 规则管理。体感差别:默认规则偏宽松,生产前务必加上”高危操作转人工确认”,否则 Agent 半夜删文件的时候你只能看日志。
  2. Agent 预算上限 —— 入口:Agent 配置 → 钱包/预算。体感差别:不设上限的 Agent 会在你睡觉时把模型账单烧穿;按任务设日限额,超了自动停。
  3. 模型网关的默认供应商与 fallback —— 入口:Hub → 模型网关。体感差别:主供应商挂了任务就全停,配好备用供应商后故障时自动切换,半夜不用被叫醒。

注意事项与常见问题

  1. KVM 是硬门槛:Windows / macOS 上跑 Agent 的具体虚拟化后端以项目说明为准,买机器、开云主机前先确认,别装完才发现 /dev/kvm 不存在。
  2. 这是重型方案:Hub、节点、工作站三层架构是为团队设计的,个人跑单个 Agent 用它属于大炮打蚊子,维护成本会超过收益。
  3. 规则写不好等于没规则:JHRL 是人类可读的,但”可读”不等于”写得对”,上线前用测试 Agent 把拦截、放行、转人工三条路径都走一遍。
  4. 凭据轮换要进流程:模型 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 项目页

GitHub 国内访问较慢,如打不开可多刷新几次

安装步骤(核对清单)

  1. 确认 KVM:主机上确认存在 /dev/kvm,没有它 Agent 的 microVM 起不来;云服务器要选支持嵌套虚拟化的机型。
  2. 下载后先校验:下载 Release 安装器后先核对 SHA256SUMS,再执行安装,支持 dry-run 的先看它要干什么。
  3. 部署 Hub 并配模型网关:把各家模型供应商的密钥填进 Hub 的加密凭据库,密钥只存在 Hub、不进 microVM。
  4. 添加节点与工作站:在 Web 控制台确认 Hub、节点、工作站三者都在线,再跑第一个测试 Agent。
  5. 写一条规则并实测拦截:先写一条禁止删除文件之类的规则,跑测试 Agent 验证拦截、放行、转人工三条路径都走得通。

版本对比与推荐

版本路径 特点 适合谁 推荐
Release 安装器 自带校验文件,上手快,稳定 部署使用者 推荐
源码构建 需 Rust 工具链,构建耗时,环境差异可能导致问题 要改代码的贡献者 不推荐日常部署

推荐版本:Release 安装器是唯一推荐的生产路径,稳定可用;源码构建只留给要改 Rust 代码的人。

补充设置建议

  1. 凭据轮换进流程(通用建议):入口:Hub 的加密凭据库。差别:定期轮换并验证旧密钥失效后 Agent 是否正常切换,比等到出问题再处理省事得多。
  2. 全局暂停要演练一次(通用建议):入口:控制台的 STOP ALL。差别:平时演练过,真遇到 Agent 失控时一键暂停才敢按、才知道按下去会停什么。
  3. 规则变更留记录(通用建议):入口:控制台的规则管理。差别:谁改了规则、什么时候改的能查到,出问题回查时不用凭记忆猜。

补充常见问题

  • 没有 KVM 能不能装:不能绕过,Agent 的 microVM 依赖它;买机器、开云主机前先确认,这是最硬的门槛。
  • 个人只跑一个 Agent 值不值:不值,三层架构是为团队设计的,个人轻量使用维护成本会超过收益。
  • 规则可读等于写得对吗:不等于,上线前务必用测试 Agent 把拦截、放行、转人工三条路径都走一遍。
推广AgentPlaza 免费下载|自托管 AI Agent

关注「软件教程管家」

回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。

版权与使用提示

本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›

上次编辑至今:11小时 · 内容还比较新鲜

公告

契机库网站正式上线!

了解更多
正文完
 0
评论(没有评论)