---
title: "02-准备项目启动条件"
created: 2026-05-18
aliases:
  - 准备项目启动条件
tags:
  - 项目
---
# 准备项目启动条件

## 一、项目下载

### 1.1 项目地址：

<https://github.com/java-up-up/super-agent>

#### 项目HTTPS克隆地址：

```bash
git clone https://github.com/java-up-up/super-agent.git
```

#### 项目SSH克隆地址：

```bash
git clone git@github.com:java-up-up/super-agent.git
```

### 1.2 克隆项目注意：

要使用git clone使用上述的HTTPS或者SSH地址克隆下载项目，不要下载ZIP，否则不会通过git关联到项目的远程仓库，不能够git pull更新项目

## 二、IntelliJ IDEA导入项目

知道了项目地址后，使用IntelliJ IDEA将项目导入

![[Fq46NddnkdWMwCfZjPsfGTRW9g_k-bae243ef.png]]

通过 IntelliJ IDEA将项目导入，URL为项目的https或者ssh地址，Directory为项目的目录，当项目克隆下来后，等待IntelliJ IDEA通过maven将项目构建完毕

### 2.1 项目目录注意：

项目所在的目录中**不要有中文！** 必须是全英文的，否则在服务启动时会出现class找不到的问题！

为了加快maven的构建速度，小伙伴可在自己电脑的maven中配置阿里云的镜像仓库

#### 文件位置

```text
apache-maven-3.6.3\conf\settings.xml
```

#### 2.2 阿里云仓库配置

```text
<mirrors>
    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>
```

当项目构建完毕后，可在项目根目录下执行

```bash
mvn clean compile
```

编译一下项目是否有错误

## 三、安装需要的中间件

项目中依赖了Mysql、Redis、kafka、向量数据库 的相关中间件，可参考下列文档直接使用本人提供的中间件云环境地址或者本地搭建：

[[05-如何安装项目需要的中间件环境|如何安装项目需要的中间件环境]]

## 四、修改项目中的中间件配置

当安装完了中间件后，需要将项目中连接中间件的配置修改为自己安装的中间件的地址，端口，账户和密码等信息

### 4.1 Redis/Mysql/Kafka 的相关配置

![[Ft2z2lyANvW6UIwFFlBD7iw8LEsY-d38afc3c.png]]

### 4.2 阿里百炼模型的秘钥 Key 配置

![[FthspT-wFfi5qejcd0-JsDlPc8Nv-01267efc.png]]

### 4.3 Tavily 联网能力的相关配置

![[FjdoaO-wLEpi1ibBKms5WMjiKDNL-b30e1c54.png]]

### 4.4 minio 相关配置

![[FgGaP6f1W8YT8WYx4garnjzOWmJb-8fe79292.png]]

### 4.5 PostgresSql 向量数据库的相关配置

![[FuaPic53KnnqdgnizZCCWwJspCU2-1429553a.png]]

### 4.6 Elasticsearch 的相关配置

![[FtTf78JOjiLosYt6hbReJOQDJh7b-1a5bb453.png]]

### 4.7 neo4j 的相关配置

![[FnPR7qi2BHnLAaNVsg2cC1Dqvq7e-a1df1d93.png]]

## 五、导入数据库表

**数据库分为 Mysql 和 PostgresSql 两种，一个是存储会话，另一个是存储向量，所以两个都要执行！**

### 5.1 Mysql 和 PostgresSql 的 SQL 脚本位置

![[FrztQ1hwEWDFlrqXj4nBG6cuh6QL-ee77a190.png]]

### 5.2 导入 Mysql 数据库表

- 执行 `create_database_mysql.sql` 创建数据库
- 执行 `create_table_mysql.sql` 创建表和数据

### 5.3 导入 PostgresSql 数据库表

- 执行 `create_database_postgres_sql.sql` 创建数据库
- 执行 `create_table_postgres_sql.sql` 创建表和数据

### 5.4 注意：

如果直接执行sql文件报错的话，可以把sql文件中的语句粘贴到图形化工具的控制台中执行

---

**企业级项目导航**：⬅️ [[01-Agent 对话功能如何使用|01-Agent 对话功能如何使用]] | 02-准备项目启动条件 | ➡️ [[03-前端项目部署启动|03-前端项目部署启动]]