初始上下文

产品/团队
Gumloop / AI Agent 平台
功能
Hosted Pages for Agents — 为 Agent 生成独立公开聊天界面
描述
每个 Gumloop Agent 可开启一个专属的公开聊天页面(`{alias}.gumloopagents.com`),外部用户无需进入 Gumloop 构建器即可与 Agent 对话。Agent 使用聊天者自己的凭据和集成,而非 Agent 创建者的凭据
动机
此前分享 Agent 意味着分享构建器访问权(含配置、导航、侧边栏)。企业需要一种"纯聊天"的分发方式——让客户、合作伙伴、团队成员直接使用 Agent 而不接触平台复杂性
目标用户与痛点
(1) 需要给客户提供自助服务 Agent 的团队 (2) 需要跨组织协作但不想开放构建器权限的场景 (3) 希望将 Agent 作为"产品"对外交付的开发者
平台范围
Web 端(响应式,兼容移动端浏览器)
关键成功指标
Hosted Page 开启率、外部用户会话数、通过 Hosted Page 的重复使用率

1. 概览

背景

Gumloop v9.8.0 发布 Hosted Pages for Agents,让 Agent 拥有专属的 gumloopagents.com 子域名。这解决了一个根本性的分发问题:此前 Gumloop 中分享 Agent 意味着将用户带入构建器界面——包含侧边栏、配置面板、导航等与"使用 Agent"无关的界面元素。这对于只想使用 Agent 的外部用户来说体验不佳。

Hosted Pages 剥离了所有非必要的平台界面,提供"独立的、无干扰的聊天界面"。Agent 创建者只需开启 Hosted Page 并分享 URL,访问者登录后即可直接与 Agent 对话。

关键设计决策:

目标

  1. 简化 Agent 分发:分享一个 URL 即可让他人使用 Agent,无需引导用户了解平台
  1. 降低使用门槛:访问者只需登录即可开始对话,无需学习构建器操作
  1. 安全隔离:凭据和信用隔离确保 Agent 创建者不会为使用者的操作承担风险

2. 竞品分析

竞品 功能/行为 优势 劣势 洞察/机会
ChatGPT GPT Store GPT 公开发布 + 独立聊天页面 发现机制完善 仅限 OpenAI 生态 独立域名 > 平台内页面
Claude Projects 项目内共享对话 团队协作流畅 无公开发布能力 Hosted Pages 填补了"对外交付"缺口
Slack Bot 通过 Slack 对外提供 Agent 用户习惯 Slack 界面 依赖 Slack 平台 Hosted Pages 是"自有界面"方案
Custom Chat Widget(如 Intercom) 嵌入网站的聊天组件 灵活嵌入 需开发集成 Hosted Pages 是零代码替代方案
Zapier Chatbots 基于 Zap 的聊天机器人 + 公开链接 与自动化深度绑定 功能较基础 Gumloop Agent 能力更强(工具调用、多步推理)

关键洞察:

  1. 分发 vs 构建:Gumloop 的产品哲学是"构建在平台内,分发到平台外"。Hosted Pages 是这个哲学的体现——构建器是给专家用的,聊天界面是给所有人用的
  1. 凭据归属是关键差异化:大多数竞品使用"创建者凭据"模式(所有访问者共享同一组凭据)。Gumloop 使用"访问者凭据"模式——这更安全但要求访问者有 Gumloop 账户
  1. 无自定义域名是当前短板:仅支持 `gumloopagents.com` 子域名,不支持自定义域名。对于希望白标交付的企业客户,这是一个限制

3. 用户场景与故事

场景 1 — 数据分析师:为客户提供自助数据查询 Agent

用户画像: 张敏,32 岁,电商公司数据分析师。管理 15 个 VIP 客户的销售数据。客户经常问"上个月我的销售额是多少?""哪些产品卖得最好?"

用户故事: 作为数据分析师,我希望将我的 Sales Data Agent 发布为 Hosted Page 并分享给客户,以便客户可以自己查询数据而不用每次都找我。

验收标准:

场景 2 — HR 经理:为候选人提供入职咨询 Agent

用户画像: 王婷,35 岁,HR 经理。希望提供一个 24/7 自动回答入职问题的 Agent 给新员工。

用户故事: 作为 HR 经理,我希望新员工通过一个简单的链接就能与 Onboarding Agent 对话,询问薪资、福利、IT 设置等问题,而不需要给他们开 Gumloop 平台权限。

场景 3 — 独立开发者:将 Agent 作为 SaaS 产品交付

用户画像: 王磊,35 岁,独立开发者。构建了一个专业的数据分析 Agent,希望以订阅方式提供给客户使用。

用户故事: 作为开发者,我希望通过 Hosted Page 将我的 Agent 交付给付费客户,客户不需要了解 Gumloop 平台本身。


4. 用户流程与功能

模块 A:Hosted Page 配置(创建者视角)

