Agent 工作台设计

1. 背景与目标

当前首页以自由输入和能力选择为核心。用户在不同场景下需要反复选择 MCP、Skills、浏览器等能力，尤其在固定业务场景中，这类重复配置会降低使用效率。

本方案将首页升级为 Agent 工作台：用户先选择一个场景 Agent，再进入类似当前首页的任务输入体验。Agent 负责承载固定的前置能力配置，用户不再需要每次重复勾选能力。

核心目标：

用场景 Agent 替代默认首页入口，降低用户理解和配置成本。
保留当前首页体验，作为系统内置的 新任务 入口。
将 agent_id = null 的历史会话和任务视为新任务入口的数据，无需迁移历史数据。
改造左侧栏为上下文相关导航，避免在未进入 Agent 时展示不属于当前上下文的历史记录。
尽量复用现有首页、聊天、能力选择、定时任务等组件和能力链路。

2. 核心概念

2.1 场景 Agent

场景 Agent 是用户可直接进入的工作入口，用于封装一个固定业务场景下的默认指令、MCP、Skills、浏览器和运行默认值。

场景 Agent 不等同于当前系统里的 Subagent：

概念	定位	作用
场景 Agent	用户入口和场景配置对象	定义默认指令、MCP、Skills、浏览器和运行默认值
Subagent	Poco Agent 执行过程中的委托子代理	属于能力资产，由系统执行链路使用，不在场景 Agent 中配置
新任务	系统内置 Agent	承接当前传统首页体验和 `agent_id = null` 的历史数据

2.2 新任务

新任务是一个系统内置入口，用于保留现有首页体验。这里的“新任务”是左侧导航中的入口名称，不是泛指创建一条任务记录。

新任务入口特点：

继续支持用户手动选择 MCP、Skills、Plugins 等能力。
承接所有未绑定 Agent 的历史会话、任务、定时任务结果。
实现上可将 agent_id = null 视为新任务入口的数据，无需做历史数据迁移。

2.3 Agent 配置快照

Agent 本身保存默认配置。创建会话或定时任务时，应将 Agent 当前配置固化为运行配置快照。场景 Agent 的配置范围不包含 Plugins 和 Subagents。

建议规则：

新会话默认使用 Agent 当前配置。
会话创建后保留当时的 config_snapshot，避免 Agent 后续编辑影响历史会话。
定时任务创建时也保存 Agent 配置快照。
后续可增加“同步最新 Agent 配置”能力，但不作为第一期必要功能。

3. 信息架构

新版产品入口按用户工作流组织，而不是按底层能力模块组织。

推荐顶层结构：

入口	定位	主要内容
Agent 工作台	默认首页	场景 Agent、新任务入口、运行状态、最近任务
新任务	传统首页体验	当前首页输入框、能力选择、旧历史数据
智能工作台	洞察与待办	任务洞察、待处理事项、重要产物、阻塞状态
自动化	定时与规则	定时任务、Agent 绑定任务、通知配置、运行记录
运行看板	执行监控	工作流看板、实时运行、失败或阻塞任务
能力资产	能力维护	MCP、Skills、Subagents、Plugins、Slash Commands、环境变量、记忆等

Agent 工作台首页左侧栏建议采用分组式全局轻导航，类似工作台产品的模块导航，而不是历史列表。

推荐结构：

Poco / 工作区名称

开始
- 新建 / 开始
- Agent 工作台
- 新任务

工作
- 智能工作台
- 自动化
- 运行看板

配置
- 能力资产
- 设置

该导航只出现在全局首页和需要模块切换的管理页面。进入具体 Agent 或新任务入口后，左侧栏切换为当前上下文的历史与任务列表。

4. 页面布局

4.1 Agent 工作台首页

路径建议：/home 或 /agents

Agent 工作台是用户进入系统后的默认首页。这里不展示会话历史侧栏，也不展示定时任务历史列表。左侧栏保留分组式全局轻导航，用于进入新任务、智能工作台、自动化、运行看板、能力资产等模块。

页面内容：

