ReadyAgents Core — 本地 YAML 工作流 Agent 引擎

技能简介

ReadyAgents 是一个完全本地运行的 AI Agent 工作流引擎，通过 YAML 或 JSON 定义多节点工作流，支持检查点 checkpoint、暂停审批、离线回放和 MCP 工具集成。所有密钥和账单由用户自持，无需云端守护进程。本次扫描到最新版本 2.0.9，支持 Python 3.11~3.14。

核心能力

1. YAML/JSON 工作流定义：通过声明式 YAML 或 JSON 编写 Agent 节点、工具节点、条件节点、转换节点、审批节点、并行节点等八种类型的工作流
2. 检查点持久化与恢复：每节点执行后自动保存状态，失败或暂停的工作流可从最后一个成功节点恢复，无需重新开始
3. HITL 人工审批节点：在关键节点插入人工审批步骤，Agent 运行到此处自动暂停，等待人工确认后再继续
4. 内置零配置工具集：提供 now、calc、json_get、list_dir、read_file、write_file 等常用工具，无需额外部署服务器
5. MCP 客户端/服务端：内置 MCP 协议实现，通过 readyagents mcp serve 启动 MCP 服务端，或通过 readyagents mcp probe 检测 MCP 工具
6. 本地回放与回归测试：可对历史运行记录进行 replay/fork/diff/freeze/report，本地 HTML 报告便于复盘
7. 多模板脚手架：内置 basic、approval、research、pipeline、review、foreach、agent-tools、gated 等启动模板
8. BYOK 密钥自持：支持 OpenAI、Anthropic 及各类 OpenAI 兼容端点，密钥完全由用户管理
9. 策略与用量管控：支持按节点设置 Token/费用上限，提供 --estimate 和 --max-spend 熔断机制
10. 40+ 插件生态：Teams、Studio、Browser、Knowledge、Distillation、Registry 等插件开箱即用

安装配置

环境要求：Python 3.11~3.14，Linux/macOS/Windows 均可

方式一：pip 安装（推荐）

pip install readyagentsdev

方式二：从源码克隆

git clone https://github.com/readyagentsdev/readyagents-core.git
cd readyagents-core
python -m venv .venv
source .venv/bin/activate
pip install -e .

初始化项目

readyagents init
readyagents new my-flow

使用步骤

第一步：创建新工作流

readyagents new my-flow --template basic
cd my-flow

第二步：编辑工作流 YAML 文件 在 workflow.yaml 中定义节点：

nodes:
  - id: start
    type: agent
    model: claude-sonnet-4
    prompt: "请搜索 X 主题的相关文章"
  - id: parse
    type: transform
    tool: read_file
    file: "{{start.output}}"

第三步：试运行评估（不实际消耗）

readyagents run my-flow/workflow.yaml --estimate

第四步：执行并设置费用上限

readyagents run my-flow/workflow.yaml --max-spend 0.5

第五步：查看运行历史并回放

readyagents runs list
readyagents runs show 
readyagents runs replay 

适用场景

1. 需要人工审核的内容生成流水线：内容 Agent 在发布前插入审批节点，确保输出质量
2. 多步骤研究工作流：网络搜索 → 信息提取 → 去重整理 → 报告生成，每步自动 checkpoint
3. 自动化测试与回归：将成功的运行 freeze 为基准，新代码变更后 replay 对比差异
4. 企业内部工具链集成：通过 MCP 接入现有内部 API，无需将密钥交给第三方服务
5. 敏感数据处理：所有 LLM 调用在本地执行，数据不出内网
6. 预算敏感场景：通过 --max-spend 严格控制每次运行的 Token 消耗上限
7. 离线/内网部署：无需连接外部服务即可运行完整的 Agent 工作流

适用人群

• 后端开发者：需要编排复杂多步骤自动化流程的工程师
• AI 应用架构师：设计 Agent 工作流并需要人工干预节点的产品负责人
• 数据工程师：需要本地 LLM 管道、避免数据外传的隐私敏感场景
• DevOps/平台工程师：为团队搭建内部 Agent 运行平台
• 独立开发者：不想依赖第三方 Agent 平台，希望完全自主控制密钥和成本

工作原理

ReadyAgents Core 由以下组件构成：

• 工作流引擎（Engine）：解析 YAML/JSON 定义，按拓扑顺序执行节点，维护全局状态
• 工具层（Tools）：内置工具通过沙箱执行；MCP 工具通过 MCP 客户端调用外部服务
• LLM 层（LLM）：BYOK 模式，用户提供 API Key，支持 OpenAI/Anthropic/OpenAI兼容三种provider
• 检查点层（Persistence）：每节点执行完成后将状态快照写入本地文件系统，支持断点恢复
• 策略层（Policy）：按节点配置 Token 上限和费用上限，estimate 模式预览消耗

官方链接

• PyPI 主页：https://pypi.org/project/readyagentsdev/
• GitHub 仓库：https://github.com/readyagentsdev/readyagents-core
• 官方文档：https://docs.readyagents.dev/