ID 触发场景 系统行为 优先级
A1 Agent 创建者点击侧边栏「Hosted Page」 显示 Hosted Page 配置面板 P0
A2 创建者点击「Enable Hosted Page」 系统基于 Agent 名称自动生成 URL 别名(如 `my-agent.gumloopagents.com`),立即生效 P0
A3 创建者编辑 URL 别名 校验规则:3-64 字符、仅小写字母/数字/连字符、全局唯一。保留别名(reserved words)不可用:admin, api, app, auth, beta, docs, gumstack, help, localhost, mcp, sandbox, staging, support, ws, www P0
A4 创建者点击「Disable Hosted Page」 URL 立即不可访问。别名保留,重新开启时可复用(除非已被其他 Agent 占用) P0

模块 B:访问与认证(访问者视角)

ID 触发场景 系统行为 优先级
B1 访问者打开 Hosted Page URL 页面加载 Agent 信息(名称、图标、工具列表),提示登录 P0
B2 访问者完成认证 通过安全代理流程签发一次性会话令牌,重定向回聊天界面。凭据不经过托管子域名 P0
B3 访问者没有 Gumloop 账户 登录流程中自动引导创建账户 P0
B4 访问者缺少 Agent 所需的集成连接 提示访问者连接对应集成(如 Gmail、Salesforce),否则 Agent 无法代表其操作 P1

模块 C:聊天界面

ID 触发场景 系统行为 优先级
C1 访问者发送消息 Agent 正常响应,使用访问者自己的凭据和集成 P0
C2 Agent 调用 MCP 工具 工具使用聊天者的已连接账户,非创建者账户 P0
C3 对话产生信用消耗 信用从聊天者账户扣除(团队 Agent 从共享信用池扣除,外部用户从个人余额扣除) P0
C4 访问者查看对话历史 仅可查看自己的对话。Owner/Editor/Viewer(工作区成员)可查看所有对话 P1

模块 D:权限与可见性

ID 触发场景 系统行为 优先级
D1 访问者需要访问 Hosted Page 必须至少有 Use-Only 权限:可通过直接分享、工作区成员身份或组织级访问获得 P0
D2 创建者管理 Hosted Page 设置 仅 Owner/Editor 拥有 `manage_hosting` 权限,可开启/关闭/修改别名 P0
D3 组织管理员施加额外限制 可通过 App Rules 对 Hosted Pages 设置组织级约束 P2

模块 E:界面限制

Hosted Page 有意隐藏以下功能:


4.25. 核心页面交互示意

页面 1:创建者视角 — 开启 Hosted Page

┌─────────────────────────────────────────────────────────────┐
│  ⚙️ Agent Settings  >  Sales Data Agent                     │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─ External Channels ─────────────────────────────────┐   │
│  │  📧 Email Inbox     ······  [Configure]              │   │
│  │  💬 Slack           ······  [Configure]              │   │
│  │  🌐 Hosted Page     ······  [Configure]  ←           │   │
│  └──────────────────────────────────────────────────────┘   │
│                                                             │
│  ┌─ Hosted Page ───────────────────────────────────────┐   │
│  │                                                     │   │
│  │  Status: ⬤ Enabled                                  │   │
│  │                                                     │   │
│  │  URL:  sales-data.gumloopagents.com    [✏️ Edit]    │   │
│  │        ─────────────────────────────                │   │
│  │        ✓ 3-64 characters                            │   │
│  │        ✓ Lowercase letters, numbers, hyphens only   │   │
│  │        ✓ Globally unique                            │   │
│  │                                                     │   │
│  │  [📋 Copy URL]  [🔗 Share]  [Disable Hosted Page]   │   │
│  │                                                     │   │
│  │  ┌─ Preview ───────────────────────────────────┐   │   │
│  │  │  ┌──────────────────────────────────────┐   │   │
│  │  │  │  🤖 Sales Data Agent                 │   │   │
│  │  │  │  📊 Web Search · Snowflake · Gmail   │   │   │
│  │  │  │  ─────────────────────────────────   │   │   │
│  │  │  │  Hello! I can help you analyze       │   │   │
│  │  │  │  your sales data. What would you     │   │   │
│  │  │  │  like to know?                       │   │   │
│  │  │  │                                      │   │   │
│  │  │  │  ╔══════════════════════════════╗    │   │   │
│  │  │  │  ║  Type a message...           ║    │   │   │
│  │  │  │  ╚══════════════════════════════╝    │   │   │
│  │  │  └──────────────────────────────────────┘   │   │
│  │  └─────────────────────────────────────────────┘   │
│  └─────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

页面 2:访问者视角 — 公开聊天界面

