ProAgent 流程自动化
将自然语言需求转成 n8n 工作流，并协调专用代理执行流程决策。
- Star 数
- ★ 864
- 最近更新
- 2 年前
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 45/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用OpenAI API（部分支持）
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 高 · 需要较重的基础设施
- 开始前需要
- 典型场景
- 已部署自托管 n8n 的运营团队，希望把自然语言描述的跨应用流程构建为工作流。
- 不适合
- 只想开箱即用、不愿自行搭建 n8n 与注册第三方应用的用户
- 依赖最新 n8n 或最新 OpenAI 接口的团队，编译器与接口版本偏旧
这个 Agent 能做什么，适合哪些场景？
ProAgent 是 Agentic Process Automation（APA）论文的官方代码，用于把人类指令转化为自动化工作流。它围绕自托管 n8n 运行，并要求将 n8n 导出的工作流与凭据文件提供给代码库。运行模式由 ProAgent/config.py 配置：development 用于论文中的构建流程，refine 基于已有工作流继续修改，production 则加载既有运行以复现结果。每次运行会在 ./records 生成可读记录，后续可被 refine 或 production 模式加载。开发模式需要 OpenAI API 配置；仓库说明其实现基于 GPT4-0613 和较早版本的 OpenAI 接口。
用户通过 ProAgent/config.py 选择运行环境后执行 python main.py。在 development 模式中，ProAgent 根据人类指令构建工作流，协调专用代理处理复杂决策，并可通过函数调用向人寻求帮助；该模式需要先启动 n8n。代码会读取由 n8n export:credentials 和 n8n export:workflow 导出的 c.json 与 w.json，并把运行记录写入 ./records。refine 模式从已有工作流加载后按新请求改进，并启用 test-on-change；production 模式加载已有运行来复现案例，APA-code 只在运行结束时测试一次。
- 已部署自托管 n8n 的运营团队，希望把自然语言描述的跨应用流程构建为工作流。
- 需要复现论文案例的研究人员，可使用 ./apa_case 和 production 模式加载已有运行。
- 已有 n8n 工作流但收到新需求的自动化维护者，可用 refine 模式继续调整流程。
- 希望在人机协作下构建并测试工作流的团队，可利用 ProAgent 的主动求助函数调用。
- 已在 n8n 中注册应用和凭据的开发者，需要让代码读取工作流 ID 与凭据 ID 来执行流程。
如何安装或部署这个 Agent？
安装 Python 依赖：
pip install -r requirements.txt如需连接真实应用服务，安装并运行自托管 n8n：
npm install n8n -g
export WEBHOOK_URL=https://n8n.x-agent.net/redirect/http%3A%2F%2Flocalhost%3A5678/
n8n在 n8n 中连接或注册应用后，导出凭据和工作流：
n8n export:credentials --all --decrypted --output=./ProAgent/n8n_tester/credentials/c.json
n8n export:workflow --all --output=./ProAgent/n8n_tester/credentials/w.jsondevelopment 模式还需设置 OPENAI_API_KEY 与 OPENAI_API_BASE。
如何使用这个 Agent？
在 ProAgent/config.py 选择 development、refine 或 production。development 模式先启动 n8n，并设置 OPENAI_API_KEY 和 OPENAI_API_BASE；随后运行：
python main.py若要复现已保存的案例，可使用 production 模式加载 ./apa_case 或 ./records 中的已有运行，无需为该复现路径准备 n8n。refine 模式加载已有工作流后，根据新的请求改进它。
这个 Agent 有哪些优点和局限？
- 将工作流构建与执行决策放在同一 APA 流程中，而非仅执行预先手写的 RPA 步骤。
- 提供 development、refine、production 三种明确模式，分别覆盖构建、迭代修改和已有运行复现。
- 运行记录保存在 ./records，可作为 refine 或 production 的可加载输入。
- 支持通过新的函数调用主动向人寻求帮助，以处理对需求理解不充分的情况。
- 核心实现依赖 OpenAI 配置，并明确基于 GPT4-0613 与较早版本的 OpenAI 接口；新版兼容性存在风险。
- 连接真实应用需要自托管 n8n、预先注册应用，并导出解密后的凭据和工作流。
- 仓库明确提示 n8n 编译器基于较旧的 n8n，可能与较新版本不兼容。
- 自托管 n8n 的安装和第三方账户连接可能遇到未覆盖的问题；在中国还可能受网络连接限制。
这个 Agent 与同类方案有什么区别？
相较于传统 RPA，ProAgent 面向需要人类式智能的工作流设计和动态执行决策。它不只是按固定步骤运行自动化，而是尝试从人类指令构建工作流，并由专用代理协调决策。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| ProAgent 流程自动化 当前 | 45 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 864 | 2 年前 | Python | — |
| superglue 企业系统集成智能体 | 45 · 缺口较多 | 云服务 / SaaS免费版 + 付费版 | ★ 2.1k | 12 天前 | TypeScript | OpenAI API · Claude API |
| OpenClaw 汉化发行版 | 53 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.8k | 今天 | JavaScript | OpenAI API · Claude API |
| LocalAI —— 开源 AI 引擎 | 52 · 缺口较多 | 自托管服务免费 | ★ 50k | 今天 | Go | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README说明可连接自托管 n8n 与真实应用，main.py 的示例要求读取 Google Sheets 并向 Slack 或邮件发送利润信息，显示外部权限和副作用范围较广；材料未见最小权限配置或敏感数据保护说明，因此相关分数较低。README介绍让 ProAgent 与人协作、通过新函数调用请求帮助，但没有明确的执行前确认或撤销机制；记录功能提供有限恢复线索。README指向论文和引用条目，支持来源归属，但发布者身份仍未知。
依赖有固定版本，README说明需使用旧版 OpenAI API，并提示 n8n 编译器可能不兼容新版 n8n、重定向服务可能不稳定，体现部分自我一致性和依赖风险披露。材料没有具体故障处理或错误消息策略，故失败信息仅得部分分。
README描述 development、refine、production 三种模式，给出论文复现和既有工作流优化等场景；代码示例也列出具体业务流程。它提示旧版 n8n 兼容边界并说明生产模式的测试时机，但触发条件主要限于手动触发示例，环境适配仍依赖用户自行配置 n8n、账户和 API 凭据。
README按安装、n8n准备、运行模式和引用组织，包含命令、凭据导出步骤和复现案例，且明确披露部分兼容性与服务稳定性限制。LICENSE完整提供 Apache-2.0 文本。命名和配置说明存在拼写、表述不一致；版本变更信息有限，维护责任与更新渠道未明确，因此这些项目未获满分。
产品目标清晰地把自然语言需求转为工作流，并协调专门代理；示例把表格计算、业务分类和通知串联起来，可能减少手工流程构建工作。材料提供记录和工作流复用方式，但需要 n8n、外部账户、API 密钥及环境维护，成本收益只得到部分支持。
README将项目主张关联到论文，并列出复现模式、案例目录和主要配置位置；main.py 展示具体工作流任务，与产品描述有部分呼应。但本次仅有 README、入口代码、依赖清单和许可证，缺少论文内容、实现细节或多份独立材料来核对主要能力；描述性主张与已展示事实的边界也不总是明确。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 示例流程会读取业务成本与销售数据并向 Slack 或邮件发送结果；部署前应核对 n8n 凭据范围、接收对象及数据处理方式。
- README要求导出解密后的全部 n8n 凭据到文件；该文件可能包含敏感信息，材料未说明加密、访问控制或安全删除措施。
- README称重定向服务可能不稳定，且编译器可能不兼容新版 n8n；其明确建议需自行处理环境问题。
你是这个项目的维护者？把 FARS 徽章加到 README
[](https://followagents.com/zh/agents/proagent)<a href="https://followagents.com/zh/agents/proagent"><img src="https://followagents.com/badge/proagent.svg?lang=zh" alt="FARS 评测"></a>常见问题
是否必须使用 OpenAI？
OPENAI_API_KEY 和 OPENAI_API_BASE。仓库说明其基础模型为 GPT4-0613，且使用较早版本的 OpenAI 接口；未说明其他模型提供商支持。一定要部署 n8n 吗？
它如何取得第三方应用访问权限？
./ProAgent/n8n_tester/credentials/c.json，并导出工作流到相应的 w.json 文件。新版 n8n 能直接使用吗？
谢谢反馈，我们会据此改进页面。