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）提供追蹤、token 使用量與各代理的指標。