feat: 重大功能更新 v1.4.0 - 飞书集成、AI语义相似度、前端优化
主要更新内容: - 🚀 飞书多维表格集成，支持工单数据同步 - 🤖 AI建议与人工描述语义相似度计算 - 🎨 前端UI全面优化，现代化设计 - 📊 智能知识库入库策略（AI准确率<90%使用人工描述） - 🔧 代码重构，模块化架构优化 - 📚 完整文档整合和更新 - 🐛 修复配置导入和数据库字段问题 技术特性: - 使用sentence-transformers进行语义相似度计算 - 快速模式结合TF-IDF和语义方法 - 响应式设计，支持移动端 - 加载状态和动画效果 - 配置化AI准确率阈值
This commit is contained in:
赵杰 Jie Zhao （雄狮汽车科技）
141
config/README.md
141
config/README.md
@@ -1,16 +1,22 @@
|
||||
# LLM配置说明
|
||||
# TSP智能助手配置说明
|
||||
|
||||
## 千问模型配置
|
||||
## 📋 配置文件概述
|
||||
|
||||
本目录包含TSP智能助手的核心配置文件，包括LLM配置、集成配置等。
|
||||
|
||||
## 🤖 LLM配置
|
||||
|
||||
### 千问模型配置
|
||||
|
||||
本项目默认使用阿里云千问模型。要使用千问模型，请按以下步骤配置：
|
||||
|
||||
### 1. 获取API密钥
|
||||
#### 1. 获取API密钥
|
||||
|
||||
1. 访问 [阿里云百炼平台](https://bailian.console.aliyun.com/)
|
||||
2. 注册并登录账号
|
||||
3. 创建应用并获取API密钥
|
||||
|
||||
### 2. 配置API密钥
|
||||
#### 2. 配置API密钥
|
||||
|
||||
编辑 `config/llm_config.py` 文件，将 `api_key` 替换为您的实际API密钥：
|
||||
|
||||
@@ -25,13 +31,13 @@ QWEN_CONFIG = LLMConfig(
|
||||
)
|
||||
```
|
||||
|
||||
### 3. 可用的千问模型
|
||||
#### 3. 可用的千问模型
|
||||
|
||||
- `qwen-turbo`: 快速响应，适合一般对话
|
||||
- `qwen-plus`: 平衡性能和成本
|
||||
- `qwen-max`: 最强性能，适合复杂任务
|
||||
|
||||
### 4. 环境变量配置（可选）
|
||||
#### 4. 环境变量配置（可选）
|
||||
|
||||
您也可以使用环境变量来配置：
|
||||
|
||||
@@ -40,7 +46,7 @@ export QWEN_API_KEY="sk-your-actual-qwen-api-key"
|
||||
export QWEN_MODEL="qwen-turbo"
|
||||
```
|
||||
|
||||
### 5. 其他模型支持
|
||||
#### 5. 其他模型支持
|
||||
|
||||
项目也支持其他LLM提供商：
|
||||
|
||||
@@ -48,6 +54,125 @@ export QWEN_MODEL="qwen-turbo"
|
||||
- **Anthropic**: Claude系列
|
||||
- **本地模型**: Ollama等
|
||||
|
||||
### 6. 配置验证
|
||||
#### 6. 配置验证
|
||||
|
||||
启动系统后，可以在Agent管理页面查看LLM使用统计，确认配置是否正确。
|
||||
|
||||
## 📱 飞书集成配置
|
||||
|
||||
### 配置文件说明
|
||||
|
||||
`integrations_config.json` 文件包含飞书集成的所有配置信息：
|
||||
|
||||
```json
|
||||
{
|
||||
"feishu": {
|
||||
"app_id": "cli_a8b50ec0eed1500d",
|
||||
"app_secret": "ccxkE7ZCFQZcwkkM1rLy0ccZRXYsT2xK",
|
||||
"app_token": "XXnEbiCmEaMblSs6FDJcFCqsnIg",
|
||||
"table_id": "tblnl3vJPpgMTSiP",
|
||||
"last_updated": "2025-09-19T18:27:40.579958",
|
||||
"status": "active"
|
||||
},
|
||||
"system": {
|
||||
"sync_limit": 10,
|
||||
"ai_suggestions_enabled": true,
|
||||
"auto_sync_interval": 0,
|
||||
"last_sync_time": null
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 配置参数说明
|
||||
|
||||
#### 飞书应用配置
|
||||
- `app_id`: 飞书应用ID
|
||||
- `app_secret`: 飞书应用密钥
|
||||
- `app_token`: 飞书多维表格应用Token
|
||||
- `table_id`: 飞书多维表格ID
|
||||
- `last_updated`: 最后更新时间
|
||||
- `status`: 集成状态（active/inactive）
|
||||
|
||||
#### 系统配置
|
||||
- `sync_limit`: 同步记录数量限制
|
||||
- `ai_suggestions_enabled`: 是否启用AI建议
|
||||
- `auto_sync_interval`: 自动同步间隔（分钟）
|
||||
- `last_sync_time`: 最后同步时间
|
||||
|
||||
### 获取飞书配置
|
||||
|
||||
1. **获取应用凭证**
|
||||
- 访问 [飞书开放平台](https://open.feishu.cn/)
|
||||
- 创建企业自建应用
|
||||
- 获取 `app_id` 和 `app_secret`
|
||||
|
||||
2. **获取表格信息**
|
||||
- 打开飞书多维表格
|
||||
- 从URL中提取 `app_token` 和 `table_id`
|
||||
- 例如：`https://my-ichery.feishu.cn/base/XXnEbiCmEaMblSs6FDJcFCqsnIg?table=tblnl3vJPpgMTSiP`
|
||||
- `app_token`: `XXnEbiCmEaMblSs6FDJcFCqsnIg`
|
||||
- `table_id`: `tblnl3vJPpgMTSiP`
|
||||
|
||||
3. **配置权限**
|
||||
- 在飞书开放平台中配置应用权限
|
||||
- 确保应用有读取多维表格的权限
|
||||
|
||||
### 字段映射配置
|
||||
|
||||
系统会自动映射以下飞书字段到本地数据库：
|
||||
|
||||
| 飞书字段 | 本地字段 | 类型 | 说明 |
|
||||
|---------|---------|------|------|
|
||||
| TR Number | order_id | String | 工单编号 |
|
||||
| TR Description | description | Text | 工单描述 |
|
||||
| Type of problem | category | String | 问题类型 |
|
||||
| TR Level | priority | String | 优先级 |
|
||||
| TR Status | status | String | 工单状态 |
|
||||
| Source | source | String | 来源 |
|
||||
| Created by | created_by | String | 创建人 |
|
||||
| Module（模块） | module | String | 模块 |
|
||||
| Wilfulness（责任人） | wilfulness | String | 责任人 |
|
||||
| Date of close TR | date_of_close | DateTime | 关闭日期 |
|
||||
| Vehicle Type01 | vehicle_type | String | 车型 |
|
||||
| VIN\|sim | vin_sim | String | 车架号/SIM |
|
||||
| App remote control version | app_remote_control_version | String | 应用远程控制版本 |
|
||||
| HMI SW | hmi_sw | String | HMI软件版本 |
|
||||
| 父记录 | parent_record | String | 父记录 |
|
||||
| Has it been updated on the same day | has_updated_same_day | String | 是否同日更新 |
|
||||
| Operating time | operating_time | String | 操作时间 |
|
||||
|
||||
## 🔧 配置管理
|
||||
|
||||
### 配置文件位置
|
||||
- `llm_config.py`: LLM客户端配置
|
||||
- `integrations_config.json`: 集成服务配置
|
||||
- `integrations_config copy.json`: 配置备份文件
|
||||
|
||||
### 配置更新
|
||||
- 修改配置文件后需要重启服务
|
||||
- 建议在修改前备份配置文件
|
||||
- 可以通过Web界面进行部分配置的在线修改
|
||||
|
||||
### 环境变量支持
|
||||
系统支持通过环境变量覆盖配置文件设置：
|
||||
|
||||
```bash
|
||||
# LLM配置
|
||||
export LLM_PROVIDER="openai"
|
||||
export LLM_API_KEY="your-api-key"
|
||||
export LLM_MODEL="gpt-3.5-turbo"
|
||||
|
||||
# 飞书配置
|
||||
export FEISHU_APP_ID="your-app-id"
|
||||
export FEISHU_APP_SECRET="your-app-secret"
|
||||
export FEISHU_APP_TOKEN="your-app-token"
|
||||
export FEISHU_TABLE_ID="your-table-id"
|
||||
```
|
||||
|
||||
## 🚨 注意事项
|
||||
|
||||
1. **安全性**: 配置文件包含敏感信息，请勿提交到版本控制系统
|
||||
2. **备份**: 修改配置前请备份原文件
|
||||
3. **权限**: 确保飞书应用有足够的权限访问多维表格
|
||||
4. **测试**: 配置完成后建议先进行测试同步
|
||||
5. **监控**: 定期检查同步状态和错误日志
|
||||
|
||||
110
config/ai_accuracy_config.py
Normal file
110
config/ai_accuracy_config.py
Normal file
@@ -0,0 +1,110 @@
|
||||
#!/usr/bin/env python
|
||||
# -*- coding: utf-8 -*-
|
||||
|
||||
"""
|
||||
AI准确率配置
|
||||
管理AI建议的准确率阈值和相关配置
|
||||
"""
|
||||
|
||||
from dataclasses import dataclass
|
||||
from typing import Dict, Any
|
||||
|
||||
@dataclass
|
||||
class AIAccuracyConfig:
|
||||
"""AI准确率配置类"""
|
||||
|
||||
# 相似度阈值配置
|
||||
auto_approve_threshold: float = 0.95 # 自动审批阈值（≥95%）
|
||||
use_human_resolution_threshold: float = 0.90 # 使用人工描述阈值（<90%）
|
||||
manual_review_threshold: float = 0.80 # 人工审核阈值（≥80%）
|
||||
|
||||
# 置信度配置
|
||||
ai_suggestion_confidence: float = 0.95 # AI建议默认置信度
|
||||
human_resolution_confidence: float = 0.90 # 人工描述置信度
|
||||
|
||||
# 入库策略配置
|
||||
prefer_human_when_low_accuracy: bool = True # 当AI准确率低时优先使用人工描述
|
||||
enable_auto_approval: bool = True # 是否启用自动审批
|
||||
enable_human_fallback: bool = True # 是否启用人工描述回退
|
||||
|
||||
def get_threshold_explanation(self, similarity: float) -> str:
|
||||
"""获取相似度阈值的解释"""
|
||||
if similarity >= self.auto_approve_threshold:
|
||||
return f"相似度≥{self.auto_approve_threshold*100:.0f}%，自动审批使用AI建议"
|
||||
elif similarity >= self.manual_review_threshold:
|
||||
return f"相似度≥{self.manual_review_threshold*100:.0f}%，建议人工审核"
|
||||
elif similarity >= self.use_human_resolution_threshold:
|
||||
return f"相似度<{self.use_human_resolution_threshold*100:.0f}%，建议使用人工描述"
|
||||
else:
|
||||
return f"相似度<{self.use_human_resolution_threshold*100:.0f}%，优先使用人工描述"
|
||||
|
||||
def should_use_human_resolution(self, similarity: float) -> bool:
|
||||
"""判断是否应该使用人工描述"""
|
||||
return similarity < self.use_human_resolution_threshold
|
||||
|
||||
def should_auto_approve(self, similarity: float) -> bool:
|
||||
"""判断是否应该自动审批"""
|
||||
return similarity >= self.auto_approve_threshold and self.enable_auto_approval
|
||||
|
||||
def get_confidence_score(self, similarity: float, use_human: bool = False) -> float:
|
||||
"""获取置信度分数"""
|
||||
if use_human:
|
||||
return self.human_resolution_confidence
|
||||
else:
|
||||
return max(similarity, self.ai_suggestion_confidence)
|
||||
|
||||
def to_dict(self) -> Dict[str, Any]:
|
||||
"""转换为字典格式"""
|
||||
return {
|
||||
"auto_approve_threshold": self.auto_approve_threshold,
|
||||
"use_human_resolution_threshold": self.use_human_resolution_threshold,
|
||||
"manual_review_threshold": self.manual_review_threshold,
|
||||
"ai_suggestion_confidence": self.ai_suggestion_confidence,
|
||||
"human_resolution_confidence": self.human_resolution_confidence,
|
||||
"prefer_human_when_low_accuracy": self.prefer_human_when_low_accuracy,
|
||||
"enable_auto_approval": self.enable_auto_approval,
|
||||
"enable_human_fallback": self.enable_human_fallback
|
||||
}
|
||||
|
||||
@classmethod
|
||||
def from_dict(cls, data: Dict[str, Any]) -> 'AIAccuracyConfig':
|
||||
"""从字典创建配置"""
|
||||
return cls(**data)
|
||||
|
||||
# 默认配置实例
|
||||
DEFAULT_CONFIG = AIAccuracyConfig()
|
||||
|
||||
# 配置预设
|
||||
PRESETS = {
|
||||
"conservative": AIAccuracyConfig(
|
||||
auto_approve_threshold=0.98,
|
||||
use_human_resolution_threshold=0.85,
|
||||
manual_review_threshold=0.90,
|
||||
human_resolution_confidence=0.95
|
||||
),
|
||||
"balanced": AIAccuracyConfig(
|
||||
auto_approve_threshold=0.95,
|
||||
use_human_resolution_threshold=0.90,
|
||||
manual_review_threshold=0.80,
|
||||
human_resolution_confidence=0.90
|
||||
),
|
||||
"aggressive": AIAccuracyConfig(
|
||||
auto_approve_threshold=0.90,
|
||||
use_human_resolution_threshold=0.80,
|
||||
manual_review_threshold=0.70,
|
||||
human_resolution_confidence=0.85
|
||||
)
|
||||
}
|
||||
|
||||
def get_accuracy_config(preset: str = "balanced") -> AIAccuracyConfig:
|
||||
"""获取准确率配置"""
|
||||
return PRESETS.get(preset, DEFAULT_CONFIG)
|
||||
|
||||
def update_accuracy_config(config: AIAccuracyConfig) -> bool:
|
||||
"""更新准确率配置（可以保存到文件或数据库）"""
|
||||
try:
|
||||
# 这里可以实现配置的持久化存储
|
||||
# 例如保存到配置文件或数据库
|
||||
return True
|
||||
except Exception:
|
||||
return False
|
||||
@@ -1,11 +1,11 @@
|
||||
{
|
||||
"feishu": {
|
||||
"app_id": "tblnl3vJPpgMTSiP",
|
||||
"app_id": "cli_a8b50ec0eed1500d",
|
||||
"app_secret": "ccxkE7ZCFQZcwkkM1rLy0ccZRXYsT2xK",
|
||||
"app_token": "XXnEbiCmEaMblSs6FDJcFCqsnlg",
|
||||
"app_token": "XXnEbiCmEaMblSs6FDJcFCqsnIg",
|
||||
"table_id": "tblnl3vJPpgMTSiP",
|
||||
"last_updated": null,
|
||||
"status": "inactive"
|
||||
"last_updated": "2025-09-19T18:40:55.291113",
|
||||
"status": "active"
|
||||
},
|
||||
"system": {
|
||||
"sync_limit": 10,
|
||||
|
||||
Reference in New Issue
Block a user