ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

OmniAgent Hyper-Harness超级脚手架:Sentinel规划+Guardian守卫+动态并发,复杂任务执行的完整设计

2026/10/3 12:47:39 拓冰建站 浏览量
OmniAgent Hyper-Harness超级脚手架:Sentinel规划+Guardian守卫+动态并发,复杂任务执行的完整设计 OmniAgent Hyper-Harness超级脚手架Sentinel规划Guardian守卫动态并发复杂任务执行的完整设计【免费下载链接】OmniAgentAn agent capable of self-evolving and dynamically hardening security项目地址: https://gitcode.com/gh_mirrors/om/OmniAgentOmniAgent是一个开源的自我进化 Agent 框架其核心模块Hyper-Harness 超级脚手架专为高效、安全地执行复杂任务而生。它由三大能力组成Sentinel 规划 Agent负责把多步骤任务拆解成结构化里程碑Guardian 守卫 Agent为高风险操作装上安全闸门动态并发工具执行则把串行等待变成并行加速。三者协同让 Agent 在面对长链路、多文件、高风险任务时既快又稳。本文带你完整看懂这套设计。为什么需要 Hyper-Harness 超级脚手架普通 Agent 执行复杂任务时常遇到三个问题任务太大没头绪、操作风险没把控、工具串行太慢。Hyper-Harness 正是针对这三点打造的高效、安全、智能执行引擎在 README.md 中被称为 An efficient, safe, and intelligent execution scaffold。它的三大支柱一一对应上面的痛点痛点超级脚手架的解法任务太复杂Sentinel 动态多 Agent实时分析任务复杂度激活规划角色操作有风险Guardian 安全守卫执行前 LLM 深度审查 静态高风险拦截长链路太慢动态并发工具执行自动解析依赖独立工具并行调用想深入了解整体架构可阅读 README.md 中的架构图与 omniagent/agents/ 目录说明。Sentinel 规划Agent如何为复杂任务拆解里程碑Sentinel哨兵是一个轻量级规划 Agent它只负责思考和验证不执行任何工具。它把一个大任务拆成若干里程碑逐个跟踪进度实现先规划、后执行。源码位于 omniagent/agents/sentinel.py。Sentinel 何时自动激活Sentinel 不会为每个任务都启动而是满足以下任一条件才激活避免无谓的 LLM 开销多步骤关键词任务描述中出现 然后 / 接着 / 之后 / finally 等词达到阈值默认 ≥2 次反思连续失败主 Agent 连续反思失败达到阈值默认 ≥2 次说明任务确实棘手目录跨度大Bash 操作涉及多个不同目录默认 ≥3 个说明任务横跨多个工作区LLM 复杂度估算以上规则都未触发时用一次轻量 LLM 调用判断任务是否需要规划提示如果任务能匹配到某个已有SkillSentinel 会直接判定无需规划因为技能已能处理避免重复拆解。里程碑拆解与进度跟踪一旦激活Sentinel 会调用 LLM 把任务拆解成有序的里程碑列表每个含描述、成功标准、依赖项并遵循少而大原则——优先生成少量有意义的大里程碑而非一堆零散小步骤。它还会做两件关键的事进度验证每完成一个里程碑用 LLM 对照成功标准验证是否真正达成而非盲目推进。跨会话恢复计划会以 JSON 持久化到.omniagent/sentinel/目录即使会话中断下次也能从中断处继续。相关参数可在 omniagent/config/models.py 的SentinelConfig中调整例如max_milestones最大里程碑数默认 10。Guardian 守卫Agent高风险操作的安全闸门如果说 Sentinel 管想清楚Guardian守卫就管别闯祸。它是一个轻量级审查 Agent在高风险操作执行前介入提供静态策略之上的 LLM 深度审查。源码位于 omniagent/agents/guardian.py。三重触发条件Guardian 满足以下任一条件即被激活高风险 Bash 命令命中 ToolPolicy 高风险级别或内置的高危模式如rm -rf /、sudo、mkfs、dd of/dev/、curl | bash管道远程脚本等文件写入累积单轮响应中的文件写入/编辑操作达到阈值默认 ≥3 次风险操作后的最终响应完成一连串风险操作后对最终回复做一次复盘LLM 深度审查与风险分级触发后Guardian 做三件事执行前审查在执行前就拦截常见错误路径写错、缺失导入、意外副作用风险标注给操作打上low / medium / high / critical风险等级自我修正建议不只简单拦截而是给出具体的修复建议尤其值得称道的是当命令会执行某个脚本文件时Guardian 会读取脚本内容进行深度审查专门揪出命令本身看不出、却藏在脚本里的危险操作如find ... -exec rm、递归删除、数据外传。一旦判定为critical配合auto_block_on_critical会自动拦截。只读命令ls、grep、cat等会被自动跳过审查既安全又不拖慢速度。动态并发工具执行把串行等待变成并行加速传统 Agent 往往一个工具跑完再跑下一个长链路任务因此很慢。OmniAgent 的动态并发工具执行自动解析工具间依赖把串行等待变成异步并行。核心实现在 omniagent/agents/reflexion.py 的_execute_actions方法中。它的分流逻辑非常清晰并行批相互独立、只读的工具如读取、检索类→ 用asyncio.gather并行调用串行队列有依赖或会改变状态的工具如bash、写入、编辑→按顺序串行执行保证安全这样既拿到了并行的速度又不会因并发写而产生竞态。你可以用enable_parallel_execution开关控制该能力并会记录parallel_batches、parallel_tools等统计信息方便观察加速效果。三者协同一条复杂任务的完整执行路径把三块拼起来一次复杂任务的执行流大致是这样的入口判断任务进来Sentinel 评估复杂度——简单任务直接放行复杂任务则拆解里程碑。执行阶段每个里程碑内的工具调用走动态并发独立只读工具并行、写操作串行长链路显著提速。安全把关其中任何高风险操作都会触发Guardian审查风险过高则拦截并给出修正建议。进度推进Sentinel 验证里程碑达成后推进到下一里程碑直到全部完成或跨会话恢复。这套规划 并发 守卫的组合正是 Hyper-Harness 相对单循环 ReAct 架构在任务成功率上的核心优势。快速上手安装与启动 OmniAgent只需 Python 3.11 和一个 LLM API Key 即可体验完整能力pip install -e . omniagent onboard # 交互式配置选择模型供应商、填入 API Key omniagent chat # 终端交互 omniagent serve # 启动 Web UI → http://127.0.0.1:18790配置分层为 默认值 →~/.omniagent/config.yaml→ 环境变量Sentinel 与 Guardian 的相关阈值都可在config.yaml中按需调整。模块路径索引规划 Agentomniagent/agents/sentinel.py守卫 Agentomniagent/agents/guardian.py反思循环与动态并发执行omniagent/agents/reflexion.py配置模型SentinelConfig / GuardianConfig / 并发开关omniagent/config/models.py整体架构与对比表README.mdHyper-Harness 超级脚手架用规划、并发、守卫三件套把复杂任务从慢且险变成快且稳——这正是 OmniAgent 作为自我进化 Agent 框架在执行层给出的完整答案。【免费下载链接】OmniAgentAn agent capable of self-evolving and dynamically hardening security项目地址: https://gitcode.com/gh_mirrors/om/OmniAgent创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考