AI 问卷助手配置 (DeepSeek 集成) #

TDUCK v6 社区版引入了强大的 AI 智能建表与问卷生成 功能。用户只需输入自然语言提示词（如“帮我设计一个员工满意度调查问卷”），系统即可通过 AI 引擎快速分析并自动生成完整的表单结构和组件。

⚙️ 核心配置参数 #

AI 问卷生成基于 DeepSeek 大模型接口实现。所有的配置均保存在数据库的 sys_env_config 表中，配置键名为 deepSeekEnvConfig。

1. 配置文件 JSON 结构 #

在 sys_env_config 中，对应的配置 JSON 结构如下：

{
  "baseUrl": "https://api.deepseek.com/v1/",
  "apiKey": "your-deepseek-api-key-here",
  "modelName": "deepseek-chat",
  "enabled": true
}

• baseUrl：DeepSeek API 的服务基础地址。官方默认为 https://api.deepseek.com/v1/。如果您使用第三方中转代理，可以修改为对应的代理地址（例如 https://api.domain.com/v1/）。
• apiKey：您在 DeepSeek 开放平台申请的 API Key。
• modelName：所调用的模型名称，默认填 deepseek-chat。
• enabled：是否开启 AI 助手功能（true / false）。

📥 配置方式 #

您可以选择通过管理后台可视化配置，或者直接执行 SQL 脚本 写入。

方式一：管理后台配置（推荐） #

1. 登录管理后台，进入 系统管理 ➔ 系统参数配置。
2. 找到 AI 配置 或 DeepSeek 配置 面板。
3. 填入您的 API Key，开启开关，点击保存。
4. 系统会自动刷新缓存生效，无需重启后端服务。

方式二：直接执行 SQL 写入 #

如果后台面板未提供入口，您可以通过在 MySQL 中执行如下 SQL 直接注入配置：

-- 插入或更新 DeepSeek 配置
INSERT INTO sys_env_config (env_key, env_value, create_time, update_time)
VALUES (
    'deepSeekEnvConfig', 
    '{"baseUrl": "https://api.deepseek.com/v1/", "apiKey": "您的APIKey", "modelName": "deepseek-chat", "enabled": true}', 
    NOW(), 
    NOW()
)
ON DUPLICATE KEY UPDATE 
    env_value = VALUES(env_value), 
    update_time = NOW();

🛠️ 技术实现原理与兼容性说明 #

后端实现代码可参考：

• tduck-ai/src/main/java/com/tduck/cloud/ai/config/AiConfiguration.java
• tduck-ai/src/main/java/com/tduck/cloud/ai/controller/AiController.java

[!TIP] 第三方代理兼容性： 官方 DeepSeek 接口支持极严格的 json_object 响应格式。为此，后端的 AiConfiguration 中包含了一段智能识别逻辑：

java

boolean isDeepSeekOfficial = StrUtil.isNotBlank(aiProperties.getBaseUrl())
        && StrUtil.containsIgnoreCase(aiProperties.getBaseUrl(), "api.deepseek.com");
if (isDeepSeekOfficial) {
    jsonConfigBuilder.putAdditionalConfig("response_format", MapUtil.of("type", "json_object"));
}

如果您使用的是非官方的第三方 API 中转服务，系统会自动关闭严格 JSON 响应模式以保证极佳的兼容性，防止接口报 400 Bad Request 错误。

🔍 常见问题排查 #

1. 接口报 500 / 提示词生成超时：
   • 检查您的服务器网络是否能够正常访问 api.deepseek.com 域名。
   • 检查您的 DeepSeek 账户余额是否充足。
2. 生成的内容不是标准 JSON：
   • 确认所用的第三方 API 模型支持结构化输出。建议优先使用 DeepSeek 官方原生接口。