docs: 明确工作台 Agent 调用测试口径

2026-06-15 01:44:53 +00:00
parent 311a662588
commit f3693bfd77
1 changed files with 4 additions and 3 deletions
@@ -31,12 +31,13 @@

 Web工作台负责 HWLAB 登录后的浏览器主入口，使用户能够在同一 Web 工作面完成会话选择、任务输入、执行状态理解、结果查看和必要诊断。

-D601 v0.3 当前已具备 Vue 版 Cloud Web shell、登录后工作台路由、会话列表、对话消息区、命令输入区、topbar 诊断入口、侧栏折叠和移动端单栏布局。本课题在该实现基线上定义后续工作台体验的稳定预期：主任务入口优先、诊断信息低噪声、状态反馈及时、桌面和移动端都能直接找到输入区。
+本课题的目标状态是：主任务入口优先、诊断信息低噪声、状态反馈及时、桌面和移动端都能直接找到输入区，并且用户可以从基本工作台发起最小 Agent 调用并获得可查询执行状态。

 ### 2.2 范围内

 - 登录后 Cloud Web shell、topbar、导航、工作台路由、页面切换反馈和同源 API 状态展示。
 - 会话列表、当前 conversation、用户消息、Agent 消息、命令输入区、发送、引导、取消、重试和 pending 状态展示。
+- 基本工作台 Agent 调用，包括最小任务输入、发送、短返回执行标识、状态查询入口和失败原因展示。
 - 工作台诊断入口、运行状态摘要、probe/build/HWPOD/Agent 状态的低噪声展示方式。
 - 桌面多栏布局、侧栏折叠、移动端工作台布局和输入区可达性。
 - Web 入口对用户管理、Agent编排、硬件池、HarnessRL 和平台运维输出事实的展示契约。
@@ -101,9 +102,9 @@ Web工作台应提供登录后的稳定 shell，使用户能够在同一浏览
 | --- | --- | --- | --- |
 | CLIENT-WB-REQ-002 | 会话输入 | PJ2026-01040102 会话输入 | [Agent编排](PJ2026-0102-agent-orchestration.md)、[用户管理](PJ2026-0105-user-management.md) |

-Web工作台应让用户在主任务区直接选择或创建会话、阅读用户和 Agent 消息、输入任务、引导运行中任务，并看到发送、取消、重试和 pending 状态。
+Web工作台应让用户在主任务区直接选择或创建会话、阅读用户和 Agent 消息、输入任务、发起基本 Agent 调用、引导运行中任务，并看到发送、取消、重试和 pending 状态。

-会话输入只负责用户可见的交互和消息呈现。Agent session、trace、thread、workspace 和终态事实由 Agent编排提供；用户权限和会话有效性由用户管理提供。单条用户消息、trace 详情或状态摘要不得在默认视图中抢占主任务区，使用户难以继续输入。
+会话输入只负责用户可见的交互和消息呈现。基本 Agent 调用必须进入 Agent编排提供的执行生命周期，并返回用户可查询的 run、command、session 或等价状态入口；用户权限和会话有效性由用户管理提供。单条用户消息、trace 详情或状态摘要不得在默认视图中抢占主任务区，使用户难以继续输入。

 ### 6.3 CLIENT-WB-REQ-003 诊断反馈