跳到主要内容

问卷系统集成 AI 教程

本教程将指导您如何在问卷系统中集成 AI 功能，利用 AI 快速、智能地创建调查问卷和考试题目。

一、AI 在问卷系统中的作用​

通过 AI，您可以以自然语言对话的形式快速创建调查问卷和考试题目，省去繁琐的手工设计环节，并确保内容的逻辑性和丰富性。

目前本系统支持两种主流 AI 模型平台：

  • Coze（字节跳动推出的智能体平台）
  • DeepSeek（通过 SiliconFlow 平台提供服务）

二、申请第三方 AI 服务​

1. 接入 Coze​

Coze 是一个智能体（Agent）平台，用户可在其中配置提示词和回复逻辑，生成用于问卷生成的对话式智能体。

接入步骤：​

  1. 访问 Coze 官网 注册账号；
  2. 创建一个智能体，并在「人设与回复逻辑」中填写提示词（如需推荐提示词，请联系系统售后）；
  3. 点击「发布」应用，系统将分配一个 bot_id；
  4. 访问 访问令牌页面，申请并复制您的访问令牌 Token。

需要保存的信息：​

  • bot_id：智能体 ID
  • Token：访问令牌

2. 接入 DeepSeek（通过 SiliconFlow）​

DeepSeek 是一个自然语言生成模型，目前支持 DeepSeek-R1 和 DeepSeek-V3 两个版本。本系统通过 SiliconFlow 接入 DeepSeek 模型服务。

接入步骤：​

  1. 访问 SiliconFlow 官网 注册账号；
  2. 登录后，进入 API 密钥管理页面；
  3. 点击「新建 API 密钥」，保存生成的 API Token；
  4. 系统中已内置 DeepSeek 的默认模型 ID，无需额外配置。

需要保存的信息：​

  • API Token

三、系统内配置方式​

系统支持通过 YAML 配置文件或命令行参数进行 AI 模型的接入配置。

方式一：通过 YAML 文件配置（推荐）​

请在 application.yaml 中添加以下配置：

surveyking:
  ai:
    coze:
      token: ${COZE_API_TOKEN:your_coze_token_here}
      model-id: ${COZE_MODEL_ID:your_bot_id_here}
      enabled: true
      model-types:
        - name: 扣子
          value: coze

    deepseek:
      token: ${DEEPSEEK_API_TOKEN:your_deepseek_token_here}
      enabled: true
      model-types:
        - name: DeepSeek-R1
          value: Pro/deepseek-ai/DeepSeek-R1
        - name: DeepSeek-V3
          value: Pro/deepseek-ai/DeepSeek-V3

注：Coze 和 DeepSeek 的接口地址与模型 ID 系统已内置，您无需额外配置。

方式二：通过命令行参数配置（用于容器化部署等场景）​

您也可以在启动应用时通过命令行方式传入配置：

java -jar surveyking-server.jar \
  --surveyking.ai.coze.token=your_coze_token \
  --surveyking.ai.coze.model-id=your_bot_id \
  --surveyking.ai.coze.enabled=true \
  --surveyking.ai.deepseek.token=your_deepseek_token \
  --surveyking.ai.deepseek.enabled=true

四、前端使用方式​

在问卷系统中，用户在创建问卷或考试时可以选择所需的 AI 模型，输入一段自然语言描述（如“我想创建一个员工满意度调查”），系统将自动生成结构化的问卷内容。

界面支持模型选择、对话记录查看，并自动将结果转为标准问卷格式。

五、常见问题​

Q: 我应该选择 DeepSeek 还是 Coze？ A: 如果您希望更快地获得结果、且提示词模板固定，建议选择 DeepSeek；如果您希望自定义提示词或使用多轮对话构建更复杂的问卷内容，推荐使用 Coze。

Q: 可以同时启用多个 AI 模型吗？ A: 可以。系统支持同时配置多个模型，用户在前端可以自由选择使用哪一个。

Q: 提示词如何配置？ A: 提示词用于引导 AI 生成更准确的问卷内容。在 Coze 平台中可自定义提示词，建议联系系统售后获取官方推荐模版。

Q: AI 生成的问卷是否可以修改？ A: 可以。生成后系统会以可编辑的结构展示问卷内容，用户可以在此基础上进行手动微调和完善。

Q: DeepSeek 和 Coze 的生成效果是否一样？ A: 不一样。Coze 侧重多轮对话场景，适合更复杂的业务需求；DeepSeek 更偏向快速生成和内容延展，适合标准化的问卷结构。

Q: 是否支持自建模型或企业私有化接入？ A: 当前系统支持通过 API Token 接入第三方 AI 服务，后续将支持自定义模型适配接口，欢迎与我们联系了解企业版方案。

Q: 如何排查模型调用失败的问题？ A: 请检查以下内容是否配置正确：Token 是否有效，模型是否启用（enabled=true），网络连接是否通畅。如仍有问题，请查看系统日志或联系技术支持。

如您在使用过程中遇到问题，欢迎联系系统服务支持团队获取帮助。

最后于 更新