smartclass-backend Dify应用

环境要求

• JDK 1.8+
• Maven 3.6+
• MySQL 5.7+
• Redis 5.0+

安装与运行

Docker部署

使用Docker Compose一键部署（包含MySQL和Redis）：

docker-compose up -d

访问Knife4J接口文档：http://服务器IP地址:8101/api/doc.html

部署文档

详细的部署步骤和配置说明请参考doc/deployment.md文档。

系统演示

使用方式

1. 启动项目后，访问 http://<your-server-ip>:12345/api/doc/postman-collection 下载Postman Collection
2. 导入Collection到Postman中
3. 按照指南配置环境变量
4. 开始测试API和WebSocket接口

更多详细信息，请参考 Postman调试指南

数据库配置

1. 创建MySQL数据库

CREATE DATABASE smart_class DEFAULT CHARACTER SET utf8mb4;

1. 导入SQL初始化脚本

mysql -u username -p smart_class < sql/create_table.sql

数据库配置

spring: datasource: url: jdbc:mysql://localhost:3306/smart_class username: root password: your_password

Redis配置

redis: host: localhost port: 6379 password: your_redis_password

3. 启动应用

5. 配置项说明

在添加智能体时，需要配置以下关键参数：

8. 高级配置

#### 流式响应配置

// 在DifyServiceImpl中配置流式响应
@Override
public void sendChatMessageStreaming(String userId, String content, 
    StreamingCallback callback) {
    // 配置流式响应参数
    DifyChatRequest request = new DifyChatRequest();
    request.setResponseMode("streaming");
    request.setUser(userId);
    request.setQuery(content);
    // ...
}

#### 多模态支持 系统支持文本、图片等多模态输入： - 文本对话 - 图片识别与分析 - 文件上传与处理

详细的技术实现请参考 Dify集成技术文档。

主要API模块

用户模块 API

• 用户注册、登录鉴权
• 用户信息管理
• 用户等级和成长体系

AI对话模块 API

• AI分身创建和管理
• 会话创建与历史记录
• 文本和语音交互

课程学习模块 API

• 课程分类和内容管理
• 学习进度跟踪
• 课程评价和收藏

每日学习模块 API

• 每日文章推荐
• 每日单词学习
• 学习内容收藏

Dify API集成

项目集成了Dify API用于智能对话功能，详细配置和使用方法请参考DifyAPI.md文档。

3. 创建API密钥

为了在系统中使用智能体，需要创建API密钥：

1. 在Dify平台中，进入"API密钥"管理页面
2. 点击"创建密钥"
3. 设置密钥权限（建议选择"只读"或"读写"）
4. 复制生成的API密钥，妥善保管

API文档

启动项目后，访问Knife4j接口文档：

http://localhost:8101/api/doc.html

Postman接口调试支持

智慧课堂后端现已支持Postman接口文档和WebSocket调试。

接口说明

• /chat/connect: 建立SSE连接，前端使用EventSource订阅此端点
• /chat/disconnect: 关闭SSE连接
• /chat/send: 发送实时聊天消息
• /chat/notify: 发送系统通知（仅管理员可用）
• /chat/status: 获取聊天状态（未读数量、在线状态等）

课程模块

7. 常见问题

Q: 智能体无法正常响应？ A: 请检查以下项目： - API密钥是否正确 - Base URL是否可访问 - 智能体是否已发布 - 网络连接是否正常

Q: 如何更新智能体配置？ A: 在管理后台找到对应的智能体，点击编辑按钮即可修改配置。

Q: 是否支持多个智能体？ A: 是的，系统支持同时配置多个不同的智能体，用户可以在前端选择不同的AI助手进行对话。