Agent Zero 智能体框架实战：从容器启动到自建工具
【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero
凌晨两点，你不想自己再翻一遍网页找那个数据。Agent Zero 是一款开源智能体框架，把搜网页、读文档、跨会话记忆都做成现成工具，AI 自己动手完成。下面带你做三个动作：跑起来、看懂工具、动手加一个。
Agent Zero 容器化部署最短路径
最短路径只有一条：容器化启动。
- 拉镜像。在 Docker Desktop 的镜像市场搜索 agent-zero，点 Pull 拉取。
- 配端口。点 Run 进入可选设置，宿主机端口填 80、22，或留 0 交给随机分配。
- 开浏览器。访问容器启动后打印的本地地址，进入 Web 界面。
- 填密钥。在 Settings → External Services 里配置聊天模型 API Key，页面顶部的红色告警会消失。
跑起来的标志：看到带 New Chat、Projects、Memory、Scheduler 磁贴的主界面，左侧是空的聊天列表——到这里就算成功了。
镜像市场中的 agent-zero
Agent Zero 主界面
跑一个任务，看 Agent Zero 工具怎么动
工具是文件，不是配置项。内置工具全部放在tools/目录，框架启动时自动扫描，文件名即能力。
任务一：让智能体查资料。
- 下指令："搜一下 XX 的最新进展。"
- 框架路由：把这句话交给
search_engine.py，查询词作为参数传入。 - 工具返回：请求搜索引擎，把结果集打包成 Response 交还。
- 你看结果：回复里列出搜索摘要和来源链接，可以直接追问。
任务二：让它想起上次聊过什么。
- 提问："我们上次讨论到哪了？"
- 记忆接管：
plugins/_memory/记忆插件从磁盘记忆库读取相关条目。 - 工具返回：匹配当前话题的记忆片段。
- 你看结果：另一个会话里说过的结论出现在这次回复里，上下文没丢。
一次任务创建的工具调用链
给 Agent Zero 加一个新工具：只改一个文件
先做判断：加能力，还是改行为。要"多一个能力"，写工具；要"改某个生命周期的行为"，写扩展。
工具侧的最小形态长这样（继承 Tool、写 async execute、返回 Response，基类契约在helpers/tool.py）：
class MyTool(Tool): async def execute(self, **kwargs) -> Response: return Response(message=do_work(self.args), break_loop=False)建文件：放进tools/目录，完事。框架的动态发现机制会把它加载进来，不需要改任何注册表。跑验证：在 Web 界面让智能体调它，盯返回内容是否符合预期。
扩展侧记住目录结构就行：extensions/python/按生命周期阶段划分子目录，文件名前缀数字决定执行顺序，例如_10_main_prompt.py组装系统提示词、_60_include_current_datetime.py每轮注入当前时间。官方建议一句话：能做成插件，就别做扩展。
Agent Zero 参数调优：先动这三个旋钮
调参有顺序，别反过来。
聊天模型
- 改什么：模型名、温度、上下文长度。
- 为什么排第一：所有工具的输出质量压在模型上，这是地基。
- 怎么验证：跑同一个任务，对比返回内容的前后差异。
Agent 角色配置
- 改什么：
agents/下 profile 里的角色设定与行为边界。 - 为什么排第二：模型定了，再决定它"是个什么样的人"。
- 怎么验证：同一任务，观察回答口吻与工具选择的变化。
单工具参数
- 改什么：单个工具的开关与输出详略。
- 为什么排第三：改动小、见效快，适合收尾时调。
- 怎么验证：直接触发该工具，看输出详略是否符合预期。
Agent Zero 设置面板
三个场景，三套 Agent Zero 工具组合
场景不多挑，痛点、文件、产出物，各占一行。
自动调研报告
- 人工翻网页、复制粘贴素材太慢。
search_engine.py+document_query.py+response.py。- 一份结构化 Markdown 调研报告。
定时巡检
- 固定时间点的数据没人盯。
scheduler.py+notify_user.py。- 每天按时推送到通知里的一条巡检结果。
文档问答
- 老文档太长，翻到关键词太慢。
document_query.py。- 直指文件具体内容的回答，不靠记忆。
技能激活时的工具执行过程
Agent Zero 新手最容易卡住的四个地方
四个坑都常见，也都好躲。
工具和插件的边界在哪？工具只给智能体多一个能力；改界面、做完整功能走插件。工具里开始写 UI 逻辑，就是走错路了。
一个工具塞多件事可以吗？别塞。一个工具只管一件事，维护更轻，智能体选择更准，出错也更容易定位。
改完参数不验证怎么办？跑同一个任务，对比前后输出。没有对比，就没有"改好了"。
为什么每个工具旁都有 .dox.md？那是工具的说明文件。你自建的工具也配一份同名的，下一个人和三个月后的你才看得懂。
卡住的时候，回docs/guides/看新指南。工具系统不是背会的东西，是把任务跑起来。多用多顺，你的 Agent Zero 会越跑越明白。
【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
