后端 - AI 能力接入

liyupi · liyupi · commit cd832f3dd82c · 2025-09-09T21:51:32.000+08:00
&#23454;&#29616; AI &#29983;&#25104;&#32467;&#26524;&#25253;&#21578;&#21151;&#33021;
diff --git a/AI_INTEGRATION_GUIDE.md b/AI_INTEGRATION_GUIDE.md
@@ -15,9 +15,9 @@
 - &#25903;&#25345;&#36890;&#36807;&#37197;&#32622;&#25991;&#20214;&#21160;&#24577;&#37197;&#32622;&#27169;&#22411;&#21442;&#25968;
 
 ### 2. AI &#26381;&#21153;&#25509;&#21475;
-- `LevelGenerationAiService`&#65306;&#20851;&#21345;&#29983;&#25104;&#26381;&#21153;
-- `ResultReportAiService`&#65306;&#32467;&#26524;&#25253;&#21578;&#29983;&#25104;&#26381;&#21153;
-- &#20351;&#29992; `@SystemMessage` &#21644; `@UserMessage` &#27880;&#35299;&#23450;&#20041;&#25552;&#31034;&#35789;
+- `LevelGenerationAiService`&#65306;&#20851;&#21345;&#29983;&#25104;&#26381;&#21153;&#65292;&#20351;&#29992;&#31616;&#21333;&#30340;&#34218;&#36164;&#21442;&#25968;
+- `ResultReportAiService`&#65306;&#32467;&#26524;&#25253;&#21578;&#29983;&#25104;&#26381;&#21153;&#65292;&#25509;&#25910;&#25340;&#25509;&#22909;&#30340;&#29992;&#25143;&#28040;&#24687;
+- &#20351;&#29992; `@SystemMessage` &#24341;&#20837;&#25552;&#31034;&#35789;&#25991;&#20214;&#65292;`@UserMessage` &#25509;&#25910;&#19994;&#21153;&#23618;&#25340;&#25509;&#30340;&#28040;&#24687;
 
 ### 3. &#26381;&#21153;&#23454;&#29616;&#31867;&#38598;&#25104;
 - `LevelServiceImpl`&#65306;&#38598;&#25104;&#20851;&#21345;&#29983;&#25104; AI &#26381;&#21153;&#65292;&#21253;&#21547;&#38477;&#32423;&#22788;&#29702;
@@ -118,14 +118,19 @@ mvn test -Dtest=AiServiceTest
    - &#19981;&#35201;&#23558; API Key &#25552;&#20132;&#21040;&#20195;&#30721;&#20179;&#24211;
 
 2. **&#27169;&#22411;&#36873;&#25321;**&#65306;
-   - &#24403;&#21069;&#20351;&#29992; `qwen-max` &#27169;&#22411;&#20197;&#33719;&#24471;&#26368;&#20339;&#25928;&#26524;
-   - &#21487;&#26681;&#25454;&#25104;&#26412;&#32771;&#34385;&#35843;&#25972;&#20026; `qwen-turbo` &#25110;&#20854;&#20182;&#27169;&#22411;
+   - &#24403;&#21069;&#20351;&#29992; `qwen-plus` &#27169;&#22411;&#24179;&#34913;&#25928;&#26524;&#21644;&#25104;&#26412;
+   - &#21487;&#26681;&#25454;&#38656;&#27714;&#35843;&#25972;&#20026; `qwen-max`&#65288;&#26356;&#22909;&#25928;&#26524;&#65289;&#25110; `qwen-turbo`&#65288;&#26356;&#20302;&#25104;&#26412;&#65289;
 
-3. **&#38169;&#35823;&#22788;&#29702;**&#65306;
+3. **&#28040;&#24687;&#25340;&#25509;**&#65306;
+   - `@UserMessage` &#27880;&#35299;&#19981;&#25903;&#25345;&#22810;&#21442;&#25968;&#27169;&#26495;
+   - &#22312;&#19994;&#21153;&#23618;&#20351;&#29992; Java &#27169;&#26495;&#23383;&#31526;&#20018; (`String.format("""...""")`) &#25340;&#25509;&#22797;&#26434;&#28040;&#24687;
+   - &#36825;&#26679;&#21487;&#20197;&#26356;&#28789;&#27963;&#22320;&#25511;&#21046;&#28040;&#24687;&#26684;&#24335;&#21644;&#20869;&#23481;
+
+4. **&#38169;&#35823;&#22788;&#29702;**&#65306;
    - &#25152;&#26377; AI &#35843;&#29992;&#37117;&#26377;&#38477;&#32423;&#26426;&#21046;
    - &#26085;&#24535;&#35760;&#24405;&#35814;&#32454;&#30340;&#38169;&#35823;&#20449;&#24687;&#20415;&#20110;&#35843;&#35797;
 
-4. **&#24615;&#33021;&#20248;&#21270;**&#65306;
+5. **&#24615;&#33021;&#20248;&#21270;**&#65306;
    - AI &#35843;&#29992;&#21487;&#33021;&#36739;&#24930;&#65292;&#24314;&#35758;&#22312;&#21069;&#31471;&#28155;&#21152;&#21152;&#36733;&#25552;&#31034;
    - &#32771;&#34385;&#28155;&#21152;&#32531;&#23384;&#26426;&#21046;&#20943;&#23569;&#37325;&#22797;&#35843;&#29992;
 
