免费获取学习方案
ARTICLE DETAIL

资讯详情

深耕编程基础知识与建站技术分享的一线实战洞察。

OmniAgent内置工具全清单:文件、终端、Web搜索18大工具,AI Agent的效率工具箱

OmniAgent内置工具全清单:文件、终端、Web搜索18大工具,AI Agent的效率工具箱 OmniAgent内置工具全清单文件、终端、Web搜索18大工具AI Agent的效率工具箱【免费下载链接】OmniAgentAn agent capable of self-evolving and dynamically hardening security项目地址: https://gitcode.com/gh_mirrors/om/OmniAgentOmniAgent 是一个可自进化、安全动态加固的开源 AI Agent 框架内置 18 个开箱即用的工具覆盖文件操作、终端命令、Web 搜索、进程管理与长期记忆等核心场景。本文带你 5 分钟看懂这套AI Agent 效率工具箱的完整清单、架构设计与安全防护机制帮助你快速判断它能否胜任你的自动化任务。 18 个内置工具速览一张表看懂功能分布所有内置工具都集中在 omniagent/tools/ 目录另有记忆工具位于 omniagent/agents/memory_manager.py。完整清单如下分组工具名功能一句话说明源码位置文件操作read_file带行号分页读取文件file_tools.py文件操作write_file写入/覆盖文件自动创建目录file_tools.py文件操作edit_file精确字符串替换防误改file_tools.py搜索导航ls列出目录内容含文件大小ls_tool.py搜索导航find按 glob 模式定位文件find_tool.py搜索导航grep正则搜索文件内容支持包含/排除规则grep_tool.py搜索导航diff对比两个文件输出 unified diffdiff_tool.py终端bash执行 Shell 命令支持后台与超时控制bash_tool.py进程管理process_list列出运行中进程及 CPU/内存占用process_tool.py进程管理process_kill按 PID 终止进程需审批process_tool.py数据处理load_json加载并格式化解析 JSONjson_tool.py数据处理save_json以缩进格式保存 JSON 数据json_tool.pyWebweb_searchBrave Search 网页搜索最多 10 条web_tools.pyWebweb_fetch抓取网页并转为纯文本web_tools.pyWebhttp任意 HTTP 请求GET/POST/PUT…http_tool.py长期记忆memory_search混合检索跨会话记忆附来源引用memory_manager.py长期记忆memory_get按行号范围读取记忆文件memory_manager.py 记忆工具仅在配置开启记忆功能时自动注册见 reflexion.py基础 16 个工具则在启动时全部注册。️ 工具是怎么组织的三步看懂架构想理解这套工具箱的设计只需看三个核心概念1. 统一基类每个工具都继承自 base.py 中的Tool抽象类只需声明name、description和参数 schemaLLM 就能按 function calling 规范正确调用它。2. 统一执行所有工具实现同一个execute方法返回结构化的ToolResult成功/输出/错误/元数据无论成败 Agent 都能稳定解析出错时不会崩在解析环节。3. 统一注册ToolRegistry 集中管理全部工具默认 14 个基础工具在 reflexion.py 的注册入口 一次性挂载扩展机制extensions/base.py还支持第三方工具即插即用。 文件操作三件套读、写、精确改文件工具file_tools.py是编码类 Agent 的地基细节上很见功力read_file带行号输出支持offset/limit分页读取大文件读完还会提示还有多少行file_tools.py避免一次性撑爆上下文。write_file写入时自动创建父目录并返回行数、字节数等元数据file_tools.py。edit_file要求old_text精确且唯一匹配若文本出现多次会直接拒绝修改并提示请更具体一些file_tools.py——这是防止 Agent 误伤代码的关键防线。 搜索与导航四件grep、find、ls、diff这一组工具对应命令行开发者的日常肌肉记忆源码在 grep_tool.py、find_tool.py、ls_tool.py、diff_tool.py工具亮点细节grep完整正则支持include/exclude按扩展名过滤忽略.和_开头目录结果限 200 条防刷屏grep_tool.pyfind**/*.py式 glob 匹配只返回文件超过 100 个自动截断提示ls目录优先排序自动换算 B/KB/MB 文件大小diffunified diff 输出附新增/删除行数统计超长自动截断对新手很友好的一点这些工具的输出格式对 LLM 极其友好——文件:行号: 内容的标准格式让模型能直接定位而不需要你手动翻译结果。 Web 工具搜索、抓取、任意请求Web 能力是 Agent 做调研、查资料的核心web_tools.py、http_tool.pyweb_search调用 Brave Search API返回标题URL摘要最多 10 条。⚠️ 需要设置环境变量BRAVE_API_KEY未配置时会明确报错而不是静默失败web_tools.py。web_fetch抓取网页自动剥离 HTML 标签转为纯文本JSON 响应自动美化内容上限 10 万字符、最多跟随 5 次跳转web_tools.py。http万能请求工具支持 GET/POST/PUT/DELETE/PATCH 等 7 种方法可自定义请求头与 body响应超过 5 万字符自动截断。安全方面所有联网工具都经过 url_security.py 校验拦截内网/私有地址请求SSRF 防护并逐个验证每一次跳转目标。 终端与进程管理有牙齿也有护栏bash异步执行命令默认 30 秒超时超时会直接 kill 进程支持background参数后台启动如起一个服务并返回 PIDbash_tool.py。process_list基于 psutil 列出全部进程按 CPU 占用降序排列支持按名称过滤。process_kill先优雅终止、5 秒无响应再强杀权限不足会返回明确错误。该工具被标记为高危默认需要用户审批。 记忆与配置工具跨会话的长期大脑开启记忆后Agent 还会多出两件跨会话武器memory_manager.pymemory_search用混合检索向量关键词搜索历史记忆每条结果都带文件#行号级来源引用方便核对。memory_get按行号精确读取记忆文件片段按需加载节省 Token。工具权限策略定义在 policy.py按minimal只读/coding开发/full全量三档管控。️ 安全加固每个工具都有刹车片OmniAgent 宣传的动态加固安全在工具层体现为四道防线危险命令黑名单bash工具内置rm -rf /、mkfs、fork 炸弹等危险模式检测命中直接拦截bash_tool.py路径沙箱所有文件类工具经过safe_path校验拒绝路径穿越攻击fs.pySSRF 防护Web/HTTP 工具只允许访问公网地址跳转逐跳校验审批与审计bash、process_kill等高危操作默认进入审批流approval.py所有决策留痕于审计日志audit.py。这套工具信任级别 四层动态扫描的组合是它与普通 Agent 框架拉开差距的地方。✅ 新手上手建议按场景选工具只想读资料、零风险把tools.profile设为minimal只开放read_file与搜索类工具日常编码coding档位即可文件三件套 grep/find bash 覆盖 90% 场景需要上网调研full档位并配置BRAVE_API_KEY让web_search真正可用精细化管控通过配置的tools.allow/tools.deny列表可增删任意工具显式拒绝规则优先级最高reflexion.py。一句话总结18 个工具 统一架构 多层安全让 OmniAgent 既能像熟练的命令行工程师一样干活又始终有一道你亲自确认的刹车。想体验的话pip install -e .之后运行omniagent onboard即可完成 LLM 后端配置omniagent chat即可在终端开始对话完整步骤见 README.md。【免费下载链接】OmniAgentAn agent capable of self-evolving and dynamically hardening security项目地址: https://gitcode.com/gh_mirrors/om/OmniAgent创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表