关于 SeldonFrame
SeldonFrame 是面向服务本地商家的代理机构的开源业务平台,可由编码 Agent 创建包含网站、预约、表单、CRM 和 AI Agent 的客户工作区。它还提供运行评估、发布和集中运营客户工作区的流程。
主要功能
- 01生成品牌化客户工作区
- 02创建网站、预约和接待表单
- 03配置 CRM 与 AI Agent
- 04运行评估并验证预订
- 05集中管理多个客户工作区
- 06支持自托管部署
适用场景
- 01为本地商家搭建线上业务入口
- 02为客户配置预约与接待 Agent
- 03发布前测试 Agent 和预约流程
- 04从 IDE 管理代理机构客户项目
MCP 相关
本地 MCP 服务通过工具让编码 Agent 创建和更新工作区;可从 Claude Code、Cursor、Windsurf 等 MCP 兼容环境使用。每个 Agent 还可提供签名 MCP 端点,供其他 LLM 租用。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
156收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| business_name | string | 是 | 企业显示名称(例如 'Summit Air Comfort')。 |
| city | string | 是 | 操作人员所在的城市。用于推断时区。 |
| state | string | 是 | 美国州代码或全名(也可以是加拿大省份)。用于推断时区。 |
| phone | string | 是 | 企业电话号码,格式不限。显示在导航栏、主视觉区和页脚中。 |
| services | array | 是 | 企业提供的服务/产品,每项使用普通字符串。分类器会读取这些内容,以选择合适的 CRM 类型(HVAC、法律、牙科、教练、代理机构或默认类型)。 |
| business_description | string | 是 | 用一段话描述企业——此内容会影响主视觉区副标题、关于版块,以及(尤其重要的)类型分类器。请原样包含行业词语('residential HVAC'、'family-owned plumbing'、'dental practice')。 |
| review_count | number | 否 | 可选——评价数量。显示在信任信息栏和主视觉区的证明指标中。 |
| review_rating | number | 否 | 可选——平均星级评分(例如 4.7)。显示在信任信息栏中。 |
| certifications | array | 否 | 可选——资质,例如 ['EPA-certified', 'NATE-certified']。显示在信任信息栏中。 |
| trust_signals | array | 否 | 可选——简短声明,例如 ['licensed', 'bonded', 'insured']。显示在信任信息栏中。 |
| emergency_service | boolean | 否 | 可选——服务提供商提供全天候紧急服务。显示在导航栏和主视觉区域。 |
| same_day | boolean | 否 | 可选——提供当日服务。显示在信任信息栏中。 |
| service_area | array | 否 | 可选——服务覆盖的城市或街区(例如 ['Scottsdale', 'Tempe'])。 |
| string | 否 | 可选的联系邮箱,显示在落地页页脚中(不是服务提供商的账户邮箱——账户邮箱通过 finalize_workspace 提供)。 | |
| address | string | 否 | 可选的营业地址。 |
详细介绍
SeldonFrame
销售 AI 前台。几分钟即可部署。
SeldonFrame 是面向服务本地商家的代理机构、以 Agent 为核心的开源 GoHighLevel 替代方案。将客户的网址交给你的编码 Agent,它就能在一个工作区中创建品牌网站、预约流程、客户接待、CRM 和 AI Agent。运行评测、发布并交接,然后即可通过一个代理机构视图管理所有客户。
发布您的首个客户前台
claude mcp add seldonframe -- npx -y @seldonframe/mcp
或作为自动更新的 Claude Code 插件:
/plugin marketplace add seldonframe/seldonframe
/plugin install seldonframe@seldonframe
> Build a branded AI front office for my HVAC client in New Orleans.
✓ Workspace ready at acme-hvac.app.seldonframe.com
先构建客户工作区,再决定是否付费。托管版 Managed 使用 SeldonFrame 的密钥;Builder 和 Agency 方案采用 BYOK。您的代理机构拥有客户关系、工作区数据和交付利润。
亲眼看看实际效果——这是真实运行的工作区,不是模型图:
|
|
| 生成的网站——报价收集、评价和聊天 Agent(右下角) | 预约页面——Agent 实际使用的日历 |
下面是该网站上的 Agent 处理真实来访请求的示例——它会查看实时日历;有人询问价格时,它不会编造答案(这是报价保护机制在发挥作用,并非预先编写的回复):
点击任意截图——这个 HVAC 工作区正在实际运行,并能预约真实服务。更多实际运行的工作区:Metro MedSpa · SKINNEY Medspa · Vive Ageless Weight Loss——以及 seldonframe.com 上的更多示例。
代理机构交付流程
- 从客户网址开始。 SeldonFrame 提取业务信息并创建工作区。
- 应用代理机构的操作手册。 设置网站、预约流程、信息收集、CRM 和 Agent 的品牌样式与配置。
- 交接前进行验证。 运行评估并完成一次真实测试预约。
- 发布并运营。 为客户提供品牌化门户,同时由您的代理机构保留主视图。
同一流程适用于控制面板、Claude Code、Cursor、Windsurf 或任何兼容 MCP 的 Agent。请参阅代理机构工作流。
Agent 在这里由什么构成
大多数“Agent 框架”只给您一个聊天循环,然后让您自求多福。SeldonFrame 为您的 IDE Agent 提供完整的生产环境架构:
Agent 模型——触发条件 × 技能 × 渠道
Agent 不是聊天机器人界面,而是由三个相互独立的维度构成:
- 触发条件——何时运行:入站(收到来电 / 聊天 / 邮件 / SMS)· 事件(触发领域事件——
booking.completed、lead.created、invoice.paid……)· 计划任务(按 cron 周期运行)。 - 技能——做什么:接待 · 请求评价 · 快速跟进潜在客户 · 重新赢回客户 · 摘要……
- 渠道——如何沟通:语音 · 网页聊天 · SMS · 邮件 · 内部摘要。
- 工具——能操作什么:原生工具(根据真实日历预订 · 读取 / 写入 CRM · 发送 SMS 和邮件 · 留言)以及通过 Composio 集成的 1,000 多种应用(Google Calendar、Sheets、Slack、HubSpot、Notion 等),按 Agent 绑定。
surface: voice | chat(旧版仅适用于接待员的选项)只是这个空间中的一个点——trigger=inbound。一个构建器可以创建任何 Agent;市场可以销售任何 Agent。
从 Agent 到生产环境中的循环
生产级 Agent 是一个循环,而非单条提示词:
触发条件 →(模型 + 工具 + 状态)→ 验证 → 迭代,受停止条件约束,通过评估持续改进,并由可观测性 + 防护措施确保可靠。
路线图由两项不可妥协的原则推动:检查者必须与创建者分离(让模型给自己的工作打分,标准会过于宽松),以及循环必须有刹车(否则它会悄无声息地向你收费)。各项基础能力目前的状态如下:
| 基础能力 | 状态 | 当前内容 |
|---|---|---|
| 触发条件 | ✅ 已发布 | SeldonEvent 总线上的入站 + 事件触发条件。booking.completed → 请求评价;lead.created → 快速跟进潜在客户;两者都会发送出站 SMS / 邮件。 |
| 状态 | ✅ 已发布 | Brain v2 中的 Agent loop-memory——Agent 会在行动前回忆之前做过什么,并在行动后记录。“每位客户只请求一次评价”的限制现在通过记忆回忆实现,而非专用标记。 |
| 验证(创建者 ≠ 检查者) | ✅ 已发布 | 确定性验证器会为每次运行评分——通过率显示在每个 Agent 的健康卡片和 /runs 中;run_agent_evals 会重放脚本化场景。正在逐步推出:将同一检查器用作发送前的强制关卡,并引入大模型评判器处理需要判断的情况。 |
| 防护措施 / 停止 | ✅ 已发布 | 报价防护(绝不编造价格)、预订前强制复述确认、每个联系人的频率限制、预订政策执行(营业时间 · 时长 · 必填字段)、通话 / 迭代次数硬性上限。正在逐步推出:针对长循环 Agent 的通用 token 预算刹车机制。 |
| 默认生成 | ✅ 已发布 | 一句英文 → 同步生成触发条件 + 技能 + 渠道 + 工具绑定 + 防护措施。“在工作完成后的第二天向每位客户发送短信,请求 Google 评价——每位客户仅发送一次,且仅在工作已完成时发送” 会被编译成一个真正的 Agent。generate_agent MCP 工具和 Studio 向导都会运行此流程。 |
| 录制 → Agent | 🗺 路线图 | 无需描述流程——只需屏幕共享一次工作流。SeldonFrame 会观察操作,将步骤编译成 Agent 草稿(技能 + 工具绑定 + 根据录制内容生成的评估场景),几分钟内即可部署。现已通过功能标志在 /record 后台启用;接下来将成为默认入门方式。 |
用图展示循环
一句话即可构建;触发器驱动运行;环形结构就是正在运行的循环——模型 → 工具 → 状态 → 验证——工具环绕核心运行,
/runs+ Brain 负责观察,Stop 刹车限制每一轮的边界。图中的一切现已推出。(动画 SVG——如果你的查看器无法播放,静态画面表达的内容也一样。)
深入了解预先配置的技术栈、架构选择和路线图:docs/ARCHITECTURE.md。
今天就能推出的五种 Agent
触发器 × 技能 × 渠道是彼此独立的维度——每种各选一项,就设计好了一个 Agent:
| Agent | 触发器 | 技能 | 渠道 | 有意思的地方 |
|---|---|---|---|---|
| AI 接待员 | 入站电话 | 资格确认 + 预订 | 语音 | 根据真实日历预订。报价保护、强制回读、通过 take_message 升级给负责人处理。 |
| 网站聊天机器人 | 入站聊天 | 同一套接待员技能 | 网页嵌入 | 同一蓝图,不同渠道——渠道可以互换。 |
| 快速跟进潜在客户 | lead.created 事件 | 首次触达 + 资格确认 | 短信 | 表单提交后几秒内就会触发,直接来自事件总线。 |
| 评价请求器 | booking.completed 事件 | 请求评价 | 短信 / 电子邮件 | Brain 回忆机制确保“绝不向同一客户重复请求”。 |
| 任何你能描述的 Agent | 任意 | 一句英文 | 任意 | Studio 向导会根据 Agent 所需的基本要素调整提问。 |
Brain——不断积累的记忆
会忘事的 Agent 只是演示。每个 SeldonFrame 工作区都拥有一个 Brain:
- Soul——Agent 据以构建的唯一事实来源(身份、服务、营业时间、定价)。安装他人的 Agent 后,它会基于你的 Soul 重新建立依据,绝不会沿用对方的事实。
- 循环记忆——Agent 行动前会回忆,行动后会记录。“我已经请求这位客户评价了吗?”依靠的是记忆回忆,而非专门设置的标记。
- 笔记 → 提炼后的规则——原始观察会按计划编译并提升为持久知识,因此每次运行都比上一次结束时更聪明。
内置资金流转机制
真正做事的 Agent 最终会接触真实资金——因此,这些机制是平台的基本功能,而不是集成项目:
- 预付钱包账本——使用 UNIQUE 幂等键和受保护的非负扣减:费用不会重复扣取,余额也不会低于零。
- Stripe Connect 付款——
seldonframe payout会将累计收益转入银行账户。 - 可完成履约的结账——市场交易会自动配置部署,并根据买家的业务重新建立依据。
- 按次租用计费——每个 Agent 都会提供一个已签名的 MCP 端点;其他大模型可以租用它,账本会按次计量。
- 真实电话号码——为每个 Agent 配置一个号码(目前可自带 Twilio 号码;由 SF 管理的计量号码正在逐步推出)。
费用说明:只有在市场为你带来买家时,SeldonFrame 才会收取 5% 的 GMV 费用;通过你自己的 SeldonFrame 店铺销售时收取约 2%;其他情况一律 $0。
在任何 IDE 中操作每个客户端
一个 npm 包 — @seldonframe/mcp — 可在所有主流 AI 原生编辑器中作为本地 MCP 服务运行。选择你的编辑器,粘贴代码片段,然后让你的 Agent 一次性创建或更新客户工作区 — 网站、预约页面、接待表单、CRM 和 Agent。
Claude Code
claude mcp add seldonframe -- npx -y @seldonframe/mcp
也可以作为插件安装(自动更新,通过市场一行命令即可完成):
/plugin marketplace add seldonframe/seldonframe
/plugin install seldonframe@seldonframe
Cursor
添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"seldonframe": {
"command": "npx",
"args": ["-y", "@seldonframe/mcp"]
}
}
}
Windsurf
添加到 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"seldonframe": {
"command": "npx",
"args": ["-y", "@seldonframe/mcp"]
}
}
}
VS Code(Copilot Agent 模式)
添加到 .vscode/mcp.json:
{
"servers": {
"seldonframe": {
"command": "npx",
"args": ["-y", "@seldonframe/mcp"]
}
}
}
Zed
添加到 settings.json:
{
"context_servers": {
"seldonframe": {
"source": "custom",
"command": "npx",
"args": ["-y", "@seldonframe/mcp"]
}
}
}
Codex CLI
添加到 ~/.codex/config.toml:
[mcp_servers.seldonframe]
command = "npx"
args = ["-y", "@seldonframe/mcp"]
或者使用一行命令:codex mcp add seldonframe -- npx -y @seldonframe/mcp
连接后,重启 IDE(MCP 连接器会在会话启动时加载),然后直接这样说:
> Build a workspace for my client: [business name]. [city, state]. [services]. [phone, optional].
你也可以在 seldonframe.com/build 查看这六个保持同步的代码片段。
自托管整个项目
更愿意自行运行?整个 monorepo 采用 AGPL-3.0 许可 — 而且提供了预构建镜像,无需自行构建:
git clone https://github.com/seldonframe/seldonframe.git && cd seldonframe
cp .env.docker.example .env.docker # add your ANTHROPIC_API_KEY or OPENAI_API_KEY
docker compose -f docker-compose.yml -f docker-compose.ghcr.yml up # pulls the prebuilt image
启动 Postgres、迁移和运行于 localhost:3000 的应用 — 与托管版本使用相同的仪表板、生成的公开网站和 API。可使用多架构镜像(amd64 + arm64):ghcr.io/seldonframe/seldonframe;也可以运行 docker compose up --build 从源代码构建。请自备大模型密钥(Anthropic 或 OpenAI);短信/语音(Twilio)、电子邮件(Resend)和 1,000+ 种集成(Composio)均需自行添加密钥。完整指南:**QUICKSTART.md**。
准备好扩展业务时
你的代理机构中心是 seldonframe.com/agencies — 部署品牌化客户工作区、设置自己的客户定价,并保留总览视图。构建者仍可通过 seldonframe.com/build 发布可移植的 Agent,让其他大模型通过 MCP 租用。
定价 — 费用清晰明了
| 自托管 | $0 — AGPL-3.0,整个 monorepo · 运行 docker compose up 即可启动 |
| 构建者 | $29/mo · BYOK · 为你运营的企业提供工作区 |
| 托管版 | $49/mo · 由 SeldonFrame 管理的 AI · 一个工作区 |
| 代理机构入门版 | $99/mo · 白标 · 10 个客户工作区 · GMV 费率为 0% |
| 代理机构成长版 | $199/mo · 30 个客户工作区 · GMV 费率为 0% |
| 代理机构规模版 | $299/mo · 无限量客户工作区 · API/MCP + 市场访问权限 · GMV 费率为 0% |
| 先构建,再结账 | 免费创建第一个客户工作区,然后根据交付需求选择合适的托管方案 |
| 市场销售 | 仅当买家由市场带来时收取 5% |
技术栈
- Next.js 16(App Router)+ React 19 + TypeScript — 一个可部署的应用:仪表板、生成的公开网站和 API
- 基于 Postgres 的 Drizzle ORM(生产环境使用 Neon;自托管时可使用任意 Postgres 15+)
- Tailwind CSS 4
- pnpm workspaces + Turborepo(monorepo)
- MCP 服务 —
@seldonframe/mcp,纯 Node,可在 IDE 内本地运行 - Anthropic / OpenAI(自备密钥)· Stripe 支付 · Twilio 语音/短信 · Resend 电子邮件
贡献
这里最有价值的 PR 是Agent 模板或垂直领域技能包——合并后的模板会发布到市场,供每位 SeldonFrame 用户查找,你也可以在旁边上架自己的付费版本。核心功能、连接器和评估相关的 PR 同样欢迎。
- 先阅读 CONTRIBUTING.md,然后查看标记为
good first issue/help wanted的议题 - 项目规则:Agent 行为变更需附带评估场景;运行时变更需附带测试
社区
- 💬 Discord — 获取帮助、反馈,或只是打个招呼的最快方式
- 🐦 X 上的 @themaxthule — 发布说明、技巧和内部试用记录
- 📚 文档 — 比本 README 更深入的指南
- 🐛 议题 · 📡 讨论
- ✉️ 合作事宜:[email protected]
许可证
整个 monorepo 均采用 AGPL-3.0。可自由自托管;如果你修改了它并将其作为网络服务运行,这些修改也必须开源。如需闭源嵌入,托管方案是商业替代选择——请参阅 LICENSING.md。与 Mattermost、Plausible 和 Postiz 一样采用双重模式。
构建 Agent。出售它。获得报酬。——就在你的 IDE 中。
如果这正是你一直在寻找的平台,⭐ 为仓库点星——这有助于更多构建者发现它。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。


