Agent Zero 快速上手指南Docker 五步跑通第一个任务【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero想让 AI 自己查资料、跑代码、还记得住上次聊到哪以前你得自己拼模型接口、写编排脚本、再盯着环境现在 Agent Zero 这个开源 AI 智能体框架把联网搜索、浏览器、代码执行、记忆、子代理都做成了现成工具整套东西装在一个 Docker 容器里就能转起来。本文带你从零安装到跑通一个真实任务并知道下一步该怎么改它。Docker 五步启动 Agent ZeroAgent Zero 阻力最小的路径是直接用 Docker 跑Docker Desktop 中搜索 agent0ai/agent-zero 镜像并拉取安装并启动 Docker Desktop。在搜索框找到 agent0ai/agent-zero点 Pull 拉取镜像。给镜像点 Run把一个空闲的主机端口映射到容器端口 80。点容器下方的端口链接浏览器打开欢迎页。填入模型提供商和 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/search_engine.py自动调用“帮我搜一下 XX 的最新消息”页面操作_browser插件的浏览器工具“用 Browser 打开这个页面并截图”代码执行_code_execution插件“跑一下这段 Python 代码把结果给我”文档检索tools/document_query.py“查这份手册里部署那部分讲了什么”图像理解tools/vision_load.py“我贴的这张图里写了什么”定时任务tools/scheduler.py“每天 9 点跑一次这个检查”多代理协作tools/call_subordinate.py、tools/a2a_chat.py“把研究拆给两个子代理并行做”工具和插件的文件放哪、怎么命名两条路去处不同。工具目标是“给智能体加一个新动作”。文件放进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。设置面板先动哪四个参数按这个顺序动每改一次都用同一个任务跑前后对比聊天模型chat_llm所有工具的输出质量都压在它身上地基要先定。工具模型utility_llm负责摘要和记忆提取模型太小时记忆会不准。Agent 配置profile模型定好再决定它是什么性格、行为边界在哪。工具参数单个工具的开关与输出详略改动小见效快放最后调。设置页模型、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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考