Agent Zero 完整指南从 Docker 一键启动到自定义工具开发【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zeroAgent Zero 是一个开源 AI 代理框架它的定位不是更聪明的聊天框而是给 AI 一台完整跑在容器里的 Linux 电脑浏览器、桌面、终端、文件系统都是真的AI 可以直接操作。适合的场景是你需要 AI 帮你改网页、处理文档、跑自动化任务而不只是回答问题。新手用 Docker 镜像十几分钟就能跑起来有经验的开发者可以在不改动核心源码的前提下给它加工具、加插件。一、Docker 三步跑起来最短路径只有三步在 Docker Desktop 的镜像市场里搜索agent-zero拉取镜像并运行等容器启动把宿主机端口映射到容器80端口被占用就换5080:80浏览器打开http://localhost:端口进入 Web UI。完成后你看到的是这样一张欢迎页左侧是聊天列表和任务面板中间是功能入口网格New Chat、Projects、Memory、Settings、Files 等右下角的 System Resources 面板显示容器内的 CPU、内存、磁盘占用——说明容器已经健康运行。接下来在设置页填一个 LLM 提供商的 API key云端、账号登录或本地模型都支持就可以发第一条任务消息了。如果不用 Docker Desktop命令行等价于一条docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero想用源码仓库自己搭建clone 地址为 https://gitcode.com/GitHub_Trending/ag/agent-zero 安装步骤在 docs/setup/installation.md。二、功能实战四个高频使用场景不按目录罗列直接按你会真实下达的任务来看。让 AI 打开网页并动手改Agent Zero 内置的浏览器工具不是截图给你看而是带 DOM 标注的它打开页面后你可以对页面元素做标注把它变成检查、修改、提取、复查等具体指令。典型用法让 AI 打开一个模板站点你标注重型区块要求它按你项目的技术栈重新实现或者打开你本地的应用逐条标注 UI 问题让它修复。容器里还有一个完整的 XFCE Linux 桌面AI 可以驱动 Blender 这类 GUI 软件——这在纯 API 型的 AI 工具里是做不到的。和 AI 共同编辑文档聊天里丢出去的表格和文稿改起来全靠复制粘贴。Agent Zero 的文档协作是文件级的Markdown、Writer、Spreadsheet、Presentation 文件直接创建和编辑比如建一个可编辑的预算模型带假设项和月度预测。文件存在工作目录里改完还能追溯不会像聊天记录那样越滚越糊。多代理分工一个代理干所有事效率有限。Agent Zero 支持主代理把研究、编码、分析、评审这类子任务委托给专职子代理call_subordinate 工具也能通过 a2a_chat 在多个代理之间开协作会话。你只需要给最终目标拆解和调度由主代理完成。把 AI 接回你的真实文件默认情况下 Agent Zero 关在 Docker 里这是安全设计。但它提供了宿主机桥接A0 CLI在你本机装一个连接器容器里的 AI 就能读写你电脑上的真实仓库和文件推理仍在 Agent Zero 里连接器只负责打通文件路径。另外把文件放进容器内的/a0/usr目录AI 也能直接处理它们。三、进阶实践按代价从小到大扩展官方文档给出的建议很明确想加功能优先级是插件 代理档案 扩展越往后越接近框架内部。自定义工具不用改源码核心工具都在 tools/ 目录每个工具是一个 Python 文件继承helpers/tool.py里的Tool基类实现async execute(...)并返回统一的 Response 结构。框架采用文件级动态发现把新工具文件放进工具目录就会被加载不需要手动注册。约定写在 tools/AGENTS.md每个工具必须配套同名.py.dox.md说明文件描述参数、行为和副作用。想动手前先看tools/里现成工具的实现模式照抄结构最稳。给 AI 换一种工作风格Agent 档案改变的是提示词层的行为让 AI 变成谨慎的财务分析师、或者写技术视频脚本的策划。入口在聊天输入框附近的状态栏点Create new Agent Profile后AI 会用对话方式引导你完成创建——它会追问档案擅长什么、给出合理默认值、创建前让你确认摘要。档案只作用于当前聊天别的聊天可以保持自己的档案。插件和扩展的边界小功能用插件本地插件放在运行实例的/a0/usr/plugins/下有plugin.yaml做描述可独立启停、易删除。docs/guides/create-plugin.md 用一个极小的前端插件完整走了一遍流程。扩展extensions/python/挂在消息循环的各个生命周期钩子上——比如系统提示词组装在system_prompt/每轮对话后的记忆、时间、代理信息注入在message_loop_prompts_after/。只有当插件和档案都不够用时才动扩展改完保持能用一句话说清楚的粒度。四、常见坑与解法聊天发出后没反应十有八九是设置页没配 API key或者模型 ID 前缀写错了。openai/gpt-x这种带提供商前缀的写法只在 OpenRouter 上对用原生 OpenAI 提供商时前缀要去掉。ChatGPT Plus 订阅不含 API 额度必须单独填 API key。代码执行工具不工作确认 Docker 正在运行macOS 上要记得在 Docker Desktop 设置里授权访问项目文件镜像版本过旧时删掉旧镜像重新拉取。备份恢复后密钥丢了secrets 存在容器内的/a0/usr/secrets.env并不总被打包进备份归档恢复后要手动补一份。另外更新 Agent Zero 时走设置页的 Update 标签页内部会自己管理备份。更多问题直接查 docs/guides/troubleshooting.mdFAQ 覆盖了本地模型接入、限流配置、浏览器工具报错等场景。五、学习路径与关键目录文档入口docs/README.md新手先看 docs/quickstart.md进阶看 docs/developer/工具实现tools/每个文件旁有.dox.md说明是最好的活文档插件与技能plugins/社区 100 插件、skills/可复用任务包提示词与行为定义prompts/ 和 agents/AI 的行为在这里是明文可读的测试参考tests/ 覆盖了工具契约、插件行为、WS 安全等改东西前先看有没有对应测试六、一句话总结Agent Zero 帮你的事只有一件把AI 陪你聊变成AI 替你干——操作浏览器、编辑文档、执行代码、调度子代理并且每一层都可以打开看、改得动。【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考