LingQue Studio · 智能体平台逐页优化与AI编程提示词（整合版）

0）全局先打穿：跨页面的一致闭环与性能底座

体验闭环（全站统一）

• 统一顶部动作区：全局搜索（智能体/工作流/会话/日志/知识/工具）+ 命令面板（⌘K）+ “新建”主按钮（智能体/工作流/知识/工具/测试）。
• 统一空状态：每个列表页空状态必须带：①原因提示 ②一键创建 ③导入/从模板 ④示例数据 ⑤权限申请入口。
• 统一长任务体验：发布/评测/索引/回放等一律进入“任务中心”（右下角任务抽屉查看进度、失败重试、日志、产物）。
• 统一错误兜底：鉴权失败→申请权限；网络失败→重试/离线缓存；依赖缺失→一键补齐（缺模型/缺知识库/缺工具）。

性能底座（全站统一）

• 列表页：虚拟滚动 + 增量分页 + 骨架屏 + 请求去重/缓存（SWR/React Query）+ 预取下一屏
• 编辑器：按需加载（Monaco/Flow画布拆包）+ 本地草稿 + 差量保存 + 防抖校验
• 可观测：前端埋点（TTFB/LCP/INP/错误率）+ 关键动作漏斗（创建→配置→测试→发布→调用→复盘）

你是资深前端架构+体验设计+性能优化工程师。目标：把一个企业级智能体平台做到极致体验/极致性能/极致闭环。
约束：不改变业务语义；新增统一的“命令面板⌘K、任务中心、全局搜索、统一空状态、统一错误兜底、统一埋点”。
请输出：
1) 路由与信息架构调整方案（不破坏现有入口）
2) 组件与状态管理方案（列表/编辑器/长任务/权限）
3) 性能策略（拆包、预取、缓存、虚拟滚动、长任务WebSocket推送）
4) 埋点事件字典 + 漏斗（按模块）
5) 分阶段PR计划（每阶段可上线、可回滚）
技术栈按当前项目实现；如未知请用 React+TS 举例并保持可迁移。

1）工作台

定位：每天开工第一屏（我该做什么 / 系统是否健康 / 最近产出如何）。

闭环：异常发现→定位（链路/日志/会话）→修复（工作流/智能体/知识）→回归测试→发布。

优化点

• 三块必备：①我的待办（失败任务/待发布/待审批）②业务看板（调用量、成功率、成本、P95延迟）③快捷入口（新建/导入/回放/评测）。
• “一键续航”：最近编辑的智能体/工作流支持继续编辑，从中断点回到画布。
• 异常卡片直达：点击失败率飙升→带过滤条件跳到“链路追踪/执行日志”。

你是前端架构+体验设计+性能优化工程师。为“工作台”实现一个以行动为中心的首页：
- 模块：我的待办/关键指标/最近使用/系统异常/快速创建
- 每个卡片都必须可点击跳转到对应页面，并携带过滤参数
- 指标支持最近24h/7d切换，展示趋势与阈值告警
- 性能：首屏<1s可交互；数据并发请求、缓存、骨架屏；异常卡片延迟加载
- 埋点：dashboard_view、cta_click、metric_drilldown、task_resume
输出组件结构、接口定义、路由参数规范、埋点点位。

2）智能体列表

定位：资产总览 + 生命周期管理（草稿→测试→发布→运行→复盘）。

闭环：创建/导入→配置→测试中心验证→发布→会话/链路观测→迭代。

优化点

• 列表信息密度：状态（草稿/已发布/告警）、最近调用、成功率、成本、版本号、负责人、标签。
• 顶部强过滤：环境（Dev/Prod）、状态、标签、负责人、最近更新；支持保存视图。
• 行内动作闭环：测试、发布、回放最近会话、查看链路、复制为模板。
• 空状态：一键“从模板市场创建”“导入JSON”“从会话回放生成智能体”。

重做“智能体列表”为强运营的资产页：
- 列表：虚拟滚动+可配置列；支持保存视图；支持批量操作（打标签/切环境/下线/导出）
- 行内动作：测试(跳测试中心预填)、发布(含校验与回滚)、回放(跳会话记录)、观测(跳链路追踪)
- 状态机：draft/testing/published/deprecated/error；展示原因与修复入口
- 性能：分页+缓存+预取详情；首屏骨架；搜索防抖
- 埋点：agent_list_view、filter_apply、agent_action_click、publish_success/fail
输出：数据模型、接口、状态机、组件与交互细节。

3）工作流编排

定位：复杂任务可视化编排、调试、版本与发布。

闭环：画布编辑→节点校验→单步调试→跑测试集→发布→线上观测→回滚。

优化点

• 编辑体验：自动布局/对齐、快捷键、节点模板、连线校验、局部运行。
• 调试闭环：右侧调试面板输入样例、一键跑到某节点、查看中间变量、失败重试。
• 版本闭环：diff、变更说明、灰度发布、回滚按钮常驻。

