Merge pull request #493 from lyingbug/main

Custom Agent System

Author: lyingbug

CHANGELOG.md

@@ -2,6 +2,68 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.6] - 2025-12-29
+
+### 🚀 New Features
+- **NEW**: Custom Agent System
+  - Support for creating, configuring, and selecting custom agents
+  - Agent feature indicators display with MCP service capability support
+  - Built-in agent sorting logic ensuring multi-turn conversation auto-enabled in agent mode
+  - Agent knowledge base selection modes: all/specified/disabled
+
+- **NEW**: Helm Chart for Kubernetes Deployment
+  - Complete Helm chart for Kubernetes deployment
+  - Neo4j template support for GraphRAG functionality
+  - Versioned image tags and official images compatibility
+
+- **NEW**: Enhanced FAQ Management
+  - FAQ entry retrieval API supporting single entry query by ID
+  - FAQ list sorting by update time (ascending/descending)
+  - Enhanced FAQ search with field-specific search (standard question/similar questions/answer/all)
+  - Batch update exclusion for FAQ entries in ByTag operations
+  - Tag deletion with content_only mode to delete only tag contents
+
+- **NEW**: Multi-Platform Model Adaptation
+  - Support for multiple platform model configurations
+  - Title generation model configuration
+  - Knowledge base selection mode without mandatory rerank model check
+
+- **NEW**: Korean Language Support
+  - Added Korean (한국어) internationalization support
+
+### ⚡ Improvements
+- **IMPROVED**: Knowledge Base Operations
+  - Async knowledge base deletion with background cleanup via ProcessKBDelete
+  - Multi-knowledge base search support with specified file ID filtering
+  - Optimized knowledge chunk pagination with type-specific search and sorting logic
+  - Enhanced SearchKnowledgeRequest structure with backward compatibility
+
+- **IMPROVED**: Prompt Template System
+  - Restructured prompt template system with multi-scenario template configuration
+  - Unified system prompts with optimized agent selector interface
+
+- **IMPROVED**: Tag Management
+  - Enhanced tag deletion with ID exclusion support
+  - Async index deletion task for optimized deletion flow
+  - Batch TagID update functionality
+  - Optimized tag name batch queries for improved efficiency
+
+- **IMPROVED**: API Documentation
+  - Updated API documentation links to new paths
+  - Added knowledge search API documentation
+  - Enhanced FAQ and tag deletion interface documentation
+  - Removed hardcoded host configuration from Swagger docs
+
+### 🐛 Bug Fixes
+- **FIXED**: Tag ID handling logic for empty strings and UntaggedTagID conditions
+- **FIXED**: JSON query compatibility for different database types (MySQL/PostgreSQL)
+- **FIXED**: GORM batch insert issue where zero-value fields (IsEnabled, Flags) were ignored
+- **FIXED**: Helm chart versioned image tags and runAsNonRoot compatibility
+
+### 🔧 Refactoring
+- **REFACTORED**: Removed security validation and length limits, simplified input processing logic
+- **REFACTORED**: Enhanced agent configuration with improved selection and state management
+
 ## [0.2.5] - 2025-12-22
 
 ### 🚀 New Features
@@ -397,6 +459,7 @@ All notable changes to this project will be documented in this file.
 - Docker Compose for quick startup and service orchestration.
 - MCP server support for integrating with MCP-compatible clients.
 
+[0.2.6]: https://github.com/Tencent/WeKnora/tree/v0.2.6
 [0.2.5]: https://github.com/Tencent/WeKnora/tree/v0.2.5
 [0.2.4]: https://github.com/Tencent/WeKnora/tree/v0.2.4
 [0.2.3]: https://github.com/Tencent/WeKnora/tree/v0.2.3

README.md

@@ -22,7 +22,7 @@
         <img src="https://img.shields.io/badge/License-MIT-ffffff?labelColor=d4eaf7&color=2e6cc4" alt="License">
     </a>
     <a href="./CHANGELOG.md">
-        <img alt="Version" src="https://img.shields.io/badge/version-0.2.5-2e6cc4?labelColor=d4eaf7">
+        <img alt="Version" src="https://img.shields.io/badge/version-0.2.6-2e6cc4?labelColor=d4eaf7">
     </a>
 </p>
 

README_CN.md

@@ -22,7 +22,7 @@
         <img src="https://img.shields.io/badge/License-MIT-ffffff?labelColor=d4eaf7&color=2e6cc4" alt="License">
     </a>
     <a href="./CHANGELOG.md">
-        <img alt="版本" src="https://img.shields.io/badge/version-0.2.5-2e6cc4?labelColor=d4eaf7">
+        <img alt="版本" src="https://img.shields.io/badge/version-0.2.6-2e6cc4?labelColor=d4eaf7">
     </a>
 </p>
 

README_JA.md

