Show HN：Rails Agent——在 Ruby on Rails 中原生構建自主 AI 智能體

Rails Agent 是一個在 Ruby on Rails 中原生構建 AI 智能體的全棧框架。它把智能體的開發、測試、部署和監控放進同一個平台，主要賣點是：Rails 開發者不需要額外學習 LLM、詞嵌入或提示工程，只要會寫 Rails，就能把智能體功能加入應用。項目要求 Rails 7+、Ruby 3.2+，並提供了包含在框架內的雲端運行時。

框架的核心理念是“一個智能體就是一個目錄”。每個智能體對應 app/agents/ 下的一個文件夾，裏面有 agent.rb（普通 Ruby 類，負責選模型和寫指令）、tools/（每個文件對應一個動作，如查訂單、發郵件）、connectors/（一鍵接入 Google Sheets、Notion、HubSpot 等）、memory.rb（按用户、線程或組織保存記憶）、knowledge/（放 PDF/Markdown 或指向數據庫，由平台自動分塊、嵌入和檢索）、evals/（示例對話和期望答案）以及 prompt.md（系統提示詞，用 Markdown 編寫）。這個結構完全以代碼為準，沒有隱藏的 YAML 配置，開發者可以在 Dashboard 和 git 之間同步同一個文件。

目前提供 Knowledge Agent 和 Workflow Agent 兩種類型，分別映射到 RailsAgents::KnowledgeAgent 和 RailsAgents::WorkflowAgent 基類。前者適合回答“訂單 ORD-1001 在哪裏”這類需要查詢 Rails 數據庫和文檔的問題；後者適合“新訂單出現後，更新 Google Sheets 併發送郵件通知”這類流程。創建智能體時選擇類型，或從 Playbook 克隆腳手架，元數據和對應的 gem 基類會自動生成。

平台從第一天就考慮生產需求：執行過程帶檢查點，崩潰或重啓後工作流能繼續；需要確認的工具會觸發人工審批門，會話掛起直到被處理；默認開啓跨會話記憶，也可以按智能體關閉。Dashboard 的 Monitor 區域可以搜索每次運行的 trace、日誌、錯誤和成本，並支持按月 token 預算告警、模型訪問策略、提示注入檢測和敏感信息脱敏。內置的 eval 套件帶評分標準，能在發佈前驗證每次改動。

連接器方面，Rails Agent 宣稱支持 1,000+ 應用的一鍵安裝，包括 Google Sheets、Notion、GitHub、Slack、Gmail、HubSpot、Linear、Discord、Stripe、Zendesk、Salesforce、Figma、Zoom 和 OpenAI 等，OAuth 由平台託管。除了官方連接器，開發者還能從 Build → Packages 搜索 Skills.sh、Smithery 和 Microsoft APM 註冊中心，把技能和 MCP 服務器直接附加到 agent 文件夾。另有 250+ Playbook，覆蓋客服、銷售、工程、市場、財務、運營、HR、法務、設計、數據等 20 個類別，克隆後即可獲得 agent.rb、prompt.md 和元數據。

同一個智能體可以通過 OpenWire 分發到多個渠道：Slack、Microsoft Teams、WhatsApp、網頁聊天、郵件、Discord、Telegram、短信/電話（Twilio）、GitHub、Linear、cron 定時任務和 HTTP API，所有渠道共享同一個“大腦”，無需重複構建 OAuth 和事件管道。

上手流程很簡單：在 Gemfile 中加入 gem 'rails-agent-stack'，運行 bundle install 和 bin/rails generate rails_agents:install，啓動 Rails 服務器後打開 /agents（類似 Sidekiq 的界面），註冊並添加 provider key，然後按 Dashboard 文檔創建空白 agent 或從 Playbook 克隆。模型採用 BYOK：把 OpenAI、Anthropic、Google 或 OpenRouter 的密鑰加密存儲在對應 workspace 和 agent 上，模型費用直接計入開發者自己的賬户，不經過平台；託管基礎設施則按成本轉嫁並收取透明的 5% 服務費。

作者將 Rails Agent 與 RubyLLM、ActiveAgent 做了對比，認為後兩者只是給開發者一個客户端，仍然需要自己懂 AI、搭建 Dashboard 和運行運行時；Rails Agent 則提供完整平台，包含 Dashboard、Playbook、託管運行時、trace、eval、監控、預算和護欄。對於不想碰 Python、LangChain 和 YAML 粘合代碼的 Rails 團隊來説，這是一個值得關注的 All-in-One 方案。