企业官网建设流程全解析

Agent Zero 快速上手指南：Docker 五步跑通第一个任务

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

想让 AI 自己查资料、跑代码、还记得住上次聊到哪？以前你得自己拼模型接口、写编排脚本、再盯着环境；现在 Agent Zero 这个开源 AI 智能体框架把联网搜索、浏览器、代码执行、记忆、子代理都做成了现成工具，整套东西装在一个 Docker 容器里就能转起来。本文带你从零安装到跑通一个真实任务，并知道下一步该怎么改它。

Docker 五步启动 Agent Zero

Agent Zero 阻力最小的路径是直接用 Docker 跑：

Docker Desktop 中搜索 agent0ai/agent-zero 镜像并拉取

1. 安装并启动 Docker Desktop。
2. 在搜索框找到 agent0ai/agent-zero，点 Pull 拉取镜像。
3. 给镜像点 Run，把一个空闲的主机端口映射到容器端口 80。
4. 点容器下方的端口链接，浏览器打开欢迎页。
5. 填入模型提供商和 API Key，点 Save。

端口 80 被占用了？换成命令行直接跑：

docker run -p 5080:80 -v a0_usr:/a0/usr agent0ai/agent-zero

然后打开 http://localhost:5080。

可验证的成功标志：Containers 列表里容器处于运行状态，浏览器里出现带 New Chat 按钮的仪表盘，你输入第一句话就能开始对话。

容器启动后，Agent Zero 主界面即可开始聊天和配置

第一个任务怎么布置

挑一个最典型的研究任务，在聊天框里只说一句话：

Use the Browser to research three options for this tool and summarize the tradeoffs.

接着你看着它干活：先用内置搜索工具捞回候选名单，再用浏览器工具逐个打开页面、读内容、截图；需要计算时调起代码执行；干完把结论写进记忆。你拿到的是聊天区里的三选项对比总结，想要文件形式，可以直接让它写进 Canvas 文档里。

布置第一个任务后，聊天流里能看到它的每一步工具调用

它有哪些能力、怎么用一句话唤起

tools/目录里的工具由框架自动发现，文件在就有能力，不用注册。

工具和插件的文件放哪、怎么命名

两条路，去处不同。

工具：目标是“给智能体加一个新动作”。文件放进tools/，命名my_tool.py，写一个继承 Tool 的子类（基类契约在helpers/tool.py），核心是实现async def execute(...)并返回 Response；旁边再放一份同名的my_tool.py.dox.md说明。框架会自动发现，不用改任何注册表。

插件：目标是“改变已有行为或加界面功能”。本地插件放在/a0/usr/plugins/<plugin_name>/，入口文件是plugin.yaml。

扩展（extensions/python/）：只在需要在某个生命周期点插手时用，文件名开头的数字决定执行顺序。

判断规则一句话：能用“给智能体加个新动作”说清目标的，写工具；要“改现有流程或界面怎么表现”的，写插件；前两者都不够才上扩展。细则见 docs/developer/extensions.md。

设置面板先动哪四个参数

按这个顺序动，每改一次都用同一个任务跑前后对比：

1. 聊天模型（chat_llm）：所有工具的输出质量都压在它身上，地基要先定。
2. 工具模型（utility_llm）：负责摘要和记忆提取，模型太小时记忆会不准。
3. Agent 配置（profile）：模型定好，再决定它是什么性格、行为边界在哪。
4. 工具参数：单个工具的开关与输出详略，改动小见效快，放最后调。

设置页：模型、Agent 配置、工具参数都在这里调

四个常见错误与一个下一步

• 挂载整个 /a0 目录→ 里面含应用代码，升级容易坏 → 只挂/a0/usr数据目录。
• 本地模型服务地址写成 localhost→ 容器里 localhost 指向容器自己，连不到宿主机服务 → 换成http://host.docker.internal:<端口>。
• 模型名按一套格式乱写→ 各提供商命名规则不同，会报 Invalid model ID → OpenRouter 要带提供商前缀，以提供商文档为准。
• 把界面改动写成工具→ 工具只加新能力，不改现有流程 → 走插件。

下一步就做一件事：开一个新聊天，把上面那个浏览器研究任务丢给它，亲眼看它调用了哪些工具。

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