为“工作流编排”实现：画布编辑+调试+版本发布闭环。
要求：
- 节点支持 schema 定义输入输出；连线时做类型校验与错误提示
- 调试：单步/断点/查看中间变量/导出调试快照
- 版本：保存草稿、发布版本、diff、回滚、灰度发布配置
- 性能：画布大图（>500节点）不卡；按需渲染；web worker 处理布局/校验
输出：核心数据结构、校验规则、调试协议、版本API与UI交互。

4）模板市场

定位：增长入口，降低冷启动成本。

闭环：发现→试用→一键创建→绑定资源（模型/知识/工具）→跑样例→发布。

优化点

• 模板必须带“可运行演示”（无需配置就能跑一条样例）。
• 安装向导：缺模型/缺知识库/缺工具时，一键创建或选择已有资源。
• 模板评分维度：效果、成本、延迟、适用场景；支持“复制并改造”。

实现“模板市场”：
- 列表/详情：搜索、分类、行业场景、成本/延迟/效果标签
- 一键试用：在沙箱环境创建临时实例并跑通示例
- 安装向导：自动检测缺失依赖（模型/知识/工具/MCP），提供一键补齐
- 安装后自动跳转到智能体/工作流并打开“下一步清单”
输出：依赖解析逻辑、向导流程、沙箱策略、埋点漏斗。

5）会话记录（Beta）

定位：产品真实使用证据 + 复盘素材。

闭环：检索会话→回放→定位失败点→生成测试用例→修复→验证→再发布。

优化点

• 回放可定位：智能体版本/工作流版本/模型版本/知识快照。
• 一键生成：该会话转成测试用例（输入、期望、断言点）。
• 对话内标注：好/坏样本、原因标签，沉淀到评测集。

实现“会话记录”闭环：
- 支持按时间/用户/智能体/版本/结果过滤；全文检索
- 会话回放：展示每轮的模型调用、工具调用、检索证据、耗时与成本
- 一键：生成测试用例、加入评测集、跳转链路追踪定位
- 权限：敏感字段脱敏与审计
输出：数据模型、回放UI、生成测试用例的规则与API。

6）执行日志

定位：工程排障第一入口（比会话更底层）。

闭环：筛选异常→查看上下文→关联链路→一键重试/回滚→验证。

优化点

• 结构化日志：按 request_id/trace_id 聚合；支持 JSON 展开、字段筛选。
• 一键动作：重试该次执行（同输入与版本）、导出诊断包。
• 与链路追踪互跳：日志里点 trace_id 直达链路。

实现“执行日志”：
- 结构化日志表格：字段选择、快速过滤、JSON展开、错误堆栈友好展示
- 聚合视图：按 trace_id 聚合，显示关键阶段耗时与错误点
- 一键重试：复用当次输入与版本，创建任务并在任务中心跟踪
- 性能：大数据量虚拟滚动+后端游标分页
输出：查询DSL、前端组件、与任务中心/链路的联动。

7）链路追踪（New）

定位：端到端可观测（LLM/检索/工具/工作流每段耗时与错误）。

闭环：发现慢/错→定位段→回放输入→修复配置→压测/评测→上线验证。

优化点

• 瀑布图 + 关键指标：耗时、token、成本、命中率、工具错误码。
• 对比能力：两条链路对比（同输入不同版本）。
• 诊断建议：超时/高成本给建议动作（缓存、并行、剪枝）。

实现“链路追踪”页面：
- trace瀑布图：可折叠节点（模型/检索/工具/工作流），展示耗时、token、成本、状态
- 支持对比两个trace；支持从trace生成性能报告
- 提供诊断建议（规则引擎）：慢点/错误点/高成本点→建议与一键跳转修复入口
- 与日志/会话互跳，参数保持一致
输出：trace数据结构、渲染策略、对比算法、诊断规则与埋点。

8）测试中心

定位：发布门禁。

闭环：导入用例→评测→看报告→定位失败（会话/链路）→修复→复测→准入发布。

优化点

• 三类测试：功能回归（断言）、质量评测（打分）、性能压测（延迟/成本）。
• 报告可追溯：失败用例→trace→版本diff。
• 准入策略：阈值（成功率≥X、P95≤Y、成本≤Z），否则阻止发布。

实现“测试中心”发布门禁：
- 支持创建评测集（手工/从会话生成/导入CSV）
- 运行评测：并发控制、进度、失败重试；结果可按维度聚合
- 报告：失败用例→一键跳链路追踪；对比两个版本
- 发布门禁：阈值策略+审批流接口
输出：评测任务模型、报告页面、门禁规则引擎与UI。

9）知识库

定位：RAG 资产与检索质量闭环。

闭环：导入→切分/索引→检索评测→线上命中监控→低质样本回收→重建索引。

优化点

• 导入向导：格式识别、去重、权限、增量更新、失败重试。
• 检索质量面板：命中率、无答案率、TopK覆盖；失败样本一键加入评测集。
• 可回滚：索引版本/切分策略版本。

