企业官网建设流程全解析

Agent Zero 快速上手完全指南：5 分钟跑起来，再写出你的第一个扩展

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

想让 AI 不只是在对话框里回答你，而是真的动手——打开浏览器查资料、跑一段代码、把结果写进文件、还能调用别的 AI 一起干活？Agent Zero 就是为这类「要执行，不只是聊天」的任务设计的开源代理框架：它给代理配了一台带桌面和浏览器的 Linux 环境，并内置可插拔的工具与扩展机制。如果你刚接触 Agent Zero，或者想把日常任务交给它自动化，这篇指南带你在几分钟内从拉镜像到写扩展完整走一遍。

三步把 Agent Zero 跑起来

这一节帮你用最少的手动操作把一个能用的 Agent Zero 实例立起来，你几乎不需要改任何文件。

最省事的路径是走 Docker 镜像。打开 Docker Desktop，在搜索框输入agent-zero找到官方镜像，点击拉取并运行即可。

容器起来后，系统会直接在你的浏览器里打开 Web UI。你不需要写配置、不需要装依赖，端口和目录都帮你处理好了。如果你更习惯在终端操作，也可以直接把仓库克隆到本地跑源码：

git clone https://gitcode.com/GitHub_Trending/ag/agent-zero

整个过程中你唯一要做的事，就是进界面后给它接一个能用的大模型。到这一步，你就有一个可以下任务的 Agent Zero 了。

第一次使用：认识界面，先干一件真事

这一节帮你从「装好了」过渡到「用起来」，让你亲眼看到它干活的樣子，而不是停在概念上。

进入 Web UI 后，先接上模型：选择云 API、AI 账号或本地模型三种方式之一，再分别指定一个主力模型和一个负责内部小活的轻量模型。

接好之后点「新建聊天」，别客气，直接给它派一件具体的事。比如：

用浏览器调研一下某类工具的三个候选方案，把优缺点整理给我。

看着它调工具、抓网页、汇总成一段可读的结论，你会比读十遍文档更快建立体感。这个环节的目的就是让你确认「它能真的动手」，之后再谈扩展才不飘。

内置能力按任务场景分四类

这一节帮你在动手前心里有张地图：什么活该交给哪类内置工具，而不是逐个文件背名字。

• 执行与自动化：需要跑代码、操作文件、驱动它内置的 Linux 桌面或浏览器时，交给执行类工具。典型场景是批量处理文件、打开一个 GUI 程序、在网页上做标注式修改。
• 信息检索：要拿实时信息时用检索类工具，它封装了多种搜索引擎，适合「去查一下」这类需要现网数据的任务。
• 记忆与状态：要跨对话记住事情、或在长任务里保存中间结果时，用记忆相关的保存与加载能力，避免每次从零开始。
• 多代理协作：任务能拆开时，用子代理调用把研究、编码、评审派给专注的子代理，主代理只做调度。

这些工具的源码集中在 tools/ 目录，想深挖时直接进去看即可，日常使用你只需知道「哪类活找哪组工具」就够了。

从使用者到开发者：三步写出一个扩展

这一节把你从「用别人写的功能」推进到「自己加功能」，只讲组织约定，不逐个文件展开。

Agent Zero 的扩展机制很轻：你不需要注册表，也不需要改主程序，放对位置就会被自动发现。整个过程三步。

1. 放一个文件：在对应的扩展目录里新建一个 Python 文件。扩展点就是目录名——比如在系统提示词环节动手，就放进system_prompt/；想在消息循环后补一段信息，就放进message_loop_prompts_after/。带数字前缀的文件名决定执行顺序，按需命名即可。
2. 等它被发现：框架会动态扫描这些目录，你放好文件、重启实例，扩展就会按顺序生效，没有任何手动登记步骤。
3. 在界面里验证：回到 Web UI 发起一次真实对话，确认你的扩展行为符合预期，再决定要不要调整命名顺序或逻辑。

后端生命周期扩展都在 extensions/python/ 下，每个目录对应一个可复用的挂载点，照着现有文件的结构写，基本不会跑偏。

只调这几个配置项就够

这一节帮你从满屏的设置里挑出真正影响行为的少数几项，其余的先别碰。

• 代理与模型：决定用哪个模型、主力与轻量模型怎么分工。它影响每一轮回答的质量和速度，是回报最高的一项。
• 工具行为：控制各工具的启用与输出方式。它影响代理能干什么、结果多啰嗦，调它就是在调「能干多少活、说多少话」。
• 项目隔离：决定文件、密钥、记忆是否按项目隔开。做多个项目时，它是避免上下文串味的关键开关。

设置页里其余选项大多是给进阶用户留的，第一次用先聚焦上面三项，后面按需再回来。

落到你的场景，并避开常见坑

这一节把「能用来干嘛」和「容易踩哪」合到一起，让你直接照自己的情况对号入座，少走弯路。

• 如果你要批量处理文件或抓取数据，可以把任务直接甩给执行类工具，让它循环跑完并把结果落盘，你只验收。
• 如果你要做一个能长期记住上下文的助手，就打开记忆能力，并把重要偏好写进代理信息，省得每次重述。
• 如果你要把一个复杂任务拆成研究加实现，用子代理调用把两块活分给不同代理，主代理收尾。

几条可直接执行的建议：先从一个最小工具起步，跑通了再加复杂度；给每个扩展文件配一句说明，方便以后回看；动手前确认你要的操作是否在允许范围内，别让工具替你做破坏性的删除或网络动作。更多边界和取舍，官方文档 里有更细的说明。

现在就可以开始

打开 Docker Desktop，搜到agent-zero镜像，点拉取、点运行，然后进界面接上模型，派给它第一件真事。想继续跟进项目动态、看新加的扩展点或读更深的原理，直接翻 docs/ 目录下的指南，那里按上手顺序整理好了下一步该看什么。

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