Agent Zero 完全上手指南：三步跑起一台带真 Linux 电脑的 Agent
【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero
Agent Zero 是一个开源智能体框架，把一整套 Linux 桌面装进 Docker 容器：Agent 能浏览网页、编辑办公文档、调度子代理，专管"纯聊天 AI"做不了的活。新手 3 步就能打开 Web UI，派下第一个实际任务。
🎯 它解决什么问题：不是"会聊天"，而是"会操作"
和普通聊天机器人的差别：这里的 Agent 有一台真正能上手的电脑。三个场景最直观：
- 驱动 Linux 桌面：右侧 Canvas 里是一整块 XFCE 桌面会话，Agent 可以开 Blender、终端、文件管理器；你的鼠标键盘和它共用同一块屏幕，随时能接管干预。
- 批注网页：内置浏览器里点击任意元素即可修改、检查或留评论，Agent 会照着批注把界面改动做出来。
- 协同办公文档：Markdown 编辑器和 LibreOffice Writer/Calc/Impress 里，Agent 和你同时打字，产出是真实文件，而不是一长串聊天记录。
Agent Zero 聊天界面：流式回复与工具调用过程全程可见
🚀 最快跑起来：一条命令部署 Agent Zero 容器
装好 Docker 之后，从 0 到第一次聊天只需要 3 步。
- 确认 Docker Desktop（或 Docker 服务）已启动。
- 在终端执行这一条命令：
docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero。其中-v a0_usr:/a0/usr用命名卷保存 Agent 工作区，容器删了数据也不丢。 - 浏览器打开
http://localhost，在引导页填入模型提供方（API Key 或账号登录），发起第一次对话。
Agent Zero 启动后的 Web UI 首屏：聊天区与右侧 Canvas 工作区
🗺️ 核心模块地图：工具、提示词、插件都在哪
所有核心能力都放在开放的目录里，"相对路径 → 作用"对照如下：
| 路径 | 作用 |
|---|---|
tools/ | 内置工具实现：search_engine.py联网搜索、call_subordinate.py子代理调度、a2a_chat.py多 Agent 对话、scheduler.py定时任务 |
extensions/ | 扩展挂钩目录：python/放后端生命周期钩子，webui/放前端扩展；子目录名即挂钩点，文件数字前缀决定执行顺序 |
plugins/ | 内置插件：_browser浏览器、_memory记忆、_code_execution代码执行等，UI 里的 Plugin Hub 还能装社区插件 |
prompts/ | 全部系统提示词模板，可读可改 |
agents/ | 内置 Agent Profile（工作风格）：developer、researcher、hacker 等 |
conf/model_providers.yaml | 模型提供方定义 |
🔧 二次开发：加一个自己的扩展
跑通基础后，可以先做最轻的自定义——后端钩子扩展，4 步完成：
- 建文件：选一个挂钩点子目录，例如
extensions/python/message_loop_prompts_after/（每轮调用模型前向提示词注入内容的阶段），新建_90_my_extension.py。 - 实现约定接口：继承
Extension，写一个异步execute方法，改传入的loop_data。 - 被系统自动发现：按目录扫描加载，无需手动注册，数字前缀决定执行先后。
- 在界面验证：重启实例，在 Web UI 发起新对话，确认效果已进入系统提示词。
接口形态示意：
class MyExt(Extension): async def execute(self, loop_data, **kwargs): loop_data.extras_temporary["my_note"] = "hello"纯界面改动也可以换个更轻的入口：在plugins/下放一个小插件（带plugin.yaml名称标签），同样会被自动加载。
⚙️ 配置调优与避坑：新手常踩的 3 个坑
- 80 端口被占用：把端口映射改成
5080:80，改用http://localhost:5080访问即可，不用动镜像。 - Agent 找不到你的文件：它默认只在容器里活动；要操作本机文件，在宿主机装 A0 CLI Connector，用
a0连上实例，这是官方给的主机桥。 - 别把整个家目录挂进容器：Agent 在容器里权限很高，只挂需要它干活的工作区；密钥放进项目 secrets，不要写进提示词。
关键配置都在设置界面：模型预设（给模型组合起名字，按名切换）、Agent Profile（切换工作风格）、Projects（按项目隔离记忆、密钥与文件）、MCP（接入外部工具）。
先跑通"网页批注"场景：用内置浏览器打开一个模板站，点中喜欢的元素，让 Agent 按你的技术栈重做一遍。这一步能同时把浏览器、工具调用与文档产出三块主能力摸一遍。
【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
