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
|