┌─────────────────────────────────────────────────────────────┐
│  🤖 Sales Data Agent                                       │
│  📊 Connected: Web Search · Snowflake · Gmail               │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Hello! I can help you analyze your sales data.             │
│  What would you like to know?                               │
│                                                             │
│  ─────────────────────────────────────────────────────────  │
│                                                             │
│  👤 What were my top 5 products by revenue last month?      │
│                                                             │
│  🤖 Let me check your Snowflake data...                     │
│                                                             │
│     Here are your top 5 products by revenue for April:      │
│                                                             │
│     ┌──────────────────────────────────────────┐           │
│     │  #  Product         Revenue    Growth    │           │
│     │  1  Widget Pro      $340,000   +12%      │           │
│     │  2  Widget Basic    $280,000   +8%       │           │
│     │  3  Widget Plus     $195,000   +15%      │           │
│     │  4  Widget Lite     $120,000   +3%       │           │
│     │  5  Widget Max      $95,000    +22%      │           │
│     └──────────────────────────────────────────┘           │
│                                                             │
│  ─────────────────────────────────────────────────────────  │
│                                                             │
│  ╔══════════════════════════════════════════════════════╗   │
│  ║  Type a message...                                  ║   │
│  ╚══════════════════════════════════════════════════════╝   │
│                                                             │
│  💡 Powered by Gumloop                                     │
└─────────────────────────────────────────────────────────────┘

页面 3:访问者认证流程

┌─────────────────────────────────────────────────────────────┐
│  sales-data.gumloopagents.com                               │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │                                                     │   │
│  │       🤖 Sales Data Agent                           │   │
│  │                                                     │   │
│  │       Sign in to start chatting                     │   │
│  │                                                     │   │
│  │       ┌─────────────────────────────────────┐       │   │
│  │       │  [Continue with Gumloop]            │       │   │
│  │       └─────────────────────────────────────┘       │   │
│  │                                                     │   │
│  │       🔒 Authentication uses a secure broker        │   │
│  │          flow — credentials never pass through       │   │
│  │          the hosted subdomain directly               │   │
│  │                                                     │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
└─────────────────────────────────────────────────────────────┘

4.5. 流程图

flowchart TD
    Start([Agent 创建者]) --> Enable[开启 Hosted Page]
    Enable --> GenURL[系统基于 Agent 名称
自动生成 URL 别名] GenURL --> Customize{自定义别名?} Customize -->|是| Edit[编辑别名
校验唯一性+规则] Customize -->|否| Share[分享 URL] Edit --> Valid{校验通过?} Valid -->|是| Share Valid -->|否| Edit Share --> Visitor[访问者打开 URL] Visitor --> Auth{已登录 Gumloop?} Auth -->|否| SignIn[Gumloop 认证流程
无账户则自动创建] SignIn --> Auth Auth -->|是| Token[签发一次性会话令牌
重定向回聊天界面] Token --> CheckPerm{有访问权限?} CheckPerm -->|否| Denied[提示无权限] CheckPerm -->|是| CheckIntegration{所需集成
已连接?} CheckIntegration -->|否| PromptConnect[提示连接集成] CheckIntegration -->|是| Chat[开始对话] PromptConnect --> Chat Chat --> Credits[信用从聊天者账户扣除] Chat --> Creds[使用聊天者自己的凭据]

5. 遥测

漏斗阶段 事件名称 触发条件 指标/KPI 目的 优先级
采用 `hosted_page_enabled` 创建者开启 Hosted Page 开启数/日 衡量功能采用 P0
采用 `hosted_page_first_visit` 外部用户首次访问 Hosted Page 独立访客数 衡量分发触达 P0
使用 `hosted_page_session_started` 访问者完成认证并开始对话 会话数/日 衡量实际使用 P0
使用 `hosted_page_message_sent` 访问者发送消息 消息数/会话 衡量对话深度 P1
质量 `hosted_page_auth_failed` 访问者认证失败 失败率+原因 监控认证流程 P1
留存 `hosted_page_repeat_visitor` 同一访问者 7 天内再次访问 重复访问率 衡量价值持续性 P1

6. 路线图与未来演进方向

阶段 时间线 里程碑 状态
Phase 1 — 基础托管 v9.8.0 独立聊天界面 + 认证 + 凭据隔离 ✅ 已发布
Phase 2 — 增强分发 v10.x 自定义域名(白标)、嵌入组件(iframe/JS SDK)、免登录访问选项 ⬜ 规划中
Phase 3 — 个性化 v11.x 自定义品牌(Logo、配色、欢迎语)、多语言界面、Agent 选择器(一个页面多个 Agent) ⬜ 探索中
Phase 4 — 商业化 未来 Hosted Page 使用分析面板、按使用量计费、Agent 应用市场 ⬜ 探索中

关键演进判断

  1. 自定义域名是白标交付的前提:要让企业客户将 Agent 作为自己的产品交付,`gumloopagents.com` 域名是不够的。这是当前功能的最大限制
  1. 免登录访问存在安全与便利的权衡:目前所有访问者必须有 Gumloop 账户。免登录访问可以大幅降低门槛,但会引入凭据管理的复杂性(Agent 应使用谁的凭据?)
  1. 嵌入能力可以打开更大的分发渠道:如果能将 Hosted Page 嵌入到客户自己的网站或产品中,Agent 就从"独立页面"变成"嵌入式功能"

由 Claude spec-generate 系统生成 · 来源:Gumloop Hosted Pages 帮助文档 · Gumloop v9.8.0 Changelog