Readme i18n

frdel/agent-zero

Share
English(original)DeutschEspañolfrançais日本語한국어PortuguêsРусский中文
Last translated: 16 Jun 2025

Translation Not Available Yet

This repository's README hasn't been translated yet. Once translated, it will be easier to read and understand in your native language (中文).

After translating, add the links to README so others can view it directly.

Agent Zero

Agent Zero 官网 感谢赞助者 X平台关注 加入Discord YouTube订阅 LinkedIn联系 Warpcast关注

介绍 • 安装 • 黑客版 • 更新方法 • 文档 • 使用指南

📢 最新动态：Agent Zero 现已支持 MCP 服务器与客户端功能！ 📢

Agent Zero 现在可以作为 MCP 服务器供其他 LLM 工具使用，并能调用外部 MCP 服务器作为工具

功能演示

一个与您共同成长进化的个性化有机智能体框架

  • Agent Zero 不是预定义的智能体框架。它被设计为动态发展，随着使用过程有机成长和学习。
  • Agent Zero 完全透明、可读、可理解、可定制且支持交互。
  • Agent Zero 将计算机作为工具来完成其（您的）任务。

💡 核心特性

  1. 通用型助手
  • Agent Zero 不预编程特定功能（但可以定制）。它旨在成为通用型个人助手。给定任务后，它会收集信息、执行命令和代码、与其他智能体实例协作，并尽力完成任务。
  • 具备持久化记忆功能，可存储过往解决方案、代码、事实、指令等，以便未来更快速可靠地解决问题。

Agent 0 工作界面

  1. 以计算机为工具
  • Agent Zero 将操作系统作为任务执行工具。它没有预设单一功能工具，而是能自主编写代码并使用终端按需创建工具。
  • 默认工具仅包含在线搜索、记忆功能、通信（与用户及其他智能体）以及代码/终端执行。其他工具均由智能体自主创建或用户扩展。
  • 工具使用功能经过全新开发，确保最高兼容性和可靠性，即使使用小型模型也能稳定运行。
  • 默认工具：包含知识检索、网页内容抓取、代码执行和通信等功能。
  • 创建自定义工具：通过开发自定义工具扩展 Agent Zero 功能。
  • 仪器工具：新型工具类型，支持创建可被 Agent Zero 调用的自定义函数和流程。
  1. 多智能体协作
  • 每个智能体都有上级智能体分配任务和指令，并需向上级汇报。
  • 对于任务链首端的智能体（Agent 0），其上级就是人类用户，系统不做区分。
  • 每个智能体可创建下级智能体协助分解和解决子任务，保持各智能体上下文简洁专注。

多智能体协作 多智能体协作2

  1. 完全可定制扩展
  • 框架几乎没有任何硬编码内容，所有组件可见可改。
  • 完整行为由 prompts/default/agent.system.md 文件中的系统提示定义，修改提示可彻底改变框架行为。
  • 框架不强制引导或限制智能体，不存在必须遵循的硬性规则。
  • 所有提示模板和通信循环中的消息模板均存放在 prompts/ 文件夹，支持自由修改。
  • 所有默认工具源码位于 python/tools/ 文件夹，支持修改或复制创建新预设工具。

提示词管理

  1. 沟通至上
  • 通过恰当的系统提示和指令，智能体可创造奇迹。
  • 智能体能与上下级沟通，进行提问、指令下达和指导。通过系统提示教导智能体高效沟通。
  • 终端界面实时流式交互，随时可中断干预。发现智能体偏离方向时立即叫停纠正。
  • 框架赋予极大自由度：可指令智能体定期向上级请示、使用积分系统决定子任务委派时机、支持上级复核下级结果等，可能性无限。

🚀 应用场景示例

  • 开发项目 - "创建带实时数据可视化的 React 仪表盘"

  • 数据分析 - "分析英伟达上季度销售数据并生成趋势报告"

  • 内容创作 - "撰写关于微服务的技术博客"

  • 系统管理 - "搭建Web服务器监控系统"

  • 学术研究 - "收集并总结五篇关于思维链提示的近期AI论文"

黑客特别版

  • Agent Zero 提供基于 Kali linux 的黑客特别版，包含针对网络安全任务优化的提示词
  • 安装方式与常规版相同，只需使用 frdel/agent-zero-run:hacking 镜像替代 frdel/agent-zero-run

注意：黑客特别版及其所有提示词和功能将在下个版本合并至主分支

⚙️ 安装指南

点击观看安装教程视频：

简易安装指南

Windows、macOS 和 Linux 的详细安装指南（含视频）请查阅 安装文档。

⚡ 快速开始

# Pull and run with Docker

docker pull frdel/agent-zero-run
docker run -p 50001:80 frdel/agent-zero-run

# Visit http://localhost:50001 to start

🐳 全容器化部署，支持语音输入输出

设置界面

  • 可自定义设置允许用户根据需求调整智能体行为和响应方式
  • Web 界面输出清晰流畅、色彩丰富、可读性强且完全交互，所有信息透明可见
  • 支持在 Web 界面直接加载或保存对话记录
  • 终端输出内容会自动保存为 HTML 文件至 logs/ 文件夹

时间示例

  • 智能体输出实时流式传输，用户可随时阅读并介入
  • 无需编程技能，仅需掌握提示词编写和沟通技巧
  • 配合优质系统提示，框架即使使用小型模型也能可靠运行，包括精确的工具调用

👀 注意事项

  1. Agent Zero 可能存在风险！
  • 在正确指令下，Agent Zero 能执行涉及计算机、数据或账户的潜在危险操作。建议始终在隔离环境（如 Docker）中运行，并谨慎下达指令。
  1. 基于提示词驱动
  • 整个框架由 prompts/ 文件夹引导，包含智能体准则、工具说明、消息模板和实用AI函数等核心要素。

📚 文档目录

页面描述
安装指南安装与配置说明
使用指南基础与高级用法
架构设计系统设计与组件
贡献指南参与开发方式
故障排查常见问题解决方案

即将推出

  • MCP 协议
  • 知识与检索增强生成工具

🎯 版本日志

v0.8.5 - MCP 服务器+客户端

发布视频

  • 新增 MCP 服务器功能
  • 支持调用外部 MCP 服务器作为工具

v0.8.4.1 - 2

默认模型切换为 gpt-4.1

  • 代码执行工具优化
  • 浏览器代理改进
  • 记忆功能增强
  • 上下文管理相关错误修复
  • 消息格式化改进
  • 调度器优化
  • 新增模型供应商
  • 输入工具修复
  • 兼容性与稳定性提升

v0.8.4

发布视频

  • 远程访问（移动端支持）

v0.8.3.1

发布视频

  • 自动向量嵌入

v0.8.3

发布视频

  • 计划与调度功能

v0.8.2

发布视频

  • 终端多任务处理
  • 对话命名功能

v0.8.1

发布视频

  • 浏览器代理
  • 用户体验优化

v0.8

发布视频

  • Docker 运行时
  • 全新对话历史与摘要系统
  • 智能体行为变更与管理
  • 文本转语音(TTS)与语音转文本(STT)
  • Web UI 设置页面
  • SearXNG 替代 Perplexity + DuckDuckGo
  • 文件浏览器功能
  • KaTeX 数学公式可视化支持
  • 对话内文件附件功能

v0.7

发布视频

  • 自动记忆功能
  • 界面优化
  • 仪器工具
  • 扩展框架
  • 反思提示词
  • 错误修复

🤝 社区支持