common_agent/docs/前端实现文档/5.Agent会话模块前端实现.md

Agent 会话模块前端实现

1. 页面

AgentWorkspacePage.vue 当前展示 Agent 对话调试、引用切片、运行追踪和成本延迟指标。

2. ViewModel

AgentWorkspaceView 建议包含：

• 当前 Agent 基本信息。
• 当前会话消息列表。
• 输入框状态。
• 引用切片列表。
• 模型请求 ID。
• 运行追踪步骤。
• 成本、延迟和 Token 统计。

3. 接口草案

• POST /api/agents/{agentId}/runs
• GET /api/agents/{agentId}/sessions
• GET /api/agent-sessions/{sessionId}
• POST /api/agent-sessions/{sessionId}/messages

现有 POST /api/agents/{agentId}/chat 保留为兼容调试入口。

4. 交互规则

• RAG 开关关闭时不展示引用切片。
• 未召回知识切片时给出明确提示。
• 模型调用失败时展示 request_id 和错误摘要。
• 会话保存失败不得清空用户输入。