143 lines
3.2 KiB
Markdown
143 lines
3.2 KiB
Markdown
|
# 保险智能客服系统 — 快速启动指南
|
|||
|
|
|
|||
|
|
## 一、环境要求
|
|||
|
|
|
|||
|
|
| 依赖 | 版本 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| Docker Desktop | 最新 | 启动后等待引擎就绪 |
|
|||
|
|
| Python | 3.12 | 用于运行配置脚本 |
|
|||
|
|
|
|||
|
|
## 二、启动步骤
|
|||
|
|
|
|||
|
|
### 1. 启动 Docker Desktop
|
|||
|
|
|
|||
|
|
双击 Docker Desktop 图标，等待右下角图标变绿。
|
|||
|
|
|
|||
|
|
### 2. 启动所有服务
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd d:/work/code/python/coding/baodanagent
|
|||
|
|
docker compose -f docker-compose.baodan.yml up -d
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
等待约 2 分钟，首次启动需要拉取镜像。
|
|||
|
|
|
|||
|
|
### 3. 访问系统
|
|||
|
|
|
|||
|
|
| 服务 | 地址 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| **BaoDan 管理后台** | http://localhost:3000 | 首次访问需设置管理员账号 |
|
|||
|
|
| **Vue 前端** | http://localhost:8080 | 需先 `cd frontend && pnpm dev` |
|
|||
|
|
| **BaoDan API** | http://localhost:5001 | 含保险模块接口 |
|
|||
|
|
|
|||
|
|
### 4. 首次登录 BaoDan
|
|||
|
|
|
|||
|
|
1. 打开 http://localhost:3000
|
|||
|
|
2. 设置管理员邮箱和密码
|
|||
|
|
3. 进入后台
|
|||
|
|
|
|||
|
|
### 5. 配置 LLM 模型
|
|||
|
|
|
|||
|
|
1. BaoDan 后台 → 设置 → 模型供应商
|
|||
|
|
2. 添加模型（如 OpenAI / DeepSeek / 通义千问）
|
|||
|
|
3. 填入 API Key
|
|||
|
|
|
|||
|
|
### 6. 创建对话应用
|
|||
|
|
|
|||
|
|
1. BaoDan 后台 → 创建应用 → 聊天助手
|
|||
|
|
2. 名称：`保险智能问答`
|
|||
|
|
3. 配置 Prompt（保险行业知识问答）
|
|||
|
|
4. 关联知识库（上传保险产品文档）
|
|||
|
|
5. 发布 → 获取 API Key
|
|||
|
|
|
|||
|
|
### 7. 创建 Workflow 应用（产品推荐）
|
|||
|
|
|
|||
|
|
详见 [BaoDan_Workflow配置指南.md](BaoDan_Workflow配置指南.md)
|
|||
|
|
|
|||
|
|
### 8. 配置 API Key
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python scripts/setup_baodan_api_keys.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
按提示输入对话应用和 Workflow 应用的 API Key。
|
|||
|
|
|
|||
|
|
### 9. 重启服务
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
docker compose -f docker-compose.baodan.yml restart baodan-api baodan-worker
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 10. 启动前端（可选）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd frontend
|
|||
|
|
pnpm dev
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
打开 http://localhost:8080
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 三、日常使用
|
|||
|
|
|
|||
|
|
### 启停命令
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 启动
|
|||
|
|
docker compose -f docker-compose.baodan.yml up -d
|
|||
|
|
|
|||
|
|
# 停止
|
|||
|
|
docker compose -f docker-compose.baodan.yml down
|
|||
|
|
|
|||
|
|
# 查看日志
|
|||
|
|
docker logs baodanagent-baodan-api-1 -f
|
|||
|
|
|
|||
|
|
# 重启 API（代码更新后）
|
|||
|
|
docker compose -f docker-compose.baodan.yml restart baodan-api
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 修改代码后
|
|||
|
|
|
|||
|
|
保险模块代码在 `api/insurance/` 目录。修改后需要：
|
|||
|
|
|
|||
|
|
1. 重新构建镜像：
|
|||
|
|
```bash
|
|||
|
|
docker compose -f docker-compose.baodan.yml build baodan-api
|
|||
|
|
docker compose -f docker-compose.baodan.yml up -d baodan-api
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. 或者挂载模式（开发时推荐）：在 docker-compose.baodan.yml 的 baodan-api 服务中添加：
|
|||
|
|
```yaml
|
|||
|
|
volumes:
|
|||
|
|
- ./api/insurance:/app/api/insurance
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 四、端口说明
|
|||
|
|
|
|||
|
|
| 端口 | 服务 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| 3000 | BaoDan Web | 管理后台 + 对话界面 |
|
|||
|
|
| 5001 | BaoDan API | 含保险模块接口 |
|
|||
|
|
| 8080 | Vue 前端 | 保险客服前端 |
|
|||
|
|
| 5433 | PostgreSQL | Docker 内数据库 |
|
|||
|
|
| 6380 | Redis | Docker 内缓存 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 五、常见问题
|
|||
|
|
|
|||
|
|
**Q: 容器启动失败？**
|
|||
|
|
A: 检查端口是否被占用：`netstat -ano | grep :5001`
|
|||
|
|
|
|||
|
|
**Q: 数据库连接失败？**
|
|||
|
|
A: 确认 PostgreSQL 容器在运行：`docker ps | grep db`
|
|||
|
|
|
|||
|
|
**Q: API 返回 401？**
|
|||
|
|
A: 检查 JWT_SECRET 是否配置正确
|
|||
|
|
|
|||
|
|
**Q: 产品推荐报错？**
|
|||
|
|
A: 确认已创建 Workflow 应用并配置了 API Key
|