assist/config

TSP智能助手配置说明

📋 配置文件概述

本目录包含TSP智能助手的核心配置文件，包括LLM配置、集成配置等。

🤖 LLM配置

千问模型配置

本项目默认使用阿里云千问模型。要使用千问模型，请按以下步骤配置：

1. 获取API密钥

1. 访问 阿里云百炼平台
2. 注册并登录账号
3. 创建应用并获取API密钥

2. 配置API密钥

编辑 config/llm_config.py 文件，将 api_key 替换为您的实际API密钥：

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. 环境变量配置（可选）

您也可以使用环境变量来配置：

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 文件包含飞书集成的所有配置信息：

{
  "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. 获取应用凭证

   • 访问 飞书开放平台
   • 创建企业自建应用
   • 获取 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界面进行部分配置的在线修改

环境变量支持

系统支持通过环境变量覆盖配置文件设置：

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