Gumloop 功能规格 - Revamped Agent Builder

初始上下文

1. 概览

背景

v11.0.0 "Conche" 把 agent 页面整体重排，回答三件事：建得起来、改得动、看得清。这不是新增一块能力，而是重构"人如何与 agent 相处"的界面层。它与 v10.27 的 evals 闭环、v10.29 的 Model Router 成本智能是同一条线：agent 规模化之后，可运营性成为第一约束。

三层重构

目标

1. 起手即用：新用户不需要理解全部配置面，回答一个问题即可得到一个可运行 agent

1. 原地编辑：任何 section 都能就地展开、下钻、返回而不丢位置，消除跨 Tab 跳转

1. 配置与运营同屏：agent 花多少钱、干得好不好、干了什么，与配置面同在一个页面体系内

1. 可归因：消费可按 model / member / connector / skill / subagent 拆开，回答"这个 agent 值不值"

2. 竞品分析

3. 核心机制 [文档已验证]

3.1 四 Tab 信息架构

配置项全部收进顶部四个 Tab。只有 Owner 能看到它们；User 看到什么取决于该 agent 的 User Permissions。

┌────────────────────────────────────────────────────────────────────┐
│  重构前：六个平铺 Tab —— 改一处要来回跳，新用户面对空白 builder        │
│  [Instr][Connectors][Skills][Triggers][Access][Settings]           │
└────────────────────────────────────────────────────────────────────┘
                              │ v11.0.0 重构 ▼
┌────────────────────────────────────────────────────────────────────┐
│  重构后：四个 Tab                                                  │
│  [ Agent ]      [ Triggers ]  [ Access ]      [ Settings ]         │
│   model          app/webhook   Owners          identity            │
│   instructions   scheduled     Users           prompts             │
│   connectors     one-time      General Access  advanced AI         │
│   skills                       File Sharing    summarization       │
│   knowledge srcs               Task Visibility model fallback      │
│   subagents/secrets/abilities  Permissions     destructive         │
│  💡 Sections open in place：点 header → 全屏 + 面包屑 → 返回不丢位置 │
└────────────────────────────────────────────────────────────────────┘

model picker 与 instructions 框位于 Agent Tab 顶部，Edit Own Instructions 紧随其下；再往下是每个 building block 一个 section，各自显示条目数 + + Add。原 Settings 里的 File Sharing 移到 Access Tab，Slack 行为移到 Channels → Slack，Secrets 成为 Agent Tab 的一个 section。

3.2 Sections open in place [文档已验证]

• 点 section header（如 Connectors）→ 展开为全屏视图，带 Agent > Connectors 面包屑

• 可下钻到某 connector 的 tools，返回后不丢位置——这是"平铺 Tab 来回跳"的对症解法

• 未按 Save（Ctrl/Cmd + S）前不保存；Save 旁的箭头撤销未保存更改

3.3 Guided setup

┌──────────────────────────────────────────────────────────────────┐
│  Guided Setup — 新 agent 从一个问题开始                            │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│   ┌────────────────────────────────────────────────┐             │
│   │  What should your agent take care of?          │             │
│   └────────────────────────────────────────────────┘             │
│                        │ 用户输入一句话                           │
│                        ▼                                         │
│   ┌──────────────┬──────────────┬─────────────────┐             │
│   │ 连接正确的 app │ 自己写        │ 提供一个        │             │
│   │ (connectors) │ instructions │ trigger          │             │
│   └──────────────┴──────────────┴─────────────────┘             │
│                        │                                         │
│                        ▼                                         │
│              一个可运行的 agent（而非空白 builder）                 │
│                                                                  │
│   Profile → Preferences → [Skip guided agent setup]（默认关）      │
│   └─ 打开 → 回到旧行为，直接进完整 builder                          │
└──────────────────────────────────────────────────────────────────┘

• 全新 agent 先问 "what should it take care of"，据答案自配置，而不是直接丢进完整 builder——它据此连接正确的 app、写自己的 instructions、并提供一个 trigger

• 想每次都直接进 builder：在 Profile → Preferences 打开 Skip guided agent setup（默认关闭）

• 这是 v11 把新手引导从"文档"前移到"产品路径"本身

3.4 Performance 页整合

