Repolode
BoxcarsAI

BoxcarsAI/boxcars

一个 Ruby 框架,用可组合的工具、Train 与 Agent 构建基于大模型的应用。

Star
462
Fork
42
未关闭 Issue
7
最近提交
25天前

这是什么?

Boxcars 是一个用于构建大模型应用的 Ruby 框架,尤其面向 Ruby 和 Rails 团队。业务逻辑被封装为 Boxcar 对象,每个 Boxcar 负责单一任务,如搜索、计算、SQL 或 ActiveRecord 查询以及 API 调用。Train 借助 Engine 把问题拆解给各个 Boxcar 处理,既支持传统的文本 ReAct(ZeroShot),也支持原生的 provider 工具调用(ToolTrain)。

框架通过统一的 Engine 模式对接多家模型服务,包括 OpenAI、Anthropic、Groq、Gemini、Ollama 和 Perplexity 等。它还支持基于 JSON Schema 的结构化输出、向量存储,并可通过 stdio 连接 MCP 服务器,将外部 MCP 工具与本地工具合并调用。更高层的 StationAgent 提供生命周期回调、Agent 嵌套、任务移交和事件流。

SQL 与 ActiveRecord 类工具默认处于只读模式,除非显式开启,否则会拒绝写操作。可选的 provider 依赖按需加载,项目要求 Ruby 3.3 及以上版本。

核心功能

  • 01将领域逻辑封装为可复用的 Boxcar 工具,覆盖 SQL、ActiveRecord、搜索和 API 调用。
  • 02提供 ZeroShot 文本 ReAct 与 ToolTrain 原生工具调用两种编排方式。
  • 03通过统一的 Engine 支持 OpenAI、Anthropic、Groq、Gemini、Ollama 等模型服务。
  • 04借助 JSONEngineBoxcar 使用 JSON Schema 约束结构化输出。
  • 05通过 stdio 连接 MCP 服务器,并与本地 Boxcar 工具合并使用。
  • 06提供带生命周期回调、任务移交和事件流的 StationAgent。

适用场景

  • 为团队搭建可查询文档以及 ActiveRecord 或 SQL 数据的内部助手。
  • 开发调用 Swagger 定义的 API 完成多步操作的运维机器人。
  • 在检索优先的助手中结合向量搜索与后续工具调用。
  • 将自定义 Ruby 工具与 MCP 服务器提供的工具混合使用。

快速上手

  1. 1

    将 gem 添加到 Gemfile(需要 Ruby 3.3 或更高版本)

    gem 'boxcars'
  2. 2

    使用 Bundler 安装依赖

    bundle install
  3. 3

    或直接安装该 gem

    gem install boxcars

使用前须知

  • 需要 Ruby 3.3 或更高版本。
  • 许多功能需要单独添加可选的提供商 gem 并配置 API 密钥。

收录于专题

标签

常见问题

boxcars 是什么?
一个 Ruby 框架,用可组合的工具、Train 与 Agent 构建基于大模型的应用。 Boxcars 是一个用于构建大模型应用的 Ruby 框架,尤其面向 Ruby 和 Rails 团队。业务逻辑被封装为 Boxcar 对象,每个 Boxcar 负责单一任务,如搜索、计算、SQL 或 ActiveRecord 查询以及 API 调用。Train 借助 Engine 把问题拆解给各个 Boxcar 处理,既支持传统的文本 ReAct(ZeroShot),也支持原生的 provider 工具调用(ToolTrain)。
boxcars 可以免费使用吗?用的什么许可证?
boxcars 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
boxcars 还在维护吗?
活跃维护中。boxcars 最近一次提交是在 2026年10月13日。
boxcars 适合用来做什么?
为团队搭建可查询文档以及 ActiveRecord 或 SQL 数据的内部助手。 开发调用 Swagger 定义的 API 完成多步操作的运维机器人。 在检索优先的助手中结合向量搜索与后续工具调用。 将自定义 Ruby 工具与 MCP 服务器提供的工具混合使用。
boxcars 怎么安装和运行?
将 gem 添加到 Gemfile(需要 Ruby 3.3 或更高版本): gem 'boxcars' 使用 Bundler 安装依赖: bundle install 或直接安装该 gem: gem install boxcars
在哪里获取 boxcars?
源代码和安装说明在 GitHub 上:https://github.com/BoxcarsAI/boxcars

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目