从Docker启动到自建工具Agent Zero AI智能体框架完整指南【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero想让 AI 自己查资料、跑任务、记住上次聊到哪Agent Zero 是开源AI智能体框架智能体能自主调用工具干活的 AI 程序内置搜索、浏览器、记忆、调度等工具。这篇给一条 Docker 部署路径、一次真实任务走查以及加工具、改行为的最小改法。 跑起来一条 docker run 命令部署本机装依赖的路子不用走Docker 一条命令就能起。确认 Docker 已安装并在运行Docker Desktop 或命令行均可。终端执行docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero浏览器打开 http://localhost:80在欢迎页完成 onboardingSettings → External Services → API Keys 填入模型供应商和密钥。用 Docker Desktop 的话等价操作是搜 agent-zero 镜像 → Pull → Run 并配好端口映射。验收标准看到带 New Chat、Projects、Memory、Scheduler 等入口按钮的仪表盘右下角有 System Resources 资源面板就是跑起来了。容器启动后的 Agent Zero 主界面左侧是聊天列表中间是功能入口 跟一个真实任务走查调研并汇报用帮我调研 3 个自托管搜索服务对比部署难度给个推荐当第一个任务发出去。第一步智能体调用 tools/search_engine.py 做联网搜索拿到候选清单这一步替代的是你手工翻十几个搜索页。接着它可能调浏览器插件plugins/_browser/插件可插拔的功能包打开候选项目的官方文档核实真实的安装步骤。如果聊天里附了本地文档document_query.py 会直接查文件内容不用你先摘录重点。产出落在聊天窗口一份带对比的推荐结论。人不在电脑前时notify_user.py 会把结果推成一条通知。过程中你偏好自托管这类判断会被记忆插件plugins/_memory/存下换会话还在。聊天窗口里每步工具调用GEN/SKL 日志行都会流式显示任务之外还有这些现成能力能力位置干什么派活与协作tools/call_subordinate.py、a2a_chat.py、parallel.py子任务交给子代理、智能体互聊、多步并行定时执行tools/scheduler.py创建、列出、运行、删除定时任务读图tools/vision_load.py理解你发来的图片跨会话记忆plugins/_memory/存、查、删、导出记忆 最小改动路径加一个能力 vs 改一个行为工具管多一个能力扩展挂在消息处理循环特定阶段上的代码管改一个行为两件事放两个目录。加一个能力往 tools/ 放文件。新建 weather.py继承 helpers/tool.py 里的 Tool实现 async execute 并返回 Responsefrom helpers.tool import Tool, Response class WeatherTool(Tool): async def execute(self, **kwargs): city self.args.get(city, ) return Response(messagef{city} 晴 25℃, break_loopFalse)框架启动时扫描 tools/ 自动发现不用改任何注册表。验证在 Web UI 里让智能体查一下上海天气看它是否选中你的工具、返回内容是否符合预期。别这样给工具写注册配置 → 改成这样文件放对位置就够了发现机制自动生效。别这样一个文件里塞搜索、汇总、通知三段逻辑 → 改成这样按动作拆开搜索归搜索、通知归通知各占一个文件。别这样工具没有说明文件 → 改成这样补同名的 weather.py.dox.md写清参数、输出和 break_loop是否终止本轮循环的开关行为tools/AGENTS.md 要求每个工具都配。改一个行为往 extensions/python/ 对应阶段目录放文件。目录名就是生命周期阶段system_prompt/ 组装系统提示词_10_main_prompt.pymessage_loop_prompts_after/ 每轮消息注入上下文_60_include_current_datetime.py 塞当前时间、_70_include_agent_info.py 塞智能体信息。文件名前缀数字决定执行顺序你的钩子放进该阶段目录、起个不冲突的编号即可。验证同一个会话里对比改动前后的注入内容。别这样把多一个工具写成扩展 → 改成这样能力进 tools/扩展只在需要插手某个生命周期点时用要带界面的完整功能走 plugins/。✅ 跑通之后做三件事按固定顺序做先验输出、再调配置、再留惯例。先验同一任务连跑两遍对比改动前后的输出差异。没有对比就没有改好了这回事。再调按依赖关系动设置——先 Chat Model聊天模型与参数所有工具输出的地基再 Agent Config默认智能体档案档案文件在 agents/最后调单个工具的开关和输出详略。每改一项用同一个任务验收一次。设置面板Agent Config、Chat Model、Utility Model 等入口都在这里再留遵守项目惯例——新工具配同名 .py.dox.md扩展文件名保留数字前缀改动涉及提示词时跑一下 tests/ 里的相关用例再收工。路线很直接先跑通一个真实任务再写第一个工具然后碰扩展改生命周期最后按 docs/guides/ 里的 browser、memory、mcp-setup 等指南逐个深入。拿不准细节就去读 docs/每个工具旁的 .dox.md 比源码好读。【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
