activeagents/activeagent

这是什么？

核心功能

• 01智能体以类似 Rails 的方式定义，包含动作和 ERB 提示词模板。
• 02支持 OpenAI、Anthropic、Ollama、DeepSeek、OpenRouter 和 RubyLLM 等服务。
• 03通过 ActionCable 实时流式返回响应。
• 04支持工具调用，并可将任务委托给带声明式 Schema 的子智能体。
• 05可基于 JSON Schema 输出结构化结果。
• 06提供命令行工具，可在 CI 中运行评估。

适用场景

• 为现有 Rails 应用添加聊天或助手功能。
• 在 Rails 应用中从图片、PDF 或文本中提取结构化数据。
• 构建多步骤智能体工作流，由一个智能体将任务委托给另一个。
• 将智能体行为评估纳入 CI 流水线运行。

快速上手

1. 1

   将 activeagent gem 添加到 Gemfile

   bundle add activeagent
2. 2

   添加生成服务提供方的 gem，例如 OpenAI

   bundle add openai
3. 3

   运行安装生成器以创建配置文件

   rails generate active_agent:install
4. 4

   生成带有动作的第一个智能体

   rails generate active_agent:agent TravelAgent search book confirm

使用前须知

• !需要 Ruby 3.1 或更高版本以及受支持的 Rails 版本（7.2、8.0 或 8.1）。
• !大多数服务提供方需要 API 密钥，或需要单独运行的服务（如 Ollama）。
• !仪表板是独立的 gem actionagent，需要额外的配置和数据库迁移。

收录于专题

标签

常见问题

activeagent 是什么？

一个 Rails 框架，让开发者用控制器和视图的方式构建 AI 智能体应用。 Active Agent 为 Rails 补充了 AI 能力层。智能体以继承自 ApplicationAgent 的 Ruby 类形式编写，其中的动作像控制器方法一样工作，提示词则可以用 ERB 模板生成，支持文本、JSON 或 HTML 格式。

activeagent 可以免费使用吗？用的什么许可证？

activeagent 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

activeagent 还在维护吗？

活跃维护中。activeagent 最近一次提交是在 2026年11月6日。

activeagent 适合用来做什么？

为现有 Rails 应用添加聊天或助手功能。 在 Rails 应用中从图片、PDF 或文本中提取结构化数据。 构建多步骤智能体工作流，由一个智能体将任务委托给另一个。 将智能体行为评估纳入 CI 流水线运行。

activeagent 怎么安装和运行？

将 activeagent gem 添加到 Gemfile: bundle add activeagent 添加生成服务提供方的 gem，例如 OpenAI: bundle add openai 运行安装生成器以创建配置文件: rails generate active_agent:install 生成带有动作的第一个智能体: rails generate active_agent:agent TravelAgent search book confirm

在哪里获取 activeagent？

源代码和安装说明在 GitHub 上：https://github.com/activeagents/activeagent