108 lines
4.8 KiB
Markdown
108 lines
4.8 KiB
Markdown
# Implementation Plan: Coze AI Integration
|
||
|
||
## Overview
|
||
|
||
本实现计划将重构AiChatServiceImpl，添加通用的Coze工作流调用方法，并优化EpicScriptServiceImpl#createScript接口以调用Coze AI生成剧本内容。实现采用增量方式，每个任务都建立在前一个任务的基础上。
|
||
|
||
## Tasks
|
||
|
||
- [x] 1. 扩展AiConfigService接口和实现
|
||
- [x] 1.1 在AiConfigService接口中添加getByConfigKey方法
|
||
- 添加方法签名：`AiConfig getByConfigKey(String configKey)`
|
||
- 添加方法级注释说明功能和参数
|
||
- _Requirements: 5.1_
|
||
- [x] 1.2 在AiConfigServiceImpl中实现getByConfigKey方法
|
||
- 使用LambdaQueryWrapper查询config_key匹配且is_enabled=1的配置
|
||
- 返回查询结果，不存在则返回null
|
||
- _Requirements: 1.2, 5.1, 5.2_
|
||
|
||
- [x] 2. 扩展AiChatService接口
|
||
- [x] 2.1 在AiChatService接口中添加callWorkflowByConfigKey方法
|
||
- 添加方法签名：`String callWorkflowByConfigKey(String configKey, String input, String userId)`
|
||
- 添加重载方法：`String callWorkflowByConfigKey(String configKey, Map<String, Object> parameters, String userId)`
|
||
- 添加方法级注释说明功能、参数和返回值
|
||
- _Requirements: 1.1, 1.4_
|
||
|
||
- [x] 3. 实现通用工作流调用方法
|
||
- [x] 3.1 在AiChatServiceImpl中实现callWorkflowByConfigKey方法
|
||
- 调用aiConfigService.getByConfigKey获取配置
|
||
- 验证配置存在且启用，否则抛出异常
|
||
- 构建工作流请求（workflow_id, user_id, stream=true, parameters.input）
|
||
- 设置请求头（Authorization, Content-Type）
|
||
- _Requirements: 1.2, 1.3, 1.6, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6_
|
||
- [x] 3.2 实现流式响应处理方法
|
||
- 解析SSE格式响应（event:和data:行）
|
||
- 提取event为Message且node_type为End的content
|
||
- 从content的JSON中提取output字段
|
||
- 处理Done事件完成流处理
|
||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||
- [x] 3.3 实现错误处理逻辑
|
||
- 处理配置不存在/禁用的情况
|
||
- 处理API调用失败（非200状态码）
|
||
- 处理流式解析失败
|
||
- 确保错误消息不包含敏感信息
|
||
- _Requirements: 1.6, 3.5, 6.1, 6.2, 6.4, 6.5_
|
||
- [x] 3.4 编写Property 1属性测试：请求格式正确性
|
||
- **Property 1: Request Format Correctness**
|
||
- **Validates: Requirements 2.1, 2.2, 2.3, 2.4, 2.5, 2.6**
|
||
- [x] 3.5 编写Property 2属性测试：流式响应解析
|
||
- **Property 2: Stream Response Parsing**
|
||
- **Validates: Requirements 3.1, 3.2, 3.3**
|
||
|
||
- [x] 4. Checkpoint - 验证通用AI调用服务
|
||
- 确保所有测试通过，如有问题请询问用户
|
||
|
||
- [x] 5. 实现爽文剧本AI生成
|
||
- [x] 5.1 在EpicScriptServiceImpl中添加输入组装方法
|
||
- 创建assembleScriptInput方法
|
||
- 将EpicScriptCreateRequest的字段组装为格式化字符串
|
||
- 包含title, theme, style, length, plotIntro, plotTurning, plotClimax, plotEnding
|
||
- _Requirements: 4.2_
|
||
- [x] 5.2 修改createScript方法调用AI生成
|
||
- 调用assembleScriptInput组装输入
|
||
- 调用aiChatService.callWorkflowByConfigKey("coze.course.life.generate", input, userId)
|
||
- 解析AI返回的内容并存储到EpicScript实体
|
||
- 处理AI调用失败的情况
|
||
- _Requirements: 4.1, 4.3, 4.4, 4.5_
|
||
- [x] 5.3 编写Property 3属性测试：输入组装完整性
|
||
- **Property 3: Input Assembly Completeness**
|
||
- **Validates: Requirements 4.2**
|
||
|
||
- [x] 6. 实现配置参数合并
|
||
- [x] 6.1 实现custom_params合并逻辑
|
||
- 解析AiConfig.customParams JSON字符串
|
||
- 将custom_params与运行时参数合并
|
||
- 运行时参数优先级高于custom_params
|
||
- _Requirements: 5.3_
|
||
- [x] 6.2 实现超时和重试配置
|
||
- 应用AiConfig.timeoutMs设置
|
||
- 实现基于retry_count和retry_delay_ms的重试逻辑
|
||
- _Requirements: 5.4, 5.5, 6.3_
|
||
- [x] 6.3 编写Property 4属性测试：配置应用正确性
|
||
- **Property 4: Configuration Application**
|
||
- **Validates: Requirements 1.3, 5.2, 5.3**
|
||
|
||
- [x] 7. 完善错误处理和日志
|
||
- [x] 7.1 完善错误消息格式
|
||
- 确保错误消息包含config_key和状态码
|
||
- 确保不暴露API token等敏感信息
|
||
- 添加详细的日志记录
|
||
- _Requirements: 6.1, 6.2, 6.4, 6.5_
|
||
- [x] 7.2 编写Property 5属性测试：错误消息质量
|
||
- **Property 5: Error Message Quality**
|
||
- **Validates: Requirements 6.4, 6.5**
|
||
|
||
- [x] 8. Final Checkpoint - 确保所有测试通过
|
||
- 运行所有单元测试和属性测试
|
||
- 确保所有测试通过，如有问题请询问用户
|
||
|
||
## Notes
|
||
|
||
- All tasks are required for comprehensive implementation
|
||
- Each task references specific requirements for traceability
|
||
- Checkpoints ensure incremental validation
|
||
- Property tests validate universal correctness properties
|
||
- Unit tests validate specific examples and edge cases
|
||
- 实现语言：Java (Spring Boot)
|
||
- 测试框架：JUnit 5
|