@@ -22,7 +22,7 @@
         <img src="https://img.shields.io/badge/License-MIT-ffffff?labelColor=d4eaf7&color=2e6cc4" alt="License">
     </a>
     <a href="./CHANGELOG.md">
-        <img alt="バージョン" src="https://img.shields.io/badge/version-0.2.5-2e6cc4?labelColor=d4eaf7">
+        <img alt="バージョン" src="https://img.shields.io/badge/version-0.2.6-2e6cc4?labelColor=d4eaf7">
     </a>
 </p>
 

VERSION

@@ -1 +1 @@
-0.2.5
+0.2.6

config/config.yaml

@@ -23,7 +23,7 @@ conversation:
     - 使用礼貌、专业的语气
 
     ## 用户的问题是:
-    {{.Query}}
+    {{query}}
   enable_rewrite: true
   enable_query_expansion: true
   enable_rerank: true
@@ -82,15 +82,10 @@ conversation:
     改写后: 国外手机号是否可以注册微信账号
   rewrite_prompt_user: |
     ## 历史对话背景
-    {{range .Conversation}}
-    ------BEGIN------
-    用户的问题是：{{.Query}}
-    助手的回答是：{{.Answer}}
-    ------END------
-    {{end}}
+    {{conversation}}
 
     ## 需要改写的用户问题
-    {{.Query}}
+    {{query}}
 
     ## 改写后的问题
   keywords_extraction_prompt: |
@@ -134,7 +129,7 @@ conversation:
     Output: iPhone, 连接WiFi, 使用iPhone连接WiFi
 
     # Real Data
-    USER: {{.Query}}
+    USER: {{query}}
 
   keywords_extraction_prompt_user: |
     Output:
@@ -182,7 +177,6 @@ conversation:
     prompt: |
       你是一个专业的智能信息检索助手，名为WeKnora。你犹如专业的高级秘书，依据检索到的信息回答用户问题，不能利用任何先验知识。
       当用户提出问题时，助手会基于特定的信息进行解答。助手首先在心中思考推理过程，然后向用户提供答案。
-    context_template: |
       ## 回答问题规则
       - 仅根据检索到的信息中的事实进行回复，不得运用任何先验知识，保持回应的客观性和准确性。
       - 复杂问题和答案的按Markdown分结构展示，总述部分不需要拆分
@@ -195,18 +189,7 @@ conversation:
       - 以Markdown图文格式输出你的最终结果
       - 输出内容要保证简短且全面，条理清晰，信息明确，不重复。
 
-      ## 当前时间是：
-      {{.CurrentTime}} {{.CurrentWeek}}
-
-      ## 检索到的信息如下：
-      ------BEGIN------
-      {{range .Contexts}}
-      {{.}}
-      {{end}}
-      ------END------
-
-      ## 用户当前的问题是：
-      {{.Query}}
+    context_template: "{{query}}"
   extract_entities_prompt: |
     ## 任务
     用户提供的文本中，提取所有符合以下实体类型的实体：
@@ -495,11 +478,11 @@ conversation:
   generate_questions_prompt: |
     你是一个专业的问题生成助手。你的任务是根据给定的【主要内容】生成用户可能会问的相关问题。
 
-    {{.Context}}
+    {{context}}
     ## 主要内容（请基于此内容生成问题）
-    文档名称：{{.DocName}}
+    文档名称：{{doc_name}}
     文档内容：
-    {{.Content}}
+    {{content}}
 
     ## 核心要求
     - 生成的问题必须与【主要内容】直接相关
@@ -508,7 +491,7 @@ conversation:
     - 问题应该是用户在实际场景中可能会提出的自然问题
     - 问题应该多样化，覆盖内容的不同方面
     - 每个问题应该简洁明了，长度控制在30字以内
-    - 生成的问题数量为 {{.QuestionCount}} 个
+    - 生成的问题数量为 {{question_count}} 个
 
     ## 问题类型建议
     - 定义类：什么是...？...是什么？

config/prompt_templates/context_template.yaml

@@ -0,0 +1,65 @@
+# 上下文模板
+templates:
+  - id: "default_context"
+    name: "标准模板"
+    description: "标准的上下文格式化模板"
+    has_knowledge_base: true
+    content: |
+      请根据以下参考资料回答用户问题。
+
+      参考资料：
+      {{contexts}}
+
+      用户问题：{{query}}
+
+      请基于上述参考资料进行回答。如果参考资料不足以回答问题，请明确告知。
+
+  - id: "detailed_context"
+    name: "详细模板"
+    description: "包含详细说明的上下文模板"
+    has_knowledge_base: true
+    content: |
+      ## 任务说明
+      请根据提供的参考资料，准确、全面地回答用户问题。
+
+      ## 参考资料
+      {{contexts}}
+
+      ## 用户问题
+      {{query}}
+
+      ## 回答要求
+      1. 仅基于参考资料回答，不要编造信息
+      2. 如果多个资料有冲突，请综合分析
+      3. 适当引用来源，增强可信度
+      4. 如果资料不足，请明确说明
+
+      当前时间：{{current_time}} {{current_week}}
+
+  - id: "simple_context"
+    name: "简洁模板"
+    description: "简洁的上下文模板"
+    has_knowledge_base: true
+    content: |
+      参考资料：
+      {{contexts}}
+
+      问题：{{query}}
+
+      请回答上述问题。
+
+  - id: "qa_context"
+    name: "问答模板"
+    description: "问答场景专用模板"
+    has_knowledge_base: true
+    content: |
+      你需要回答一个问题。以下是可能相关的资料：
+
+      {{contexts}}
+
+      用户的问题是：{{query}}
+
+      请基于以上资料回答问题。回答要求：
+      - 直接回答问题，不要重复问题
+      - 如果资料中没有相关信息，请说明
+      - 保持回答简洁准确