顶部操作区
搜索 Agent
新建 Agent
新任务入口
筛选：全部、运行中、有定时任务、最近使用
正在运行
展示当前有运行中任务、等待确认、失败状态的 Agent
常用 Agent
展示最近使用或用户固定的 Agent
全部 Agent
展示所有已启用或可见 Agent

Agent 卡片建议展示：

Agent 名称
一句话场景说明
能力摘要，例如 MCP 3 · Skills 5 · 浏览器
状态：空闲、运行中、失败、等待确认
最近会话标题
下次定时运行时间
快捷操作：进入、新对话、编辑

新任务入口建议作为固定特殊卡片展示，文案强调“不绑定场景 Agent，可手动选择能力并直接开始任务”。

4.2 Agent 启动页

路径建议：/agents/:agentId

点击某个 Agent 后进入该 Agent 的启动页。该页面应尽量复用当前首页布局，而不是做复杂的 Agent 专属工作台。

页面结构：

顶部：Agent 名称、描述、状态、编辑入口
中间：复用当前首页输入区
输入区能力：
保留任务输入
保留附件上传
保留仓库配置
保留浏览器和定时入口
隐藏 MCP、Skills 的手动选择区域
发送任务时自动带入当前 Agent 的固定配置
下方可轻量展示该 Agent 最近会话，但不抢占主输入流程

核心原则：

用户进入 Agent 后，只需要输入任务。
能力配置由 Agent 自动提供。
当前首页组件应参数化复用，避免重新实现一套入口。

4.3 新任务页

路径建议：/agents/free 或 /home/free

新任务页复用当前首页体验：

展示当前首页输入区
展示能力选择区域
支持用户临时选择 MCP、Skills、Plugins 等能力
左侧栏展示 agent_id = null 的历史会话和任务

新任务页是旧数据和旧交互的自然承接点，不需要历史迁移。

4.4 Agent 编辑页

路径建议：/agents/:agentId/edit

Agent 编辑页用于维护该 Agent 的场景定义和默认能力配置。

建议分区：

基本信息

名称
描述
图标或颜色
启用状态

默认指令

场景说明
行为边界
输出偏好

能力配置

MCP
Skills
浏览器实现

运行默认值

默认仓库或项目
浏览器开关
工作台排除设置
记忆策略

自动化

用当前 Agent 创建定时任务
查看已绑定的定时任务

5. 左侧栏设计规则

左侧栏需要从“全局历史列表”改为“上下文相关导航”。

5.1 Agent 工作台首页

在未进入具体 Agent 前，左侧栏展示分组式全局轻导航，不展示任务历史、项目历史、定时任务结果。

推荐结构：

Poco / 工作区名称

开始
- 新建 / 开始
- Agent 工作台
- 新任务

工作
- 智能工作台
- 自动化
- 运行看板

配置
- 能力资产
- 设置

原因：

用户尚未选择工作上下文。
历史记录应属于某个 Agent 或新任务入口。
首页需要提供清晰的模块入口，但不应混入具体工作上下文的历史。
默认展示历史列表会破坏“先选场景，再开始工作”的心智。

5.2 Agent 内页

进入具体 Agent 后，左侧栏只服务当前 Agent，不展示公共轻导航。

推荐结构：

← Agent 工作台
当前 Agent 名称
[ + 新对话 ]

运行中
- 会话 A

最近对话
- 会话 B
- 会话 C

定时任务结果
- 任务 D

失败 / 待确认
- 会话 E

原则：

不展示智能工作台、自动化、能力资产等公共入口。
公共模块切换通过返回 Agent 工作台完成。
左侧栏只回答当前 Agent 下“有哪些历史、哪些任务正在跑、哪些需要处理”。

5.3 新任务

新任务左侧栏展示未绑定 Agent 的历史数据。

推荐结构：

← Agent 工作台
新任务
[ + 新对话 ]

全部历史
项目
定时任务结果

5.4 其他模块

进入智能工作台、自动化、运行看板、能力资产时，左侧栏不展示聊天历史，也不强制沿用 Agent 工作台首页的完整导航。

可按模块需要展示自己的筛选、分类或二级导航：

