超级智能体
后端项目初始化
环境准备
安装的 JDK 版本必须是 21 以上，最好是 21 ，因为支持使用虚拟线程
**不能使用其他版本
新建项目
在 IDEA 中新建项目，选择 Spring Boot 模板，注意需要确保 Server URL 为 https://start.spring.io/
![[Pasted image 20251106194511.png]]
Spring Boot 版本选择 3.4.11，然后再顺手选上 SpringWeb 和 Lombok
![[Pasted image 20251106194721.png]]
整合依赖
整合 Hutool 工具库和 Knife4j
Hutool 工具库
参考官方文档引入： https://doc.hutool.cn/pages/index/#%F0%9F%8D%8Amaven
在 Maven 的 pom.xml 中添加依赖：
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-all</artifactId>
<version>5.8.37</version>
</dependency>
Knife4j 接口文档
参考 官方文档 引入，注意这里使用的是 Spring Boot 3.x，不要引入错版本了：
- 在 Maven 的 pom.xml 中添加依赖：
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
<version>4.4.0</version>
</dependency>
- 创建 controller 包存放 API 接口，编写一个健康检查接口用于测试是否能够正常引入：
@RestController
@RequestMapping("/health")
public class HealthController {
@GetMapping
public String HealthCheck() {
return "ok";
}
}
- 根据官网文档在 application.yml 中追加接口文档配置，并且扫描 controller 包
- 注意：包扫描那里是 ==.== 不是 ==/==
spring:
application:
name: super-ai-agent
server:
port: 8123
servlet:
context-path: /api
# springdoc-openapi项目配置
springdoc:
swagger-ui:
path: /swagger-ui.html
tags-sorter: alpha
operations-sorter: alpha
api-docs:
path: /v3/api-docs
group-configs:
- group: 'default'
paths-to-match: '/**'
packages-to-scan: com.example.superaiagent.controller
# knife4j的增强配置，不需要增强可以不配
knife4j:
enable: true
setting:
language: zh_cn
- 启动项目，访问 http://localhost:8123/api/doc.html 能够看到接口文档，可以测试调用接口：
![[Pasted image 20251106203306.png]]