assist/config/README.md

# 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. **监控**: 定期检查同步状态和错误日志