Project report / GitHub evidence

EvoAgentX: 自进化 AI Agent 生态系统的自动化构建框架

这是可索引项目报告证据页:它保留 EvoAgentX: 自进化 AI Agent 生态系统的自动化构建框架 的源材料入口、机制线索和限制提醒;正文仍需 reader/editor 与 academic public-copy review 后才能当作最终结论引用。

EvoAgentX: 自进化 AI Agent 生态系统的自动化构建框架

基本信息

字段内容
GitHubhttps://github.com/EvoAgentX/EvoAgentX
Star1k+
技术栈Python 3.11+, OpenAI API, LiteLLM, FAISS, Docker, MongoDB, PostgreSQL
许可证MIT
开发者EvoAgentX 团队(Yingxu Wang, Siwei Liu 等)
论文EvoAgentX: An Automated Framework for Evolving Agentic Workflows (arXiv 2025)

项目简介

EvoAgentX 是一个开源框架,旨在以自动化、模块化和目标驱动的方式构建、评估和进化基于 LLM 的 Agent 及 Agent 工作流。其核心理念是将 AI Agent 系统从静态的提示词链接或手动工作流编排,推进到自进化的 Agent 生态系统——Agent 可以被自动构建、评估和优化,如同软件的持续测试和改进。EvoAgentX 集成了多种前沿进化算法(TextGrad、MIPRO、AFlow、EvoPrompt),并支持工作流自动生成、内置评估、人机协作、长短期记忆等完整功能链。

目录结构

evoagentx/
├── evoagentx/                        # ★ 核心库
│   ├── models/                       # LLM 模型封装
│   │   ├── openai_model.py           # OpenAI 模型
│   │   ├── aliyun_model.py           # 通义千问模型
│   │   ├── litellm_model.py          # LiteLLM 统一接口
│   │   └── ...
│   ├── agents/                       # ★ Agent 管理
│   │   └── agent_manager.py          # Agent 管理器
│   ├── workflow/                     # ★ 工作流引擎
│   │   ├── workflow_generator.py     # 工作流自动生成
│   │   ├── workflow_graph.py         # 工作流图结构
│   │   └── workflow.py               # 工作流执行引擎
│   ├── optimization/                 # ★ 进化优化算法
│   │   ├── textgrad/                 # TextGrad 优化器
│   │   ├── mipro/                    # MIPRO 优化器
│   │   ├── aflow/                    # AFlow 优化器
│   │   └── evoprompt/                # EvoPrompt 优化器
│   ├── tools/                        # ★ 内置工具集
│   │   ├── interpreter_python.py     # Python 解释器
│   │   ├── interpreter_docker.py     # Docker 解释器
│   │   ├── search_wiki.py            # Wikipedia 搜索
│   │   ├── search_google.py          # Google 搜索
│   │   ├── browser_tool.py           # 浏览器自动化
│   │   ├── database_faiss.py         # FAISS 向量库
│   │   └── ...
│   ├── hitl/                         # 人机协作模块
│   │   ├── hitl_manager.py           # HITL 管理器
│   │   └── ...
│   └── memory/                       # 记忆模块
├── examples/                         # 示例代码
│   ├── optimization/                 # 优化示例
│   ├── workflow_demo.py              # 工作流演示
│   └── tools/                        # 工具使用示例
├── tests/                            # 测试
└── docs/                             # 文档与教程

核心模块分析

1. 工作流自动生成(workflow/)

EvoAgentX 可从自然语言目标自动构建多 Agent 工作流:

from evoagentx.workflow import WorkFlowGenerator, WorkFlowGraph, WorkFlow
from evoagentx.agents import AgentManager

goal = "Generate html code for the Tetris game"
workflow_graph = WorkFlowGenerator(llm=llm).generate_workflow(goal)
agent_manager = AgentManager()
agent_manager.add_agents_from_workflow(workflow_graph, llm_config=openai_config)
workflow = WorkFlow(graph=workflow_graph, agent_manager=agent_manager, llm=llm)
output = workflow.execute()

工作流图(WorkFlowGraph)支持可视化、序列化保存与加载,具备完整的 DAG 执行语义。

2. 进化优化算法(optimization/)

EvoAgentX 集成了四种先进的优化算法:

算法优化目标来源
TextGrad基于”梯度”的提示词与推理链优化Nature 2025
MIPRO黑盒评估驱动的自适应提示词优化arXiv 2024
AFlow蒙特卡洛树搜索驱动的工作流结构进化arXiv 2024
EvoPrompt反馈驱动的进化式提示词精炼arXiv 2023

在 HotPotQA、MBPP、MATH 三个基准上的评估结果:

方法HotPotQA (F1%)MBPP (Pass@1%)MATH (Solve%)
原始63.5869.0066.00
TextGrad71.0271.0076.00
AFlow65.0979.0071.00
MIPRO69.1668.0072.30

3. 内置工具生态(tools/)

提供六大类共 20+ 内置工具:

4. 人机协作(HITL)

支持在工作流关键节点插入人工审核:

from evoagentx.hitl import HITLManager, HITLInterceptorAgent
hitl_manager = HITLManager()
interceptor = HITLInterceptorAgent(
    target_agent_name="DataSendingAgent",
    interaction_type=HITLInteractionType.APPROVE_REJECT,
    mode=HITLMode.PRE_EXECUTION
)

5. GAIA 基准应用

将 EvoAgentX 应用于 GAIA 排行榜上的 Open Deep Research 和 OWL 系统,仅优化提示词即显著提升性能,展示了框架在真实多 Agent 系统上的实用价值。

技术亮点

  1. 端到端自动化:从自然语言目标到工作流自动构建、Agent 自动实例化、自动评估和自动优化的完整流水线
  2. 多算法融合:集成 TextGrad、MIPRO、AFlow、EvoPrompt 四种优化算法,覆盖从提示词级到工作流结构级的多层次优化
  3. 丰富的工具生态:20+ 内置工具覆盖代码执行、搜索、数据库、浏览器等场景,支持 MCP 协议扩展
  4. 人机协作框架:完整的 HITL 支持包括审批拦截、用户输入收集和字段映射
  5. 实际系统验证:在 GAIA 基准上的真实多 Agent 系统(Open Deep Research、OWL)优化中证明了实用价值

与 Self-Evolve 关联

维度EvoAgentX 贡献
自进化 Agent 系统EvoAgentX 构建了从工作流生成到进化优化的完整 Agent 自进化框架,是 Self-Evolve 理念的直接工程实现
多层次进化优化提供了提示词级(TextGrad/EvoPrompt)到结构级(AFlow)的多层次优化路径,为 Self-Evolve 系统的进化策略选择提供了参考
自动化评估闭环内置评估器和基准测试集成的设计,实现了”生成-评估-进化”的完整闭环
工具使用进化Agent 工具集的自动分配和优化,启发了 Self-Evolve 系统中工具使用策略的自我改进
自进化 Agent 综述配套发布的 Self-Evolving AI Agents 综述论文为领域提供了系统性知识梳理

参考资料