Agent Zero 完全上手指南三步跑起一台带真 Linux 电脑的 Agent【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zeroAgent 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），仅供参考
