# Agent-Training 提示词（极简版）

## 必读引用
@子agent/00-通用基础/base_prompt.md
@子agent/00-通用基础/essential_docs.md
@考培练系统规划/后端开发拆分策略/模块分工指南.md
@考培练系统规划/后端开发拆分策略/协作机制设计.md

## 你的角色
- 本模块职责：AI 陪练（场景/会话管理、实时对话、评估报告）
- 依赖模块：Auth、User、Course、Coze
- 对外输出：陪练会话/记录/报告 API，供 Analytics 使用

## 交付内容
- 代码：`app/api/v1/training.py`、`app/services/training_service.py`、相关 `app/models/`、`app/schemas/`
- 契约：本目录 `api_contract.yaml`（OpenAPI 3.0）
- 文档与测试：`checklist.md` 全通过，单元测试覆盖率 ≥ 80%

## 验收标准（最小集）
- API 与 `api_contract.yaml` 一致并通过基本集成测试
- 认证/权限依赖正常（读需登录，写需登录）
- 输入校验、统一异常、结构化日志符合通用规范

## 可复用资产与迁移要点
- 后端对接（复用 08-Agent-Coze 网关）
  - 训练会话创建/结束：经 `Agent-Coze` 网关落到 Coze 客户端；与本模块的场景/记录模型解耦（Training 只持久化业务字段与审计，Coze 会话 ID 作为外部引用）。
  - 语音与流式：复用 `coze-chat-backend/main.py` 的 SSE 流式实现与中断逻辑（`conversation.message.delta/completed/failed`），保持“卡片”输出兼容（如需要在陪练中输出富结果）。
  - 上传能力：复用 `upload-file` 端点与文件到 Coze 的上传流程；在本模块内记录附件元数据与权限。
- 前端可复用（`/Users/nongjun/Desktop/Ai公司/本地开发与测试/coze-chat-frontend/`）
  - 页面：`src/pages/Training/VoiceChat.tsx`、`src/pages/Training/TextChat.tsx`、`src/pages/Training/index.tsx` 可直接参考迁移；只需切换到新网关端点并接入统一鉴权。
  - Store：`src/stores/TrainingStore.ts` 的状态流转（连接/断开/中断/首个 delta 标记）、流式累计、滚动到底等逻辑可复用。
  - API：`src/server/api.ts`/`global.ts` 的会话/流式/中断接口封装；迁移时对齐为 `api_contract.yaml` 的 `POST /api/v1/training/sessions`、`POST /api/v1/training/sessions/{id}/end`，并预留 WS 能力（如需实时语音）。
- 映射建议（旧 → 新）
  - 会话创建：`POST /agent/v1/cozechat/create-conversation` → `POST /api/v1/training/sessions`
  - 会话结束：无统一端点 → `POST /api/v1/training/sessions/{id}/end`
  - 流式聊天：`POST /agent/v1/cozechat/chat-stream` 或 `/api/chat/stream` → 由网关内聚合为会话内消息事件（如扩展 `WS /ws/v1/training/{session_id}`）。
- 配置与安全
  - 使用 Auth 的 Bearer 认证；前端本地调试的 PAT 获取接口在生产禁用。
  - 复用 `COZE_API_BASE/WORKSPACE_ID` 等变量；保持 `NO_PROXY` 直连。

## 整合并入系统（当前阶段）
- 后端并入
  - 依赖 `08-Agent-Coze` 网关：Training 仅持久化训练场景/记录/报告与审计字段，引用外部 `coze_conversation_id`；对话/中断/上传经网关转发。
  - 端点以本模块 `api_contract.yaml` 为准（`POST /api/v1/training/sessions`、`POST /api/v1/training/sessions/{id}/end`、`/messages(stream)`）；旧路由由网关短期兼容。
  - 统一日志/鉴权/限流；SSE 错误映射为统一异常码。
- 前端接入
  - 将 `coze-chat-frontend` 的 Training 页面以子应用挂载至主站（如 `/training/*`），统一登录态与 API 基址到新网关。
  - 验证语音/文本陪练的 SSE 流与中断在本地正常工作。
- 验收
  - 后端端点通过集成测试；前端子应用在本地环境可稳定使用。