实现“知识库”全链路：
- 导入/同步：支持多数据源；增量更新；失败重试；处理进度进任务中心
- 索引策略：切分/embedding/过滤字段可配置，保存为版本
- 检索评测：给定query集，输出命中率/覆盖率/证据质量，并可回放
输出：索引任务、版本管理、评测与线上监控联动方案。

10）工具箱

定位：工具能力资产化（函数、HTTP、DB、脚本等）。

闭环：创建工具→本地调试→绑定智能体/工作流→线上监控→失败回放→修复版本。

优化点

• 工具必须有：schema、示例、错误码、超时/重试策略、权限配置。
• 一键生成 mock：方便在测试中心跑回归。

实现“工具箱”：
- 工具定义：输入输出schema、鉴权、超时重试、速率限制、错误码
- 调试台：传参运行、查看请求响应、mock生成、保存用例
- 版本：发布/回滚；引用该工具的智能体/工作流受影响提示
输出：工具元数据模型、调试台UI、版本与引用分析实现。

11）MCP 服务

定位：外部能力接入与治理（连接器/权限/配额）。

闭环：接入→健康检查→授权→被引用→调用监控→异常隔离。

优化点

• 服务健康：心跳、延迟、错误率；熔断/降级策略可配置。
• 权限视图：谁在用（智能体/工作流）、用到哪些方法。

实现“MCP服务”治理台：
- 服务注册/配置：endpoint、认证、方法列表、配额
- 健康检查与告警：错误率/延迟阈值，支持熔断与降级
- 引用分析：列出使用该服务的智能体/工作流与版本
输出：治理数据模型、健康检查任务、告警与熔断策略UI。

12）提示词库

定位：Prompt 资产化与版本治理。

闭环：编写→单测（示例）→AB对比→发布→线上漂移监控→回滚。

优化点

• Prompt 组件化：变量、片段复用、lint、敏感词/注入检测。
• Diff & 回滚：像代码一样。

实现“提示词库”：
- 支持模板变量、片段引用、lint规则（长度/格式/敏感词/注入风险提示）
- 支持示例用例运行与对比（两个版本输出差异）
- 版本发布与回滚；并展示哪些智能体/工作流引用
输出：prompt DSL、lint规则、对比视图、引用关系图实现。

13）模型接入

定位：多模型/多供应商接入与路由。

闭环：接入→连通性测试→成本/延迟基准→路由策略→线上监控→自动降级。

优化点

• 一键连通性测试：鉴权、限流、流式、函数调用能力检查。
• 成本与延迟基准：用固定评测集跑一遍，生成选型报告。

实现“模型接入”：
- 支持新增供应商/密钥/模型列表；连通性测试（流式、工具调用、最大上下文）
- 路由策略：按场景选择模型、失败自动fallback、成本上限
- 监控：调用量、失败率、P95、token成本；告警与自动降级
输出：连接测试用例、路由策略配置、监控面板与告警规则。

14）SOTA 榜单

定位：内部评测与对标，驱动迭代。

闭环：选择任务→跑评测→榜单排名→回看失败用例→修复→再跑。

实现“SOTA榜单”：
- 支持按任务/数据集/指标维度展示排行榜
- 每个条目可下钻到评测报告与失败样本回放
- 支持对比两条方案（版本/模型/提示词）并生成改进建议
输出：榜单数据模型、下钻路径、对比视图与埋点。

15）订阅计划

定位：企业计费/配额/成本可控。

闭环：查看用量→预警→扩容/降配→成本归因→优化建议。

实现“订阅计划/用量”：
- 展示额度、当月用量、预测超额、成本归因（到租户/应用/模型）
- 支持阈值预警与自动限流策略
- 给出降本建议（规则：高成本链路、低命中RAG、过高TopK等）
输出：计量口径、前端展示与告警/限流配置方案。

16）租户管理

定位：企业多租户、空间隔离、配额与成员。

闭环：创建租户→配置资源→邀请成员→分配权限→审计→回收。

实现“租户管理”：
- 租户列表/详情：成员、角色、资源配额、环境隔离
- 邀请与权限：最小权限默认；支持权限申请流程
- 资源回收与导出
输出：RBAC模型、权限申请流程、审计联动点。

17）审计日志

定位：合规与追责。

闭环：谁在何时做了什么→影响哪些资源→导出→告警。

实现“审计日志”：
- 记录关键操作（发布/删库/改权限/接入密钥等），支持过滤与导出
- 每条日志展示影响范围（资源ID、版本、租户）
- 支持敏感操作告警
输出：审计事件字典、展示UI、导出与告警实现。

18）API 管理

定位：开发者入口（密钥、SDK、回调、限流、示例）。

闭环：创建Key→拿示例跑通→看调用监控→定位错误（链路/日志）→优化。

实现“API管理”开发者中心：
- API Key：创建/轮换/禁用；权限范围；IP白名单；限流配置
- 文档：可复制示例（curl/JS/Python），一键生成代码片段
- 调用监控：成功率、延迟、错误码分布；一键跳链路追踪
输出：Key管理流程、示例生成器、监控与互跳参数规范。