activeagents/activeagent

解决的问题

Active Agent 为在 Ruby on Rails 应用中集成 AI 提供了一个结构化框架。它用“面向代理编程”取代了 LLM 的随意集成，将代理视为模块化、可复用的组件（类似于 Rails 中的控制器），从而提升 AI 驱动应用的代码可维护性和可扩展性。

工作原理

该框架允许开发者通过继承基类来定义代理为 Ruby 类。这些代理可通过配置文件配置使用多种 LLM 提供商（如 OpenAI、Anthropic、Ollama 等）。开发者在这些代理类中定义“动作”作为方法，以封装特定的 AI 任务。系统支持使用 ERB 的提示模板、通过 ActionCable 的流式响应，以及结构化 JSON 输出。

适用人群

希望使用熟悉的面向对象 Ruby 模式，并为 AI 逻辑构建结构化架构层的 Ruby on Rails 开发者。

主要亮点

• 面向代理编程：使用熟悉的模式将 AI 逻辑集成到 Rails 框架中。
• 多提供者支持：兼容 OpenAI、Anthropic、Ollama 和 RubyLLM。
• 多模态能力：支持从图像、PDF 和文本中提取数据。
• 代理委派：允许主代理将任务委派给具有明确定义合同和预算（成本/延迟）的子代理。
• 工具/函数调用：使代理能够通过工具与外部服务交互。
• 可观测性仪表板：可选的配套 gem（actionagent）提供追踪、令牌使用情况和每个代理的指标。