企业官网建设流程全解析

Agent Zero 快速上手：10 分钟跑起一个能自己干活的 AI 智能体

【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero

AI 助手聊天很在行，但一说到"干活"就露怯——资料查不了、代码跑不了、上次聊到哪也没处记。Agent Zero 这个开源 AI 智能体框架就是冲着这一点来的：它把工具系统放在框架正中央，联网搜索、读文档、开浏览器、存记忆、派子代理，全是内置能力，还能往里加你自己的工具。这篇指南讲四件事：怎么最快把它跑起来、它的工具能接哪些活、第一轮该调哪几个设置、以及怎么加一个属于你自己的工具。

🐳 两分钟用 Docker 拉起，不用碰任何环境

不用 clone 代码，不用装依赖，有 Docker Desktop 就行：

1. 在镜像市场搜agent-zero，把镜像拉下来；
2. 点 Run 启动容器，确认端口映射无误；
3. 浏览器打开本地地址，完事。

在 Docker Desktop 镜像市场里搜 agent-zero

聊天、工具调用、设置面板全在一个页面里。刚启动时你会看到一条醒目的提示：还没配大模型的 API key。没有模型，智能体转不起来，所以这一步省不掉。

容器跑起来后的主界面：聊天、记忆、调度、设置一页全有

环境就绪，接下来看它到底能接哪些活。

🧰 能干什么：五类可以交给它的活

所有工具集中在tools/目录，框架启动时自动扫描发现——不注册、不配置，文件放那儿就能用。比背文件清单更实用的记法，是按你想交给它的活来分：

协作类工具里有三个值得单独认识。a2a_chat.py让多个智能体互相对话，相当于开一场几个人互相补充视角的脑暴会；call_subordinate.py是老板工具——主智能体把研究、编码、分析丢给专职子代理，自己只盯结果；parallel.py把互不依赖的步骤并行跑，长任务不再一步一步排队。

⚙️ 第一轮设置：先转这三个旋钮

启动后第一件事是进设置页。别乱点，按这个顺序动，每改一项就拿同一个任务对比一下效果：

1. 聊天模型（Chat Model）。先定模型，再定温度、上下文长度这类参数。所有工具的输出质量最后都压在模型上，这是地基。
2. Agent 配置（Agent Config）。模型定了，再决定这个智能体"是个什么样的人"：角色设定、行为边界。
3. 工具参数。单个工具的开关和输出详略放最后调——改动小、见效快，错了也容易回退。

设置页先选模型和参数，再挑默认的 Agent 配置

参数就位，就可以给它派真活。

🎯 先跑三个任务：从"人肉复制粘贴"到"没人值夜班"

布置第一个任务：让它自己查资料、写汇报

有几类场景特别合它的胃口，共同点是活路明确、又要在多个工具之间来回倒腾：

• 自动调研报告。丢一个主题，它搜资料、读文档、汇总成文一条龙。解决的是"人肉复制粘贴"。
• 定时巡检。配合调度工具定期跑脚本、盯数据。解决的是"没人值夜班"。
• 文档问答。document_query直查文件内容，不靠记忆。解决的是"老文档翻不动"。
• 多代理分工。研究、编码、评审各派一个子代理。解决的是"一个会话干所有事"。

跑顺这几个之后，你会对每个工具在干什么有体感，这时候再想"怎么把它改强"就不虚了。

🔨 改强它：加一个工具只要三步

工具系统是敞开的，加新工具就三步：

1. 建文件。在tools/下新建my_tool.py。基类契约在helpers/tool.py，写一个Tool的子类，核心是实现async def execute(...)，返回一个Response把结果交还给智能体。
2. 完事。动态发现机制会自动把它加载进来，不用改任何注册表。
3. 验证。在 Web 界面里让智能体调它，看返回内容是不是你想要的。

工具和扩展的边界新手容易混：工具是"多一个能力"，扩展是"改一个行为"。想在智能体的生命周期里插一手——比如每轮消息都注入当前时间、或者给系统提示词加一段固定内容——才轮得到扩展。扩展放在extensions/python/，按生命周期阶段分目录，文件名前缀数字决定执行顺序：system_prompt/里有_10_main_prompt.py负责组装主提示词，message_loop_prompts_after/里有_60_include_current_datetime.py注入时间、_70_include_agent_info.py注入智能体信息。

官方态度很明确：能做成插件就别写扩展。插件更好建、好测、好删；只有真要在某个生命周期点插手时才动扩展。

🧭 新手最常踩的四个坑，怎么绕

• 把工具当插件做。工具只是给智能体多一个能力；要改界面、加完整功能，正道是插件，仓库里plugins/下三十多个现成范例可以照着看。
• 一个工具塞太多事。一个工具只管一件事，以后好维护，智能体也选得准。
• 改了不测。改动前后各跑一遍同一个任务，拿输出对比。没有对比，就没有"改好了"这回事。
• 不写说明。项目里每个工具都配了同名.dox.md说明文件，照这个习惯来，下一个人（和三个月后的你）才看得懂。

接下来按这个顺序走：先把参数调顺、把场景跑通，再写第一个小插件，然后试扩展去改生命周期行为，最后把工具系统吃透。项目更新快，隔三差五回 docs/guides/ 翻翻新指南，你的 Agent Zero 会越用越顺手。

【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero