SuperAgentX 工作流框架
用可审批、可审计的多智能体工作流，把目标转化为浏览器、API 和数据库操作。
- Star 数
- ★ 203
- 最近更新
- 28 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 37/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要把多个处理步骤串联起来的 Python 团队，可用
AgentXPipe编排顺序或并行的智能体任务。 - 不适合
- 需要开箱即用的托管服务、无需编写代码的团队
- 不愿自行配置模型和数据存储的用户
这个 Agent 能做什么，适合哪些场景？
SuperAgentX 是一个面向 Python 的模块化智能体框架，支持智能体规划目标、调用工具并执行多步工作流。开发者可通过 `Agent`、`AgentXPipe`、`BrowserEngine`、`LLMClient` 和 `PromptTemplate` 组合智能体；工作流可按顺序、并行或混合方式运行，并支持重试。敏感操作可以通过 `human_approval=True` 暂停，等待明确批准后再继续或中止。项目说明支持 OpenAI、Azure OpenAI、Gemini、Claude、Bedrock 及开源模型，并列出 SQLite 和 PostgreSQL 作为持久化数据存储。它以 Python 包形式安装并嵌入用户自己的代码，README 还提到 WebSocket、REST API 和 IO console 接口；没有说明由项目提供托管运行环境。
Agent 接收 query_instruction，根据配置的目标、提示词和 LLMClient 规划步骤并调用可配置的工具或引擎。AgentXPipe 可串联多个智能体，示例中先生成食品购物结算摘要，再由 BrowserEngine 打开支付演示页面、审阅金额并填写测试卡信息；设置 human_approval=True 后，执行会在审批点暂停。执行结果可包含智能体名称、ID、目标是否完成及结果；持久化存储可记录工作流状态、决策、审批、工具输出、审计日志和上下文快照。浏览器自动化示例要求额外安装 Playwright。
- 需要把多个处理步骤串联起来的 Python 团队，可用
AgentXPipe编排顺序或并行的智能体任务。 - 需要在支付等敏感浏览器操作前人工复核的团队，可在
Agent上启用human_approval。 - 需要让智能体查询网页的开发者，可用
BrowserEngine和 Playwright 运行浏览器自动化。 - 需要将智能体连接到 API、数据库或其他处理器的团队，可通过可扩展的 handlers 接入这些工具。
- 需要保存工作流状态和审批记录的团队，可选择 SQLite 或 PostgreSQL 作为持久化存储。
如何安装或部署这个 Agent？
需要 Python 3.12 或更高版本。安装包的快速开始命令如下；浏览器自动化还需安装 Playwright 并运行浏览器安装命令。README 没有列出模型凭据配置细节，使用云模型时需按所选提供方配置模型访问。
如何使用这个 Agent？
下面是 README 中的 API 使用模式，展示如何创建模型客户端和智能体并执行任务。模型名称和 llm_type 示例来自 README；示例没有提供凭据设置步骤。
这个 Agent 有哪些优点和局限？
- 内置人工审批点，可在敏感操作前暂停，并记录审批决策以供审计。
- 支持顺序、并行或混合的多智能体工作流，并提供重试、反思和恢复能力。
- 支持多家模型提供方，并列出 100 多种 LLM 及 10,000 多个 MCP 工具。
- SQLite 和 PostgreSQL 可用于保存工作流状态、工具输出、审计日志和上下文快照。
- 提供基于 Playwright 的浏览器引擎示例，可将智能体接入真实浏览器自动化。
- 需要 Python 3.12+；浏览器自动化还需单独安装 Playwright 和浏览器。
- README 未说明模型凭据的配置步骤，首次接入模型需要自行确定提供方设置。
- README 提及 REST、WebSocket 和 IO console 接口，但没有给出部署命令或完整配置示例。
- 持久化能力依赖 SQLite 或 PostgreSQL；README 未说明向量数据库的具体实现或配置方式。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| SuperAgentX 工作流框架 当前 | 37 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 203 | 28 天前 | Python | OpenAI API |
| Eko Agentic Workflow | 43 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 5k | 7 个月前 | TypeScript | OpenAI API · Claude API |
| Safari MCP | 78 · 表现良好 | MCP 服务器免费 | ★ 217 | 今天 | JavaScript | Claude Code · Claude.ai |
| Nuphus 桌面自动化 MCP | 72 · 存在缺口 | MCP 服务器免费 + 模型费 | ★ 325 | 今天 | Rust | Claude.ai · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 声称有人工审批，并展示付款前审批、可恢复或中止；但未提供强制审批覆盖范围或绕过防护的实现证据，因此仅给部分分。示例还明确让浏览器代理提交付款表单，且工作流会持久化状态、工具输出和审计日志；虽提示不持久化卡数据，却没有展示权限控制、数据流细节、回滚机制或来源归属政策。依赖清单列出大量依赖，但没有安全审查或缓解证据。
README 描述顺序、并行工作流、重试和状态持久化，pyproject.toml 给出依赖与 Python 版本要求；这些只提供有限支持。示例中的模型配置和广泛能力主张没有与其他材料相互验证，也没有展示失败信息或错误处理约定。
README 面向多步骤工作流、浏览器自动化、MCP、数据库及多种模型，提供了食品结账和信息检索等场景。边界和适用条件说明较少；环境要求限定 Python 3.12–3.14，并单独说明 Playwright 安装，未解释部署环境、能力限制或何时触发审批。
README 有功能、快速开始、示例、安装和许可证等分区，pyproject.toml 提供包名、版本、入口点和项目链接。未见 FAQ、已知限制或变更日志；命名在 SuperAgentX、superagentX 与 superagentx 之间变化。许可证文本完整且与元数据一致。维护者和联系邮箱已列出，但无法从所给材料确认其责任或更新路径。
框架提供可组合代理、工作流、浏览器操作、持久化和人工审批，示例展示结构化结果与一个审批关口，体现了实用价值。完整依赖和外部模型、浏览器服务可能增加安装与运行成本；材料没有成本估算、输出质量指标或生产部署权衡，因此未给高分。
README 对功能、模型数量和治理能力作出具体主张，但所给材料主要是 README 与打包配置，缺少代码或测试材料来逐项追溯。许可证声明可由 LICENSE 和 pyproject.toml 相互印证，其他关键能力缺少交叉佐证。说明性主张与事实有一定区分，但未系统标注哪些能力已验证。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 示例会提交付款表单；即使提示使用虚拟卡，也应在隔离环境中审查审批关口和浏览器操作，并确认实际数据保留与日志行为。
- README 的模型数量、MCP 工具数量及企业治理能力主张未由所给材料充分佐证；部署前应核实所需依赖、外部服务和运行成本。
常见问题
使用 SuperAgentX 要支付软件费用吗？
pip install superagentx 安装方式。README 没有说明模型服务价格；使用收费模型或 API 时，费用取决于相应提供方。哪些操作需要人工批准？
human_approval=True，让执行在敏感操作前暂停并请求明确批准。具体哪些操作触发审批由应用的工作流和配置决定。工作流失败时会怎样？
max_retry。它没有说明所有失败情形的处理保证或具体错误恢复策略。能否用于浏览器自动化？
BrowserEngine 示例，并要求安装 Playwright 及其浏览器；示例包含人工审批配置。