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
将 gem 添加到 Gemfile(需要 Ruby 3.3 或更高版本)
gem 'boxcars' - 2
使用 Bundler 安装依赖
bundle install - 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 数据每日更新。
相关项目
面向 Ruby 的 AI 框架,通过统一 API 提供对话、工具调用、智能体、嵌入和 Rails 集成。
面向 Elixir 应用的 LLM 集成库,支持 Claude、OpenAI、Gemini、Ollama 及自托管模型。
面向 LLM 查询的语义缓存库,复用相似问题的响应,以降低 API 成本和延迟。
开源 MCP 服务器,让 AI 智能体、IDE 和应用安全连接各类数据库。
一个用于构建和运行基于大模型的自主智能体与多智能体工作流的开源平台,附带无代码图形编辑器。