baodan/docs/快速启动指南.md

保险智能客服系统 — 快速启动指南

一、环境要求

依赖	版本	说明
Docker Desktop	最新	启动后等待引擎就绪
Python	3.12	用于运行配置脚本

二、启动步骤

1. 启动 Docker Desktop

双击 Docker Desktop 图标，等待右下角图标变绿。

2. 启动所有服务

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

8. 配置 API Key

python scripts/setup_baodan_api_keys.py

按提示输入对话应用和 Workflow 应用的 API Key。

9. 重启服务

docker compose -f docker-compose.baodan.yml restart baodan-api baodan-worker

10. 启动前端（可选）

cd frontend
pnpm dev

打开 http://localhost:8080

---

三、日常使用

启停命令

# 启动
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. 重新构建镜像：

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 服务中添加：

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