config/prompt_templates/fallback.yaml

@@ -0,0 +1,47 @@
+# 兜底提示词模板
+templates:
+  - id: "default_fallback"
+    name: "标准兜底"
+    description: "标准的兜底回复模板"
+    content: |
+      抱歉，我在知识库中没有找到与您问题直接相关的内容。
+
+      您可以尝试：
+      1. 换一种方式描述您的问题
+      2. 提供更多具体信息
+      3. 咨询相关领域的专业人员
+
+      如果您有其他问题，我很乐意继续为您服务。
+
+  - id: "polite_fallback"
+    name: "礼貌兜底"
+    description: "更加礼貌友好的兜底回复"
+    content: |
+      非常抱歉，目前我无法为您提供这个问题的准确答案。这可能是因为：
+      - 该问题超出了我的知识范围
+      - 知识库中暂无相关内容
+
+      建议您：
+      1. 尝试用不同的关键词重新提问
+      2. 将问题拆分为更具体的小问题
+      3. 联系人工客服获取帮助
+
+      感谢您的理解，期待能在其他问题上帮助到您！
+
+  - id: "brief_fallback"
+    name: "简洁兜底"
+    description: "简短的兜底回复"
+    content: "抱歉，我暂时无法回答这个问题。请尝试换一种方式提问，或联系人工客服。"
+
+  - id: "model_fallback"
+    name: "模型兜底"
+    description: "交给模型继续生成的兜底提示词"
+    content: |
+      知识库中没有找到与用户问题直接相关的内容。请根据你的通用知识，尽可能帮助用户解答问题。
+
+      注意事项：
+      1. 明确告知用户这是基于通用知识的回答，而非知识库内容
+      2. 如果问题涉及特定领域或需要最新信息，建议用户查阅官方资料
+      3. 保持回答的准确性和客观性
+
+      用户问题：{{query}}

config/prompt_templates/rewrite_system.yaml

@@ -0,0 +1,30 @@
+# 改写系统提示词模板
+templates:
+  - id: "default_rewrite_system"
+    name: "标准改写"
+    description: "标准的问题改写系统提示词"
+    content: |
+      你是一个专业的问题改写助手。你的任务是将用户的后续问题改写为独立、完整的问题，使其可以脱离对话上下文独立理解。
+
+      改写规则：
+      1. 消解代词指代（如"它"、"这个"、"他们"等）
+      2. 补全省略的主语或宾语
+      3. 保持原问题的核心意图不变
+      4. 改写后的问题应该简洁清晰
+
+      只输出改写后的问题，不要输出其他内容。
+
+  - id: "strict_rewrite_system"
+    name: "严格改写"
+    description: "严格要求的问题改写模板"
+    content: |
+      你是问题改写专家。请将用户问题改写为完整、独立的问题。
+
+      严格要求：
+      1. 必须消解所有代词和指代
+      2. 必须补全所有省略内容
+      3. 不得改变原问题意图
+      4. 不得添加原问题没有的内容
+      5. 改写结果必须是一个问句
+
+      直接输出改写后的问题，不要有任何解释。

config/prompt_templates/rewrite_user.yaml

@@ -0,0 +1,30 @@
+# 改写用户提示词模板
+templates:
+  - id: "default_rewrite_user"
+    name: "标准格式"
+    description: "标准的改写用户提示词格式"
+    content: |
+      ## 历史对话背景
+      {{conversation}}
+
+      ## 需要改写的用户问题
+      {{query}}
+
+      ## 改写后的问题
+
+  - id: "detailed_rewrite_user"
+    name: "详细格式"
+    description: "详细的改写用户提示词格式"
+    content: |
+      ## 历史对话背景
+      以下是用户与助手的对话历史，请仔细阅读以理解上下文：
+
+      {{conversation}}
+
+      ## 当前用户问题
+      {{query}}
+
+      ## 任务要求
+      请根据以上对话历史，将当前问题改写为一个独立、完整、可以脱离上下文理解的问题。
+
+      ## 改写后的问题