diff --git a/src/main/java/com/yupi/codertestbackend/service/ai/ResultReportAiService.java b/src/main/java/com/yupi/codertestbackend/service/ai/ResultReportAiService.java
@@ -10,17 +10,12 @@
 public interface ResultReportAiService {
 
     /**
-     * &#26681;&#25454;&#20851;&#21345;&#20449;&#24687;&#21644;&#29992;&#25143;&#20316;&#31572;&#29983;&#25104;&#32467;&#26524;&#25253;&#21578;
+     * &#26681;&#25454;&#25340;&#25509;&#22909;&#30340;&#29992;&#25143;&#28040;&#24687;&#29983;&#25104;&#32467;&#26524;&#25253;&#21578;
      * 
-     * @param levelName &#20851;&#21345;&#21517;&#31216;
-     * @param levelDesc &#20851;&#21345;&#38656;&#27714;&#25551;&#36848;
-     * @param userOptions &#29992;&#25143;&#36873;&#25321;&#30340;&#36873;&#39033;&#65288;JSON&#23383;&#31526;&#20018;&#65289;
-     * @param trueOptions &#26412;&#20851;&#21345;&#30340;&#27491;&#30830;&#36873;&#39033;&#65288;JSON&#23383;&#31526;&#20018;&#65289;
-     * @param salary &#29992;&#25143;&#24403;&#21069;&#34218;&#36164;
+     * @param userMessage &#25340;&#25509;&#22909;&#30340;&#29992;&#25143;&#28040;&#24687;&#20869;&#23481;
      * @return &#29983;&#25104;&#30340;&#32467;&#26524;&#25253;&#21578;
      */
     @SystemMessage(fromResource = "prompts/result-report-system.txt")
-    @UserMessage("### &#20851;&#21345;&#21517;&#31216;\n{{levelName}}\n\n## &#20851;&#21345;&#30340;&#38656;&#27714;&#25551;&#36848;\n{{levelDesc}}\n\n## &#29992;&#25143;&#36873;&#25321;&#30340;&#36873;&#39033;\n{{userOptions}}\n\n### &#26412;&#20851;&#21345;&#30340;&#27491;&#30830;&#36873;&#39033;\n{{trueOptions}}\n\n### &#29992;&#25143;&#24403;&#21069;&#30340;&#34218;&#36164;\n{{salary}}")
-    ResultReportResponse generateResultReport(String levelName, String levelDesc, 
-                                            String userOptions, String trueOptions, Integer salary);
+    @UserMessage("{{userMessage}}")
+    ResultReportResponse generateResultReport(String userMessage);
 }
