OmniAgent：为 Rails 应用打造的原生 AI Agent 框架

OmniAgent 是一个 Rails Engine gem，它提供了一套完整的 DSL 来定义 AI Agent、工具模式、提示模板和生命周期回调，让开发者能够在 Rails 应用中轻松构建具备工具调用能力的智能代理。

• 原作者/维护者: ACR1209
• 来源平台: GitHub
• 原始标题: omni_agent
• 原始链接: https://github.com/ACR1209/omni_agent
• 发布时间: 2026年6月

随着大型语言模型（LLM）能力的不断提升，越来越多的开发者希望在现有 Web 应用中集成 AI 功能。然而，大多数 AI 框架都是语言无关或 Python 优先的，对于 Rails 开发者来说，这意味着需要学习新的技术栈或编写大量的胶水代码。

OmniAgent 的出现填补了这一空白。它是一个专门为 Rails 设计的 Engine gem，让 Ruby 开发者可以用熟悉的 Rails 模式和约定来构建 AI Agent，无需离开 Ruby 生态就能实现复杂的智能代理功能。

OmniAgent 的核心定位是「Rails-native」——它不是简单的 API 封装，而是深度融入 Rails 架构的完整解决方案。项目采用 MIT 许可证开源，主要包含以下组件：

1. OmniAgent::Agent - 运行时核心，提供 provider 抽象和工具调用循环
2. OmniAgent::Tool - 工具定义 DSL，支持 JSON Schema 风格的输入验证
3. Prompt 模板系统 - 基于 ERB 的提示文件管理
4. 生命周期回调 - before_generation 和 after_generation 钩子
5. Provider 抽象层 - 开箱即用的 OpenAI 集成，可扩展其他 provider

OmniAgent 的最大亮点是其优雅的 DSL 设计。开发者可以通过继承 OmniAgent::Agent 类并声明式地配置各种属性：

class ResearchAgent < OmniAgent::Agent
  use_model "gpt-4o-mini"
  
  before_generation :set_current_user
  
  def set_current_user
    @user = "Test User"
  end
end

框架支持两种配置方式：

• use_model - 快捷方式，自动使用默认 provider
• provider - 完整配置，可指定 provider 名称和额外选项

这种设计既满足了快速原型开发的需求，又为生产环境的精细调优留下了空间。

工具（Tool）是 AI Agent 与外部世界交互的桥梁。OmniAgent 提供了一套类型安全的工具定义 DSL：

module ResearchAgent::Tools
  class GetWeather < OmniAgent::Tool
    description "获取指定城市的当前天气"
    tags :weather
    metadata category: :utility
    
    input do
      string :city, description: "城市名称"
    end
    
    def execute(city:)
      "#{city} 天气晴朗"
    end
  end
end