ActiveHarness:Ruby LLM 流程框架

为 Ruby 应用编排可追踪、可控成本并具备故障恢复能力的 LLM 请求流程。

Star 数
★ 111
最近更新
29 天前
License
MIT
主语言
Ruby

30 秒速览

运行形态
开发框架代码库 / SDK
可在哪里用
通用 · 跨平台OpenAI API · Claude API
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
RubyRails(可选)网络访问
典型场景
Rails 团队需要把网页抓取等确定性 Ruby 操作与模型信息提取串成一条 Pipeline。
不适合
  • 需要稳定且不变 API 的生产团队
维护状态
近 30 天有提交最近提交 2026-10-23

这个 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 输出流式内容。

  1. Rails 团队需要把网页抓取等确定性 Ruby 操作与模型信息提取串成一条 Pipeline。
  2. Ruby 开发者希望在模型失败时按配置切换后备模型并重试请求。
  3. 需要多个模型并行回答并依据多数、一致或自定义规则作出 Verdict 的应用团队。
  4. 需要模型在明确权限范围内调用文件读取等受控操作,并用 GoalCheck 判断任务是否完成的开发者。
  5. 需要保留对话历史并在后续提示中复用的 Ruby 应用。
  6. 需要观察各请求、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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
63/ 100 五分制 3.2 / 5
信任安全 14/29
可靠稳定 8/14
适用触发 15/18
规范维护 13/18
有效结果 9/13
证据核验 4/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

文档展示 Agent 仅可调用显式列出的工具,工具采用 default-deny、参数步骤和安全拒绝;示例还把文件读取限制在 storage/,因此最小权限和外部效果控制有实质依据。API 密钥可由 ENV 或 Rails credentials 配置,且追踪可记录调用;但没有统一的逐次用户确认流程,也没有完整说明提示词、记忆、日志和提供商之间的数据流或敏感数据保留策略,故未给满分。虽描述预期错误与安全消息,依赖安全审查信息有限;安装生成器会修改应用文件及路由,文档称不覆盖已有文件,但未提供撤销步骤。署名仅见 README 和许可证,发布者身份与维护更新路径不够清楚。

可靠稳定8 / 14 · 2.9/5

README 将单次调用命名从 ActiveHarness::Agent 改为 Request,并称 Agent 是工具调用循环;但随附 CLAUDE.md 仍称当前版本为 0.2.x,且把产品概述写成旧版模型,和 README 的 v0.3.0 命名说明存在冲突。文档指出并行 tribunal 依赖 concurrent-ruby,也披露定价数据来自 models.dev、缓存失败时返回空列表。重试、fallback、停止错误和部分失败均有说明,但这些材料不能证明运行结果。

适用触发15 / 18 · 4.2/5

目标用户和场景具体覆盖 Rails 与 plain Ruby、请求、流水线、tribunal、Agent、工具、记忆、流式处理及多提供商。文档明确 Agent 工具清单、轮次和成本限制,以及图像与音频支持范围;但仍有自定义 provider、外部 LLM backend 等宽泛扩展点,权限及能力边界未完整讨论。README 的定位清楚,触发场景由用户创建并调用类与 DSL,未见隐式自动执行。Rails autoload、生成器和 plain Ruby 配置都有对应说明,环境适配充分。

规范维护13 / 18 · 3.6/5

README 提供清晰目录、术语索引及按功能划分的文档,安装、Rails/plain Ruby 配置、生成器和丰富示例都有说明;MIT 许可证文本完整。README 明示 work in progress 和 API 可能变动,但提供材料没有完整 changelog 或明确版本支持政策;命名迁移与 CLAUDE.md 旧版本描述冲突。README 的许可证署名可见,但没有明确维护责任人与更新渠道。README 的示例和文档链接覆盖常见使用方式,未见专门 FAQ。

有效结果9 / 13 · 3.5/5

框架把重试、fallback、成本追踪、事件 hook、流水线和受限工具整合进 Ruby/Rails DSL,能减少自行搭建基础设施的工作;文档给出可复制的结构和使用示例。价值主张主要由项目自身描述,未提供对照评估或外部验证;多个提供商、并行 tribunal 和重试也会增加调用费用与配置复杂度,成本控制文档未完整量化这些取舍,因此分数适中。

证据核验4 / 8 · 2.5/5

README、安装及配置文档把许多功能主张对应到 API 示例、设置项和限制说明;token_usage 文档也指出部分 provider 不返回 usage,流式调用时 usage 为 nil。不同材料之间存在一定交叉印证,但所给 CLAUDE.md 与 README 的版本和抽象命名不一致,削弱一致性;宣传性效果主张未附外部证据。文档通常能区分示例与配置事实,但不能据此确认实现行为或效果。

风险与缓解建议
  • 这是静态审阅,置信度低;未执行代码,不能据此确认安全性、正确性或测试质量。
  • CLAUDE.md 的 0.2.x 版本和旧 Agent 命名与 README 的 v0.3.0 说明冲突,建议核对目标修订的实际 API 与版本记录。
  • 部署前应审查工具实现、prompt/记忆/追踪中的敏感数据处理,并确认生成器写入的路由和文件符合应用预期。
证据充分度:低 评估于 2026年11月11日 审查版本 d6c7365f67c0
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/active-harness.svg?lang=zh)](https://followagents.com/zh/agents/active-harness)
<a href="https://followagents.com/zh/agents/active-harness"><img src="https://followagents.com/badge/active-harness.svg?lang=zh" alt="FARS 评测"></a>

常见问题

ActiveHarness 是自主 Agent,还是一次模型调用?
ActiveHarness::Request 表示单次 LLM 调用及其模型链、回退、重试和钩子。ActiveHarness::Agent 是另一种抽象:它循环请求模型、运行允许的 Tool 并检查 Goal。
能否把普通 Ruby 逻辑和模型请求放在同一工作流?
可以。Pipeline 支持按顺序组合确定性 Ruby 步骤与 Request,也支持嵌套 Pipeline。
工具调用支持哪些 provider?
README 明确提到 OpenAI-compatible providers 和 Anthropic。材料没有证明其他 provider 的工具调用支持情况。
如何记录模型调用的费用和运行情况?
框架可跟踪请求、Pipeline 和 Tribunal 的令牌、费用及耗时,并通过事件钩子和 OpenTelemetry 追踪执行过程。
使用前需要注意什么?
README 将项目标为开发中,API 可能变化;还需要配置模型 provider。所给材料没有列出具体 Ruby 版本和凭据设置步骤。
ActiveHarness:Ruby LLM 流程框架 开源吗?
开源。源码在 GitHub(the-teacher/active_harness),许可证是 MIT。
ActiveHarness:Ruby LLM 流程框架 安全吗?
FollowAgents 的 FARS 评审(2026年11月11日)给 ActiveHarness:Ruby LLM 流程框架 的“信任与安全”打了 14/29 分。评审检查的 8 项安全措施没有完全缺失的。
ActiveHarness:Ruby LLM 流程框架 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-10-23,在最近 30 天内。
ActiveHarness:Ruby LLM 流程框架 是谁开发的?
ActiveHarness:Ruby LLM 流程框架 由 GitHub 账号 the-teacher 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念