diff --git a/src/main/java/com/yupi/codertestbackend/service/impl/UserLevelServiceImpl.java b/src/main/java/com/yupi/codertestbackend/service/impl/UserLevelServiceImpl.java
@@ -64,15 +64,32 @@ public UserLevel submitAnswer(SubmitAnswerRequest submitAnswerRequest, String us
             // 1. &#35299;&#26512;&#20851;&#21345;&#30340;&#27491;&#30830;&#31572;&#26696;
             List<String> trueOptions = extractTrueOptions(level.getOptions());
             
-            // 2. &#35843;&#29992;AI&#29983;&#25104;&#35814;&#32454;&#30340;&#32467;&#26524;&#25253;&#21578;
-            ResultReportResponse aiResponse = resultReportAiService.generateResultReport(
+            // 2. &#25340;&#25509;&#29992;&#25143;&#28040;&#24687;&#24182;&#35843;&#29992;AI&#29983;&#25104;&#35814;&#32454;&#30340;&#32467;&#26524;&#25253;&#21578;
+            String userMessage = String.format("""
+                ### &#20851;&#21345;&#21517;&#31216;
+                %s
+                
+                ## &#20851;&#21345;&#30340;&#38656;&#27714;&#25551;&#36848;
+                %s
+                
+                ## &#29992;&#25143;&#36873;&#25321;&#30340;&#36873;&#39033;
+                %s
+                
+                ### &#26412;&#20851;&#21345;&#30340;&#27491;&#30830;&#36873;&#39033;
+                %s
+                
+                ### &#29992;&#25143;&#24403;&#21069;&#30340;&#34218;&#36164;
+                %d
+                """, 
                 level.getLevelName(),
                 level.getLevelDesc(),
                 JSONUtil.toJsonStr(userOptions),
                 JSONUtil.toJsonStr(trueOptions),
                 user.getSalary()
             );
             
+            ResultReportResponse aiResponse = resultReportAiService.generateResultReport(userMessage);
+            
             // 3. &#23558;AI&#21709;&#24212;&#36716;&#25442;&#20026;UserLevel&#23454;&#20307;
             UserLevel userLevel = new UserLevel();
             userLevel.setUserId(userId);
diff --git a/src/test/java/com/yupi/codertestbackend/service/ai/AiServiceTest.java b/src/test/java/com/yupi/codertestbackend/service/ai/AiServiceTest.java
@@ -58,17 +58,34 @@ void testResultReportGeneration() {
         try {
             log.info("&#24320;&#22987;&#27979;&#35797;&#32467;&#26524;&#25253;&#21578;&#29983;&#25104;&#26381;&#21153;...");
             
-            // &#27169;&#25311;&#27979;&#35797;&#25968;&#25454;
+            // &#27169;&#25311;&#27979;&#35797;&#25968;&#25454;&#24182;&#25340;&#25509;&#29992;&#25143;&#28040;&#24687;
             String levelName = "&#27979;&#35797;&#20851;&#21345;";
             String levelDesc = "&#36825;&#26159;&#19968;&#20010;&#27979;&#35797;&#20851;&#21345;&#25551;&#36848;";
             String userOptions = "[\"&#36873;&#39033;1\", \"&#36873;&#39033;2\"]";
             String trueOptions = "[\"&#36873;&#39033;1\", \"&#36873;&#39033;3\"]";
             Integer salary = 10000;
             
-            ResultReportResponse response = resultReportAiService.generateResultReport(
+            String userMessage = String.format("""
+                ### &#20851;&#21345;&#21517;&#31216;
+                %s
+                
+                ## &#20851;&#21345;&#30340;&#38656;&#27714;&#25551;&#36848;
+                %s
+                
+                ## &#29992;&#25143;&#36873;&#25321;&#30340;&#36873;&#39033;
+                %s
+                
+                ### &#26412;&#20851;&#21345;&#30340;&#27491;&#30830;&#36873;&#39033;
+                %s
+                
+                ### &#29992;&#25143;&#24403;&#21069;&#30340;&#34218;&#36164;
+                %d
+                """, 
                 levelName, levelDesc, userOptions, trueOptions, salary
             );
             
+            ResultReportResponse response = resultReportAiService.generateResultReport(userMessage);
+            
             log.info("&#32467;&#26524;&#25253;&#21578;&#29983;&#25104;&#25104;&#21151;:");
             log.info("&#24471;&#20998;: {}", response.getScore());
             log.info("&#35780;&#20215;: {}", response.getComment());

-Original file line number
+Diff line change
 - 支持通过配置文件动态配置模型参数
 ### 2. AI 服务接口
 -- `LevelGenerationAiService`：关卡生成服务
 -- `ResultReportAiService`：结果报告生成服务
 -- 使用 `@SystemMessage` 和 `@UserMessage` 注解定义提示词
 +- `LevelGenerationAiService`：关卡生成服务，使用简单的薪资参数
 +- `ResultReportAiService`：结果报告生成服务，接收拼接好的用户消息
 +- 使用 `@SystemMessage` 引入提示词文件，`@UserMessage` 接收业务层拼接的消息
 ### 3. 服务实现类集成
 - `LevelServiceImpl`：集成关卡生成 AI 服务，包含降级处理
    - 不要将 API Key 提交到代码仓库
 . **模型选择**：
 -   - 当前使用 `qwen-max` 模型以获得最佳效果
 -   - 可根据成本考虑调整为 `qwen-turbo` 或其他模型
 +   - 当前使用 `qwen-plus` 模型平衡效果和成本
 +   - 可根据需求调整为 `qwen-max`（更好效果）或 `qwen-turbo`（更低成本）
 -3. **错误处理**：
 +3. **消息拼接**：
 +   - `@UserMessage` 注解不支持多参数模板
 +   - 在业务层使用 Java 模板字符串 (`String.format("""...""")`) 拼接复杂消息
 +   - 这样可以更灵活地控制消息格式和内容
++
 +4. **错误处理**：
    - 所有 AI 调用都有降级机制
    - 日志记录详细的错误信息便于调试
 -4. **性能优化**：
 +5. **性能优化**：
    - AI 调用可能较慢，建议在前端添加加载提示
    - 考虑添加缓存机制减少重复调用
-Original file line number
+Diff line change
 public interface ResultReportAiService {
     /**
 -     * 根据关卡信息和用户作答生成结果报告
 +     * 根据拼接好的用户消息生成结果报告
+     *
 -     * @param levelName 关卡名称
 -     * @param levelDesc 关卡需求描述
 -     * @param userOptions 用户选择的选项（JSON字符串）
 -     * @param trueOptions 本关卡的正确选项（JSON字符串）
 -     * @param salary 用户当前薪资
 +     * @param userMessage 拼接好的用户消息内容
      * @return 生成的结果报告
      */
     @SystemMessage(fromResource = "prompts/result-report-system.txt")
 -    @UserMessage("### 关卡名称\n{{levelName}}\n\n## 关卡的需求描述\n{{levelDesc}}\n\n## 用户选择的选项\n{{userOptions}}\n\n### 本关卡的正确选项\n{{trueOptions}}\n\n### 用户当前的薪资\n{{salary}}")
 -    ResultReportResponse generateResultReport(String levelName, String levelDesc,
 -                                            String userOptions, String trueOptions, Integer salary);
 +    @UserMessage("{{userMessage}}")
 +    ResultReportResponse generateResultReport(String userMessage);
+}