Show HN：Rails Agent——在 Ruby on Rails 中原生构建自主 AI 智能体
Rails Agent 是一个为 Ruby on Rails 打造的全栈 AI Agent 框架，宣称 Rails 开发者无需掌握 LLM、嵌入或提示工程知识，就能用熟悉的 Rails 技能构建、测试、部署和监控生产级智能体。它提供目录化的 agent 结构、BYOK 模型、上千个连接器、250+ Playbook 以及托管云运行时。
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 方案。