┌───────────────────────────────────────────────────────────────────────┐
│  Performance（agent sidebar）                                          │
├───────────────────────────────────────────────────────────────────────┤
│   [ Insights ]        [ Evaluations ]        [ Tasks ]                 │
│    花多少钱              干得好不好             干了什么                 │
│        └────────────────────┬────────────────────┘                     │
│                 Reflections / Evaluations 在此开启                       │
├───────────────────────────────────────────────────────────────────────┤
│  Insights                                                              │
│   日期范围  +  间隔 [Day|Week|Month]  +  [Compare to previous period]   │
│                                                                       │
│   Credits Over Time ── 三序列并列                                       │
│     credits ／ tasks ／ cost per task                                  │
│                                                                       │
│   overview（区间头部数字）                                              │
│     Credits · Tasks · Avg. credits/task · Members                     │
│                                                                       │
│   拆消费：by model / member / connector / skill / subagent             │
└───────────────────────────────────────────────────────────────────────┘

• 侧栏 Agent 页面新增 Performance，把 Insights / Evaluations / Tasks 三件事合流

• Insights：可选日期范围 + 间隔（Day / Week / Month） + Compare to previous period

• Credits Over Time 三序列并列（credits / tasks / cost per task）——把"花的钱涨了"与"干的活多了"分开；overview 给区间头部数字（Credits、Tasks、Avg. credits per task、Members）

• 消费可按 model / member / connector / skill / subagent 拆开

• Evaluations 与 Reflections 在 Performance 页的右侧 summary panel 中开启；可见范围遵循 agent 的 Task Visibility

3.5 侧栏导航

• agent 等待你审批工具调用时，Recents 上方出现 pending action request

3.6 同版配套 [文档已验证]

• agent 若无描述，会依据其配置与使用方式自动生成描述并保持更新；用户手写的描述永不被覆盖

• Create With AI 建触发器改为从 connector picker 起手

4. 功能需求

模块 A — 四 Tab 信息架构

模块 B — In-place section 导航

模块 C — Guided setup

模块 D — Performance 页

模块 E — 侧栏导航与配套自动化

5. 用户场景

6. 战略意义

1. 从"配置对象"到"被管理的实体"——此前 Gumloop 的能力投资集中在 agent 能做什么（Subagents / Hosted Pages / Brain）。v11.0.0 第一次系统性重构"人与 agent 的关系面"：建起来、改得动、看得清。这是 agent 平台成熟化的标志——能力已经够多，瓶颈转移到可运营性。

1. 与 evals / 成本智能是同一条线——v10.27 的 Evaluations 闭环、v10.29 的 Model Router 成本智能，加上 v11 的 Performance 页三合一：三者共同回答"agent 规模化之后怎么运营"。Performance 页把质量（Evaluations）、成本（Insights）、行为（Tasks）收进同一屏，是这条线的收口。

1. Guided setup 把新手引导产品化——Gumloop 官方一直主张"先让它干活，再让它自己写 instructions"。v11 把这个主张从文档搬进产品路径：新 agent 从一个问题起手。这降低了非技术用户的起手门槛，同时保留了"Skip guided agent setup"给懂行的用户。

1. in-place 是对"平铺配置"的正面回应——竞品普遍把配置摊平成多个页面。Gumloop 用"点 header 展开 + 面包屑 + 返回不丢位置"把配置面从"跳转"变成"下钻"。这是界面层的小改动，但直接影响"改得动不动"。

1. 描述自动化降低组织内的发现成本——agent 越多，"它到底是干嘛的"越重要。无描述的 agent 自动生成描述并保持更新，且不覆盖用户手写描述——这让 agent 列表在组织规模下仍可被理解。

7. 遥测

8. 未来演进方向

关键演进判断

1. Performance 页是"可运营性"的地基——三 Tab 合流只是第一步。真正形成闭环，需要 Performance 的结论能反向驱动配置（如"这个 agent 成本高"→ 建议换模型/调 summarization trigger）。当前重构把数据放到同一屏，下一步是让数据可行动。

1. Guided setup 是 agent 模板化的入口——目前从一句话起手。长期看，它可演化为"按角色/场景的预设模板库"，并在组织内复用已有 agent 的配置模式。这让新手引导从"通用"走向"组织感知"。

1. 描述自动化是组织级 agent 治理的前置件——agent 数量上升后，"发现与理解"成为瓶颈。自动描述 + 不覆盖手写，兼顾了规模与准确性；未来可与 Performance 结合，让描述反映"实际用途"而非"起初设定"。

1. in-place 模式可能外溢到其他配置面——一旦"点 header 展开 + 面包屑 + 返回不丢位置"在 builder 里被验证，这套交互可以推广到 Brain、Skills、Triggers 等所有配置面，成为 Gumloop 统一的配置面交互范式。

由 Claude spec-generate 系统生成 · 来源：v11.0.0 "Conche" changelog + 官方文档（docs.gumloop.com/core-concepts/agents） · 源文档存档：gumloop-docs_agents.md · gumloop-docs_agent-performance.md · gumloop-docs_profile-settings.md