da4736c323
主要更新内容: - 🚀 飞书多维表格集成，支持工单数据同步 - 🤖 AI建议与人工描述语义相似度计算 - 🎨 前端UI全面优化，现代化设计 - 📊 智能知识库入库策略（AI准确率<90%使用人工描述） - 🔧 代码重构，模块化架构优化 - 📚 完整文档整合和更新 - 🐛 修复配置导入和数据库字段问题 技术特性: - 使用sentence-transformers进行语义相似度计算 - 快速模式结合TF-IDF和语义方法 - 响应式设计，支持移动端 - 加载状态和动画效果 - 配置化AI准确率阈值
179 lines
5.1 KiB
Markdown
179 lines
5.1 KiB
Markdown
# TSP智能助手配置说明
|
||
|
||
## 📋 配置文件概述
|
||
|
||
本目录包含TSP智能助手的核心配置文件，包括LLM配置、集成配置等。
|
||
|
||
## 🤖 LLM配置
|
||
|
||
### 千问模型配置
|
||
|
||
本项目默认使用阿里云千问模型。要使用千问模型，请按以下步骤配置：
|
||
|
||
#### 1. 获取API密钥
|
||
|
||
1. 访问 [阿里云百炼平台](https://bailian.console.aliyun.com/)
|
||
2. 注册并登录账号
|
||
3. 创建应用并获取API密钥
|
||
|
||
#### 2. 配置API密钥
|
||
|
||
编辑 `config/llm_config.py` 文件，将 `api_key` 替换为您的实际API密钥：
|
||
|
||
```python
|
||
QWEN_CONFIG = LLMConfig(
|
||
provider="openai",
|
||
api_key="sk-your-actual-qwen-api-key", # 替换为您的实际密钥
|
||
base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
|
||
model="qwen-turbo",
|
||
temperature=0.7,
|
||
max_tokens=2000
|
||
)
|
||
```
|
||
|
||
#### 3. 可用的千问模型
|
||
|
||
- `qwen-turbo`: 快速响应，适合一般对话
|
||
- `qwen-plus`: 平衡性能和成本
|
||
- `qwen-max`: 最强性能，适合复杂任务
|
||
|
||
#### 4. 环境变量配置（可选）
|
||
|
||
您也可以使用环境变量来配置：
|
||
|
||
```bash
|
||
export QWEN_API_KEY="sk-your-actual-qwen-api-key"
|
||
export QWEN_MODEL="qwen-turbo"
|
||
```
|
||
|
||
#### 5. 其他模型支持
|
||
|
||
项目也支持其他LLM提供商：
|
||
|
||
- **OpenAI**: GPT-3.5/GPT-4
|
||
- **Anthropic**: Claude系列
|
||
- **本地模型**: Ollama等
|
||
|
||
#### 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. **监控**: 定期检查同步状态和错误日志
|