前端对接边界

前端细节暂不在本篇展开，只约定后端接口与事件契约，避免前后端各自推断运行状态。

页面与接口映射

前端能力	后端入口
Agent 列表与编辑	/v1/agent
聊天窗口	/v1/chatbot
执行步骤和效果监控	/v1/logs、轨迹接口和运行状态接口
LLM 模型配置	/v1/llm-model
Skill 管理	/v1/skill、/v1/skill-repository
文件浏览器	/v1/files/rooms

流式事件约定

前端应按事件类型渲染 token、节点进度、工具调用、Artifact、错误和完成状态；不要把所有事件当作纯文本拼接。断线重连需要携带 sessionId，并处理服务端的待发送事件和重复事件。

暂不纳入本轮

具体 Vue 组件、路由、状态管理和视觉规范另行维护。本轮只建立后端接口分组和事件语义，为前端文档后续补充留下稳定锚点。