
别让AI只会聊天Agent Zero智能体框架从Docker启动到自建工具【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero你有没有过这种经历让 AI 查个网页、跑段代码、记住上次聊到哪它却回你一句作为语言模型我做不到Agent Zero 是个开源 AI 智能体框架它给 AI 的回复通道外又塞了一整台 Linux 电脑、一个浏览器和一套可以自己往里加零件的工具系统——查资料、执行代码、跨会话记忆全都变成了它能自己动手的动作。这篇就带你把它跑起来看清每个工具替你干哪类活最后自己写一个。️ 它和聊天机器人的最大不同AI 有了自己的电脑先建立认知锚点同类项目大多停留在你发消息 → 它回文字Agent Zero 的定位是给智能体一台完整的工作环境。具体多到什么程度它跑在 Docker 容器里自带一个真实的 XFCE Linux 桌面——智能体可以开 Blender 建模、进终端敲命令、操作 GUI 软件内置浏览器支持在网页元素上点标注直接把把这个按钮改圆角变成一条可执行的 JS 指令。更关键的是它几乎没有任何黑盒提示词在prompts/工具在tools/插件在plugins/全都能打开看、动手改。为什么说透明才是它最值钱的设计工具系统就是它的核心。框架启动时自动扫描tools/目录文件在就能用不注册、不配置。这意味着扩展它的方式非常直接你想让它多一种能力就往里放一个新文件。下面先跑起来再逐层拆。 三步启动Docker 拉镜像浏览器就能聊这一节解决怎么让它跑起来。最短路径是 Docker Desktop全程不装依赖在 Docker 镜像市场搜索agent-zero点 Pull 拉取镜像点 Run 启动容器按提示配置端口映射看到容器状态变绿浏览器打开本地地址端口 80 被占用就换-p 5080:80进入主界面聊天、工具调用、设置面板都在这个窗口里。启动后第一件事是接模型在设置里选一个主模型负责对话一个轻量模型负责内部杂活。选完发一条具体任务比如用浏览器调研三个方案并总结取舍就能看它边调工具边干活。容器启动后的 Agent Zero 主界面如果你的智能体需要碰你电脑上的真实文件还有个 A0 CLI 连接器装在宿主机上不装在容器里让同一套记忆和技能的智能体越过 Docker 边界操作本地仓库安全边界依然可控。 它到底能替你干什么五类工具地图这一节回答它有哪些活能接。工具集中在tools/目录插件式工具则藏在plugins/里按干的活分五类干的活内置实现对应你遇到的麻烦查实时信息tools/search_engine.py模型知识过期先搜再答读文档和图片tools/document_query.py、tools/vision_load.py老文档翻不动贴进来的图看不懂操作网页_browser插件帮我看看这个页面停在口头执行与值守_code_execution插件、tools/scheduler.py、tools/notify_user.py代码没人跑夜班没人盯结果没人收跨会话记忆_memory插件换个聊天窗口就失忆多智能体协作tools/a2a_chat.py、tools/call_subordinate.py、tools/parallel.py一个会话又查又写又审忙不过来几个组合起来才见真章的例子夜间数据巡检scheduler.py定时触发_code_execution跑脚本异常时notify_user.py主动把结果推给你全程没人守着偷师别家设计浏览器 Annotate 模式点中一个你喜欢的 hero 区块让智能体照着重实现到你自己的技术栈里老手册问答document_query直查文件内容作答不靠模型回忆答错了能溯源到原文。主智能体把子任务分派给专职子代理后各自上下文保持聚焦 三步加一个新工具想让它多一种能力工具系统的门槛低得有点反直觉建文件在tools/下新建my_tool.py写一个继承Tool的类基类契约在helpers/tool.py写 execute核心就是一个async def execute(...)干完活返回Response把结果交还给智能体验证框架的动态发现机制会自动加载它不用改任何注册表重启后在 Web 界面让智能体调一下看返回是否符合预期。有一个项目内固化的习惯值得抄tools/里每个*.py都配了同名的*.py.dox.md说明文件写清工具的职责、参数和副作用。你加新工具时照做三个月后的你才找得回去。在开发环境里调试扩展与工具的行为⚙️ 效果不对时按顺序调这三样这一节解决跑是能跑但输出总差点意思。设置面板里的模块建议按这个顺序动每改一项就用同一个固定任务对比前后输出——没有对比就没有改好了聊天模型先定模型和温度、上下文长度。所有工具的输出质量都压在模型上这是地基Agent 配置模型定了再决定它是个什么样的人——角色设定、行为边界都在这层工具参数单个工具的开关和输出详略放最后调改动小、见效快。另外别跳过项目里的agents/目录里面按场景预置了默认、研发、研究员等智能体档案直接套用比自己从头写快。设置页里的模型与智能体配置 卡住了先看这四个坑然后走三步进阶新手最容易碰到的问题按现象 → 原因 → 正确做法拆开改了插件却没生效→ 改完插件后 Web UI 的扩展列表没有自动重建 → 改完重启一次实例再验证这是插件指南里明说的流程。AI 突然失忆或带着错误假设→ 会话上下文不会自动沉淀成记忆陈旧的 memory 还会持续误导它 → 打开记忆面板检查、删掉过期条目再让它继续。一个工具塞太多职责→ 智能体是靠工具描述来选工具的描述一杂它就选不对你也难维护 → 一个工具只管一件事拆开后各自配.dox.md说明。把工具当插件做→ 工具只是多给智能体一个能力改界面、加完整功能该走plugins/→ 先问自己我是要多一个能力还是要改一个行为再选目录。跑通之后成长路线可以这么走先锁定一个场景比如上面说的夜间巡检把调度、执行、推送串完整然后照docs/guides/create-plugin.md里的最小插件教程做一个只动前端的小插件把改行为这条路走通最后再动手写扩展去插手特定生命周期节点——到那时你会发现整个工具系统已经完全在你手里。完整的进阶资料在docs/guides/目录下随用随查。【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考