智能工作台：状态、优先级、时间范围、主题分类
自动化：定时任务、运行记录、通知配置
运行看板：运行状态、来源、用户或团队筛选
能力资产：MCP、Skills、Subagents、Plugins、环境变量、记忆等分类

6. 组件复用策略

第一期应优先复用当前已有组件。

建议抽象一个通用启动页组件：

LaunchPage
任务输入
附件上传
仓库配置
浏览器配置
定时任务入口
发送逻辑

两种模式复用：

模式	配置来源	是否展示能力选择
新任务	用户当前临时选择	是
Agent 模式	Agent Profile 固定配置	否

现有能力选择器、定时任务能力配置、聊天状态栏等逻辑应尽量复用，不做重复实现。

7. 数据归属建议

建议新增 Agent Profile 作为一等业务对象。

核心字段建议：

id
user_id
name
description
instructions
config_snapshot（仅保存场景 Agent 支持的默认配置，不包含 Plugins 和 Subagents）
enabled
icon
color
created_at
updated_at

会话和运行记录建议增加：

agent_id
agent_config_snapshot 或复用 run/session 的 config_snapshot

数据归属规则：

agent_id = null：视为新任务入口的数据。
agent_id = free 不一定需要真实落库，可以在服务层或前端层映射。
新建 Agent 会话时写入对应 agent_id。
Agent 下历史列表只查询该 Agent 的会话和任务。
新任务历史列表查询 agent_id is null。

8. 自动化与 Agent 的关系

定时任务应支持绑定 Agent。

建议规则：

从 Agent 页创建定时任务时，默认继承当前 Agent 配置。
定时任务保存创建时的 Agent 配置快照。
Agent 后续编辑不自动影响已有定时任务，避免任务行为不可追溯。
后续可提供“同步 Agent 最新配置到定时任务”的显式操作。

自动化入口不应和能力资产混在一起。定时任务是用户工作流的一部分，应归入“自动化”。

9. 能力资产重排

能力资产页用于维护底层能力，不再作为用户开始工作的主入口。

建议分类：

系统能力概览
MCP 连接
Skills
Subagents
Plugins
Slash Commands
环境变量
记忆管理
发布中心
通知配置

能力资产页的目标是回答：

当前有哪些系统能力可供运行链路或新任务入口使用？
哪些能力启用、失效或缺少配置？
如何新增、测试、维护能力？

说明：

场景 Agent 第一期不可配置 Plugins 和 Subagents。
Plugins 和 Subagents 仍保留在能力资产中，作为系统底层能力维护入口。
新任务入口仍可保留现有能力选择体验，具体可选能力范围沿用当前实现。

10. MVP 范围

第一期建议只做最小闭环：

新增 Agent Profile。
将新版首页改为 Agent 工作台。
保留新任务入口，agent_id = null 视为新任务历史。
Agent 启动页复用当前首页输入体验。
Agent 模式隐藏能力选择，发送任务时自动带入 Agent 支持的固定配置。
左侧栏按路由切换上下文：

工作台首页展示分组式全局轻导航，不展示历史。
Agent 内页展示当前 Agent 历史。
新任务入口展示旧历史。

定时任务支持从 Agent 配置创建。

暂不做：

多 Agent 编排画布。
Agent Team。
历史数据真实迁移。
Agent 配置自动同步到所有历史任务。

11. 后续扩展方向

后续可以在不推翻当前设计的基础上扩展：

多个 Agent 组合成 Agent Team。
将 Agent 作为工作流节点。
从优秀会话一键生成 Agent。
从当前会话同步能力配置回 Agent。
Agent 级统计：运行次数、成功率、成本、平均耗时。
Agent 模板市场。
团队共享 Agent。

12. 设计结论

本方案的核心原则是：

首页用于选择工作场景。
Agent 页面用于开始任务。
Agent 工作台首页左侧栏展示分组式全局轻导航，不展示历史。
进入 Agent 或新任务入口后，左侧栏只展示当前上下文的历史。
新任务入口承接传统体验和旧数据。
能力资产只负责维护底层能力，不作为普通用户开始工作的主入口。

这样可以在保留现有功能的前提下，把用户心智从“每次选择能力”转为“直接进入场景工作”。

On this page