feat(agent): 新增智能体管理及相关功能支持（需执行upgrades/v1.1.0相关SQL）

Author: magestacks

bootstrap/src/main/java/com/nageoffer/ai/ragent/audit/constant/BizChangeBizType.java

@@ -17,6 +17,10 @@
 
 package com.nageoffer.ai.ragent.audit.constant;
 
+import lombok.AccessLevel;
+import lombok.NoArgsConstructor;
+
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
 public final class BizChangeBizType {
 
     public static final String KNOWLEDGE_BASE = "KNOWLEDGE_BASE";
@@ -28,7 +32,5 @@ public final class BizChangeBizType {
     public static final String QUERY_TERM_MAPPING = "QUERY_TERM_MAPPING";
     public static final String SAMPLE_QUESTION = "SAMPLE_QUESTION";
     public static final String USER = "USER";
-
-    private BizChangeBizType() {
-    }
+    public static final String AGENT_PROFILE = "AGENT_PROFILE";
 }

bootstrap/src/main/java/com/nageoffer/ai/ragent/rag/config/DemoModeProperties.java

@@ -26,7 +26,7 @@
  */
 @Data
 @Configuration
-@ConfigurationProperties(prefix = "app")
+@ConfigurationProperties(prefix = "ragent")
 public class DemoModeProperties {
 
     /**

bootstrap/src/main/java/com/nageoffer/ai/ragent/rag/config/OrchestrationMode.java

@@ -0,0 +1,53 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.nageoffer.ai.ragent.rag.config;
+
+import cn.hutool.core.util.StrUtil;
+
+/**
+ * 执行架构档位，由 ragent.engine.type 指定
+ * <p>
+ * 属部署级决策（切换需重启，且 AGENT 依赖外部 ReAct 服务存活），因此不开放后台切换
+ */
+public enum OrchestrationMode {
+
+    /**
+     * v1 编排管线：意图分类 → 检索 → 合成，链路确定、延迟低
+     */
+    WORKFLOW,
+
+    /**
+     * v2 ReAct 架构：主 Agent 决策，RAG 管线降级为其中一个 Tool
+     */
+    AGENT;
+
+    /**
+     * 解析配置值，大小写不敏感，无法识别时回落 WORKFLOW
+     */
+    public static OrchestrationMode of(String value) {
+        if (StrUtil.isBlank(value)) {
+            return WORKFLOW;
+        }
+        for (OrchestrationMode mode : values()) {
+            if (mode.name().equalsIgnoreCase(value.trim())) {
+                return mode;
+            }
+        }
+        return WORKFLOW;
+    }
+}

bootstrap/src/main/java/com/nageoffer/ai/ragent/rag/config/OrchestrationProperties.java

@@ -0,0 +1,41 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.nageoffer.ai.ragent.rag.config;
+
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * 执行架构配置
+ * 不挂在 rag 下：AGENT 档里 RAG 管线只是主 Agent 的一个 Tool，档位在语义上包含 RAG 而非从属于它
+ */
+@Data
+@Configuration
+@ConfigurationProperties(prefix = "ragent.engine")
+public class OrchestrationProperties {
+
+    /**
+     * 档位取值，可选 workflow（默认）/ agent，大小写不敏感
+     */
+    private String type = "workflow";
+
+    public OrchestrationMode getMode() {
+        return OrchestrationMode.of(type);
+    }
+}

bootstrap/src/main/java/com/nageoffer/ai/ragent/rag/constant/RAGConstant.java

@@ -79,35 +79,20 @@ public class RAGConstant {
      */
     public static final String GUIDANCE_AMBIGUITY_CHECK_PROMPT_PATH = "prompt/guidance-ambiguity-check.st";
 
-    /**
-     * 系统对话提示词模板路径
-     * 定义企业知识助手「小码」的角色设定和对话规则，包括打招呼、自我介绍、问题分类处理等场景。模板通过 {@code {question}} 占位符接收用户问题。
-     */
-    public static final String CHAT_SYSTEM_PROMPT_PATH = "prompt/answer-chat-system.st";
 
     /**
      * 查询改写 + 多问句拆分提示词模板路径
      * 要求同时返回改写后的单条查询和子问题列表
      */
     public static final String QUERY_REWRITE_AND_SPLIT_PROMPT_PATH = "prompt/user-question-rewrite.st";
 
-    /**
-     * 对话记忆压缩提示词模板路径
-     * 通过 {@code {summary_max_chars}} 控制摘要长度上限
-     */
-    public static final String CONVERSATION_SUMMARY_PROMPT_PATH = "prompt/conversation-summary.st";
 
     /**
      * 会话标题生成提示词模板路径
      * 通过 {@code {title_max_chars}} 与 {@code {question}} 控制标题长度与输入问题
      */
     public static final String CONVERSATION_TITLE_PROMPT_PATH = "prompt/conversation-title.st";
 
-    /**
-     * 默认 RAG 问答提示词模板路径
-     * 用于指导大模型基于检索到的文档内容进行准确回答，包含严格的事实性约束和链接处理规则
-     */
-    public static final String RAG_ENTERPRISE_PROMPT_PATH = "prompt/answer-chat-kb.st";
 
     /**
      * 知识资料回答的行内引用规则
@@ -128,23 +113,8 @@ public class RAGConstant {
      */
     public static final String MCP_PARAMETER_EXTRACT_USER_PROMPT_PATH = "prompt/mcp-parameter-extract-user.st";
 
-    /**
-     * MCP-only 场景提示词模板路径
-     * 仅动态数据片段时使用
-     */
-    public static final String MCP_ONLY_PROMPT_PATH = "prompt/answer-chat-mcp.st";
 
-    /**
-     * MCP + KB 混合场景提示词模板路径
-     * 兼顾动态数据片段与知识库内容的综合回答
-     */
-    public static final String MCP_KB_MIXED_PROMPT_PATH = "prompt/answer-chat-mcp-kb-mixed.st";
 
-    /**
-     * 推荐追问问题生成提示词模板路径
-     * 通过 {@code {question}}、{@code {answer}}、{@code {count}} 注入问答与生成数量
-     */
-    public static final String RECOMMENDED_QUESTIONS_PROMPT_PATH = "prompt/recommended-questions.st";
 
     // ==================== 上下文格式化模板（单文件多 section） ====================
 

bootstrap/src/main/java/com/nageoffer/ai/ragent/rag/controller/AgentProfileController.java

@@ -0,0 +1,114 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.nageoffer.ai.ragent.rag.controller;
+
+import com.nageoffer.ai.ragent.framework.convention.Result;
+import com.nageoffer.ai.ragent.framework.web.Results;
+import com.nageoffer.ai.ragent.rag.controller.request.AgentProfileSaveRequest;
+import com.nageoffer.ai.ragent.rag.controller.request.AgentPromptSaveRequest;
+import com.nageoffer.ai.ragent.rag.controller.vo.AgentProfileListVO;
+import com.nageoffer.ai.ragent.rag.controller.vo.AgentPromptConfigVO;
+import com.nageoffer.ai.ragent.rag.service.AgentProfileAdminService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ * 智能体管理控制器
+ */
+@RestController
+@RequiredArgsConstructor
+public class AgentProfileController {
+
+    private final AgentProfileAdminService agentProfileAdminService;
+
+    /**
+     * 查询智能体列表
+     */
+    @GetMapping("/agents")
+    public Result<AgentProfileListVO> list() {
+        return Results.success(agentProfileAdminService.list());
+    }
+
+    /**
+     * 创建智能体
+     */
+    @PostMapping("/agents")
+    public Result<String> create(@RequestBody AgentProfileSaveRequest requestParam) {
+        return Results.success(agentProfileAdminService.create(requestParam));
+    }
+
+    /**
+     * 更新智能体名称与描述
+     */
+    @PutMapping("/agents/{id}")
+    public Result<Void> update(@PathVariable String id, @RequestBody AgentProfileSaveRequest requestParam) {
+        agentProfileAdminService.update(id, requestParam);
+        return Results.success();
+    }
+
+    /**
+     * 删除智能体
+     */
+    @DeleteMapping("/agents/{id}")
+    public Result<Void> delete(@PathVariable String id) {
+        agentProfileAdminService.delete(id);
+        return Results.success();
+    }
+
+    /**
+     * 激活智能体，立即对全部会话生效
+     */
+    @PostMapping("/agents/{id}/activate")
+    public Result<Void> activate(@PathVariable String id) {
+        agentProfileAdminService.activate(id);
+        return Results.success();
+    }
+
+    /**
+     * 查询该智能体的槽位配置，含槽位元数据与当前架构下的生效判定
+     */
+    @GetMapping("/agents/{id}/prompts")
+    public Result<AgentPromptConfigVO> prompts(@PathVariable String id) {
+        return Results.success(agentProfileAdminService.loadPrompts(id));
+    }
+
+    /**
+     * 保存单个槽位，内容留空即恢复回落内置智能体
+     */
+    @PutMapping("/agents/{id}/prompts/{slotKey}")
+    public Result<Void> savePrompt(@PathVariable String id,
+                                   @PathVariable String slotKey,
+                                   @RequestBody AgentPromptSaveRequest requestParam) {
+        agentProfileAdminService.savePrompt(id, slotKey, requestParam);
+        return Results.success();
+    }
+
+    /**
+     * 查询内置智能体的槽位内容，供「从默认复制」
+     */
+    @GetMapping("/agents/prompt-slots/{slotKey}/default")
+    public Result<String> defaultPrompt(@PathVariable String slotKey) {
+        return Results.success(agentProfileAdminService.defaultPrompt(slotKey));
+    }
+}

bootstrap/src/main/java/com/nageoffer/ai/ragent/rag/controller/request/AgentProfileSaveRequest.java

@@ -0,0 +1,36 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.nageoffer.ai.ragent.rag.controller.request;
+
+import lombok.Data;
+
+/**
+ * 智能体新建与改名请求
+ */
+@Data
+public class AgentProfileSaveRequest {
+
+    private String name;
+
+    private String description;
+
+    /**
+     * 头像预设标识，由前端从预设表中挑选
+     */
+    private String avatar;
+}

bootstrap/src/main/java/com/nageoffer/ai/ragent/rag/controller/request/AgentPromptSaveRequest.java

@@ -0,0 +1,29 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.nageoffer.ai.ragent.rag.controller.request;
+
+import lombok.Data;
+
+/**
+ * 单个槽位提示词保存请求，内容留空即恢复回落内置智能体
+ */
+@Data
+public class AgentPromptSaveRequest {
+
+    private String content;
+}