ActiveHarness:Ruby LLM 流程框架
为 Ruby 应用编排可追踪、可控成本并具备故障恢复能力的 LLM 请求流程。
- Star 数
- ★ 111
- 最近更新
- 29 天前
- License
- MIT
- 主语言
- Ruby
- FA 评分
- 63/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- Rails 团队需要把网页抓取等确定性 Ruby 操作与模型信息提取串成一条 Pipeline。
- 不适合
- 需要稳定且不变 API 的生产团队
- 维护状态
- 近 30 天有提交最近提交 2026-10-23
- 源码审查
- 63/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
ActiveHarness 是面向 Ruby 和 Rails 应用的 LLM 框架,可在 Rails 中使用,也支持纯 Ruby。开发者通过 Prompt、Request、Pipeline、Tribunal、Memory、Tool 和 Agent 等组件组织 AI 流程;自 v0.3.0 起,Request 表示单次模型调用,Agent 表示使用工具的循环。Request 可配置模型链、重试、回退和生命周期钩子,Pipeline 可串联确定性 Ruby 步骤与模型请求。Tribunal 并行运行多个请求,并按一致意见生成 Verdict。框架提供令牌、成本和耗时跟踪、事件追踪及 SSE 流式输出;README 将 API 标为开发中,可能随版本变化。
在 Ruby 或 Rails 项目中安装 active_harness gem,并将 AI 代码组织在 app/ai。使用 Request 配置模型调用、模型链、回退、重试和钩子;Pipeline 按顺序运行 Ruby 操作与 Request,也可组合嵌套流程;Tribunal 并行执行多个 Request 并生成 Verdict。Agent 可按设定轮数请求模型、运行明确列出的 Tool、检查 GoalCheck,并在限制条件下停止。Memory 可从 JSON、SQLite 或 PostgreSQL 保存对话历史并注入提示。执行过程中可跟踪令牌、费用和时间,使用 OpenTelemetry 事件追踪,或通过 SSE 输出流式内容。
- Rails 团队需要把网页抓取等确定性 Ruby 操作与模型信息提取串成一条 Pipeline。
- Ruby 开发者希望在模型失败时按配置切换后备模型并重试请求。
- 需要多个模型并行回答并依据多数、一致或自定义规则作出 Verdict 的应用团队。
- 需要模型在明确权限范围内调用文件读取等受控操作,并用 GoalCheck 判断任务是否完成的开发者。
- 需要保留对话历史并在后续提示中复用的 Ruby 应用。
- 需要观察各请求、Pipeline 和 Tribunal 的令牌成本、耗时与追踪事件的团队。
如何安装或部署这个 Agent?
README 说明该 gem 可用于 Rails 和纯 Ruby 项目,并列出 Rails 安装生成器,但所给材料没有提供 gem 安装命令、Ruby 版本要求、完整 provider 配置或所需凭据名称。安装生成器的用法如下:
rails g active_harness:install该命令会创建一个包含示例 FilesAgent、工具、目标检查和追踪 concerns 的 Rails 设置。README 也列出 rails g active_harness:agent、:tool 和 :goal 生成器。纯 Ruby 的具体安装和初始化步骤未在所给材料中说明。
如何使用这个 Agent?
在 Rails 安装生成器创建的示例基础上,定义 Agent,指定 Request、可用 Tool 和 Goal,然后调用它:
class FilesAgent < ActiveHarness::Agent
max_turns 8
request FilesRequest
tools LsTool, ReadFileTool
goal AnswerPresentGoal
end
agent = FilesAgent.call(input: "What is in the storage directory?")
agent.output
agent.stop_reason
puts agent.trace模型访问需要配置可用 provider;README 说明工具调用支持 OpenAI-compatible providers 和 Anthropic,但所给材料未列出凭据名称或完整配置示例。按需在 Request、Pipeline 或 Tribunal 中配置重试、回退、追踪和成本控制。
这个 Agent 有哪些优点和局限?
- 同一 Pipeline 可组合普通 Ruby 步骤与 LLM Request,适合把确定性处理和模型任务分开编排。
- Request 支持模型链、自动回退、重试和生命周期钩子,可控制故障处理。
- Tribunal 支持并行请求和一致、多数或自定义 Verdict 规则。
- 支持成本与耗时跟踪、OpenTelemetry 追踪、SSE 流式输出及 JSON、SQLite、PostgreSQL 对话记忆。
- Agent 只能调用显式列出的工具;Tool 支持参数类型、逐步校验和默认拒绝。
- 项目明确标为开发中,API 可能在版本间变化。
- Agent 是第一版抽象;从 v0.3.0 起,原 ActiveHarness::Agent 名称改为 ActiveHarness::Request,旧代码可能需要调整。
- 使用模型需要 provider 配置和网络访问;所给材料未提供安装所需 Ruby 版本或凭据配置细节。
- Agent 工具调用的文档支持范围列为 OpenAI-compatible providers 和 Anthropic,不能据此确认所有 provider 都支持工具调用。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| ActiveHarness:Ruby LLM 流程框架 当前 | 63 · 存在缺口 | 开发框架免费 + 模型费 | ★ 111 | 29 天前 | Ruby | OpenAI API · Claude API |
| Adaline Gateway | 54 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 608 | 3 个月前 | TypeScript | OpenAI API · Claude API |
| Instructor | 64 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 14k | 2 天前 | Python | OpenAI API · Claude API |
| Agent Adapter 工具执行框架 | 72 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 13 | 3 天前 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
文档展示 Agent 仅可调用显式列出的工具,工具采用 default-deny、参数步骤和安全拒绝;示例还把文件读取限制在 storage/,因此最小权限和外部效果控制有实质依据。API 密钥可由 ENV 或 Rails credentials 配置,且追踪可记录调用;但没有统一的逐次用户确认流程,也没有完整说明提示词、记忆、日志和提供商之间的数据流或敏感数据保留策略,故未给满分。虽描述预期错误与安全消息,依赖安全审查信息有限;安装生成器会修改应用文件及路由,文档称不覆盖已有文件,但未提供撤销步骤。署名仅见 README 和许可证,发布者身份与维护更新路径不够清楚。
README 将单次调用命名从 ActiveHarness::Agent 改为 Request,并称 Agent 是工具调用循环;但随附 CLAUDE.md 仍称当前版本为 0.2.x,且把产品概述写成旧版模型,和 README 的 v0.3.0 命名说明存在冲突。文档指出并行 tribunal 依赖 concurrent-ruby,也披露定价数据来自 models.dev、缓存失败时返回空列表。重试、fallback、停止错误和部分失败均有说明,但这些材料不能证明运行结果。
目标用户和场景具体覆盖 Rails 与 plain Ruby、请求、流水线、tribunal、Agent、工具、记忆、流式处理及多提供商。文档明确 Agent 工具清单、轮次和成本限制,以及图像与音频支持范围;但仍有自定义 provider、外部 LLM backend 等宽泛扩展点,权限及能力边界未完整讨论。README 的定位清楚,触发场景由用户创建并调用类与 DSL,未见隐式自动执行。Rails autoload、生成器和 plain Ruby 配置都有对应说明,环境适配充分。
README 提供清晰目录、术语索引及按功能划分的文档,安装、Rails/plain Ruby 配置、生成器和丰富示例都有说明;MIT 许可证文本完整。README 明示 work in progress 和 API 可能变动,但提供材料没有完整 changelog 或明确版本支持政策;命名迁移与 CLAUDE.md 旧版本描述冲突。README 的许可证署名可见,但没有明确维护责任人与更新渠道。README 的示例和文档链接覆盖常见使用方式,未见专门 FAQ。
框架把重试、fallback、成本追踪、事件 hook、流水线和受限工具整合进 Ruby/Rails DSL,能减少自行搭建基础设施的工作;文档给出可复制的结构和使用示例。价值主张主要由项目自身描述,未提供对照评估或外部验证;多个提供商、并行 tribunal 和重试也会增加调用费用与配置复杂度,成本控制文档未完整量化这些取舍,因此分数适中。
README、安装及配置文档把许多功能主张对应到 API 示例、设置项和限制说明;token_usage 文档也指出部分 provider 不返回 usage,流式调用时 usage 为 nil。不同材料之间存在一定交叉印证,但所给 CLAUDE.md 与 README 的版本和抽象命名不一致,削弱一致性;宣传性效果主张未附外部证据。文档通常能区分示例与配置事实,但不能据此确认实现行为或效果。
- 这是静态审阅,置信度低;未执行代码,不能据此确认安全性、正确性或测试质量。
- CLAUDE.md 的 0.2.x 版本和旧 Agent 命名与 README 的 v0.3.0 说明冲突,建议核对目标修订的实际 API 与版本记录。
- 部署前应审查工具实现、prompt/记忆/追踪中的敏感数据处理,并确认生成器写入的路由和文件符合应用预期。
常见问题
ActiveHarness 是自主 Agent,还是一次模型调用?
能否把普通 Ruby 逻辑和模型请求放在同一工作流?
工具调用支持哪些 provider?
如何记录模型调用的费用和运行情况?
使用前需要注意什么?
ActiveHarness:Ruby LLM 流程框架 开源吗?
ActiveHarness:Ruby LLM 流程框架 安全吗?
ActiveHarness:Ruby LLM 流程框架 还在维护吗?
ActiveHarness:Ruby LLM 流程框架 是谁开发的?
谢谢反馈,我们会据此改进页面。