zhimaxu blog

智能客服PRD

Sat, 13 Jun 2026 00:00:00 GMT

智能客服 PRD v1#

一、项目概述#

基于 Agnes AI 三模型（文本、图像、视频），使用 Vue 3 + FastAPI 前后端分离架构，构建支持多渠道接入的 AI 智能客服系统。

二、目标用户#

面向普通消费者，用于网站/小程序/App 等渠道的客户咨询服务。

三、系统架构#

3.1 技术栈#

层级	技术
前端	Vue 3 + Vite + Element Plus
后端	Python FastAPI
业务数据库	MySQL
向量数据库	Qdrant
AI 模型	Agnes AI（模型版本可动态配置）
文件转换	python-docx、pandas、pdfplumber
部署	Docker + Docker Compose + Nginx

3.2 核心模块#

模块	职责
前端 (Vue 3)	聊天界面、文件/图片上传、数据看板、后台管理（RBAC + 用户 + 菜单管理）
后端 (FastAPI)	REST API、会话管理、路由到不同 Agnes 模型、文件转换
知识库	静态文档（Markdown 导入/转换）+ 动态数据库，检索走向量数据库
MySQL	用户、会话、对话历史、知识库条目、统计数据、角色配置
Qdrant	知识库文档向量化存储，语义检索

四、功能模块#

4.1 聊天核心#

4.1.1 多轮对话#

用户发送消息，后端调用配置的文本模型返回 AI 回复
对话上下文通过 MySQL 存储，每次对话携带最近 N 轮消息（可配置，默认 10 轮）
支持流式输出（SSE），降低用户感知延迟

4.1.2 图片识别#

用户上传图片后，后端调用配置的图像识别模型进行图像理解
返回图片描述，AI 结合上下文生成回复

4.1.3 视频理解#

用户上传视频后，后端调用配置的视频分析模型进行视频分析
返回视频关键帧描述或摘要，AI 基于描述生成回复

4.1.4 转人工#

支持三种触发模式（后台配置）：
- 用户主动触发：用户点击”转人工”按钮
- AI 自动触发：AI 识别到问题不在知识库范围内（置信度低于阈值），主动建议转人工
- 两者结合：以上两种方式均可触发
转人工后，AI 对话历史自动同步给人工客服

4.2 知识库管理#

4.2.1 静态文档管理#

支持 Markdown 文件直接导入
导入后自动分块（chunk），调用 embedding 存入 Qdrant
支持按分类/标签检索

4.2.2 动态数据库管理#

后台 CRUD 管理 FAQ/产品信息/公告等
每条记录自动向量化存储到 Qdrant
支持搜索、筛选、批量导入导出

4.2.3 知识库小工具#

文件转换：支持 PDF、Word（.docx）、Excel（.xlsx）上传，自动转换为 Markdown 格式
- 转换完整保留：文字、表格、图片尽量保留原格式
- 图片转为 base64 嵌入或引用链接
- Excel 的每个 Sheet 转为独立的 Markdown 表格
在线预览：转换后支持左右分栏预览
- 左侧显示原文（PDF 渲染 / Word 预览 / Excel 表格）
- 右侧显示转换后的 Markdown 代码
对比编辑：可在线编辑 Markdown 内容
- 实时预览渲染效果（右侧分栏改为三栏：原文 + Markdown 代码 + 渲染预览）
下载导出：支持下载转换后的 Markdown 文件（.md 格式）
转换记录：记录每次转换历史，支持批量转换和多文件上传
一键入库：转换预览满意后，可直接将 Markdown 内容导入知识库

4.3 数据分析#

4.3.1 对话统计#

今日/本周/本月对话总量趋势图
平均响应时长、峰值时段分布
在线用户数实时监控

4.3.2 常见问题分析#

Top 10 用户提问词频统计
未匹配知识的问题聚类分析（用于补充知识库）

4.3.3 用户满意度#

对话结束后主动弹出满意度问卷
默认好评（默认 5 星，用户可修改或留言）
统计维度：好评率、各角色评分分布

4.4 后台管理#

4.4.1 RBAC 角色权限管理#

基于 RBAC（Role-Based Access Control）模型设计，通过角色-权限映射控制后台操作权限。

数据模型：

表名	字段	说明
admin_user	id, username, password_hash, email, avatar, status, created_at, updated_at	管理员账号表
role	id, name, code, description, status, created_at	角色表
permission	id, name, code, resource, action, description	权限表
role_permission	role_id, permission_id	角色-权限关联表
user_role	user_id, role_id	管理员-角色关联表
menu	id, parent_id, name, path, component, icon, sort_order, visible, type（菜单/按钮）, created_at	菜单表

预设角色：

角色	说明	权限范围
超级管理员	拥有全部权限	所有模块的增删改查
运营管理员	负责日常运营	知识库管理、数据分析、角色配置
客服主管	监控服务质量	数据分析、转人工管理、满意度查看
普通客服	日常接待	聊天核心、转人工

权限粒度：

资源级别：聊天、知识库、数据分析、角色管理、用户管理、系统配置
操作级别：查看、新增、编辑、删除、导出
每个角色的权限通过勾选矩阵配置，支持细粒度控制

4.4.2 菜单管理#

管理后台左侧导航菜单，支持树形结构和动态加载。

功能列表：

菜单树：树形结构展示所有菜单节点，支持拖拽排序
菜单类型：
- 一级菜单：左侧导航栏的顶级菜单项
- 子菜单：菜单下的二级/三级菜单项
- 按钮权限：菜单下的操作按钮（如”新增""编辑""删除”）
菜单属性：
- 菜单名称、路径（路由）、组件路径、图标、排序号
- 可见性（显示/隐藏）
- 关联权限码（与 permission 表绑定）
角色菜单绑定：为每个角色分配可见的菜单列表
- 超级管理员：可见全部菜单
- 其他角色：仅可见分配的菜单
前端动态渲染：
- 登录后调用 /api/admin/menu/roles 获取当前角色的菜单树
- 前端根据菜单树动态生成侧边栏导航
- 按钮级权限通过指令 v-permission 控制显隐
预设菜单：

菜单	子菜单	路径	组件
聊天核心	会话列表	`/chat/sessions`	ChatSessions
知识库管理	文档管理	`/knowledge/docs`	KnowledgeDocs
知识库管理	动态数据	`/knowledge/data`	KnowledgeData
知识库管理	小工具	`/knowledge/tools`	KnowledgeTools
数据分析	对话统计	`/stats/chat`	StatsChat
数据分析	常见问题	`/stats/questions`	StatsQuestions
数据分析	满意度	`/stats/satisfaction`	StatsSatisfaction
客服工作台	会话管理	`/agent/sessions`	AgentSessions
后台管理	用户管理	`/admin/users`	AdminUsers
后台管理	角色管理	`/admin/roles`	AdminRoles
后台管理	菜单管理	`/admin/menus`	AdminMenus
后台管理	系统配置	`/admin/config`	AdminConfig
系统配置	AI 模型配置	`/admin/ai-models`	AdminAiModels
系统配置	数据归档	`/admin/archive`	AdminArchive

4.4.3 用户管理#

管理后台管理员账号及其权限分配。

功能列表：

用户列表：分页展示所有管理员账号，支持按用户名/邮箱/状态搜索
新增用户：填写用户名、密码、邮箱、头像，分配一个或多个角色
编辑用户：修改基本信息、重置密码、切换状态（启用/禁用）
删除用户：软删除，标记 status = disabled
用户日志：记录登录时间、操作记录（谁在什么时候做了什么）

4.4.4 客服工作台#

客服人员在后台查看用户聊天记录并主动介入对话，界面采用聊天软件形式（类似微信/QQ 的对话窗口）。

功能列表：

会话列表：左侧展示所有正在进行的会话列表
- 显示用户昵称、最后一条消息、会话状态（AI 接待中 / 人工接待中 / 已结束）
- 未读消息数红点提示
- 支持按状态筛选、按时间排序、搜索用户
会话详情：右侧展示聊天窗口，样式参考常见聊天软件
- 消息气泡形式展示对话内容（用户消息靠右、客服/AI 消息靠左）
- 支持消息类型：文本、图片、视频
- 消息时间戳显示
- 自动滚动到底部，新消息实时推送（WebSocket）
用户信息面板：右侧边栏展示当前用户信息
- 用户基本信息（昵称、头像、注册时间）
- 当前会话状态（AI 接待中 / 人工接待中）
- 订单状态、用户等级、来源渠道
- 历史会话快捷入口
主动接管：客服可随时从 AI 手中接管会话
- 点击”接入对话”按钮，会话状态从 AI 接待中切换为人工接待中
- 接管后 AI 停止自动回复，客服以聊天窗口形式直接回复
- 接管时自动通知用户：“客服已为您接入”
- 支持撤回 AI 已发送的不合适回复
快捷回复：提升客服效率
- 预设常用回复话术（可后台配置），客服一键发送
- 支持自定义话术分类（问候语、产品介绍、售后政策等）
- 支持组合多条消息连续发送
会话结束：
- 客服主动结束当前会话
- 会话结束后自动归档，对话记录存入 MySQL
- 可发起满意度评价
多会话并发：客服可同时接待多个用户
- 每个会话以 Tab 标签页形式展示
- 后台可配置最大并发会话数（默认 5）
- 超出上限时新会话排队等待

4.4.5 系统配置#

管理后台全局系统参数，各配置项通过键值对方式存储在 MySQL system_config 表中。

功能列表：

基础配置
- 系统名称、LOGO 设置
- 系统公告/维护通知
- 会话超时时间（默认 30 分钟无操作自动结束）
- 默认轮数保留（多轮对话携带消息数，默认 10）
- 默认满意度评分阈值（低于此值触发回访）
转人工配置
- 转人工触发模式（用户主动 / AI 自动 / 两者结合）
- AI 自动转人工的置信度阈值（默认 0.3）
- 转人工排队策略（轮询 / 按负载分配 / 按角色匹配）
数据归档配置
- 数据保留天数（默认 90 天）
- 归档压缩格式（默认 .tar.gz）
- 归档邮件发送间隔（默认每日凌晨 2 点）
- SMTP 服务器参数（地址、端口、发件人、授权码）
满意度配置
- 问卷弹出时机（对话结束后立即 / 延迟 5 分钟）
- 默认好评星级（默认 5 星）
- 是否允许用户修改评分
- 是否显示留言输入框
多渠道配置
- 各渠道接入参数（网站嵌入脚本、小程序 AppID、App Secret）
- 各渠道聊天窗口样式（颜色、位置、尺寸）
- 各渠道欢迎语（不同渠道可配不同文案）
文件转换配置
- 单次最大上传大小（默认 50MB）
- 支持的文件类型（PDF / DOCX / XLSX）
- 知识库单文件上限（默认 100MB）
- 自动分块大小（默认 500 字符/块）

4.4.6 AI 模型配置#

AI 模型配置
- 文本模型：配置文本生成模型的 API 地址、API Key、模型版本（默认 agnes-2.0-flash）
- 图像模型：配置图像识别模型的 API 地址、API Key、模型版本（默认 agnes-image-2.1-flash）
- 视频模型：配置视频分析模型的 API 地址、API Key、模型版本（默认 agnes-video-v2.0）
- 模型切换：支持运行时切换模型版本，无需重启服务
- 健康检查：定期检查各模型 API 连通性，异常时告警

4.4.7 AI 客服角色管理#

区别于后台管理员角色，这是 AI 客服本身的角色配置。

4.4.7.1 多角色管理#

支持创建多个客服角色，每个角色独立配置：
- 角色名称（如”售后客服""售前咨询""技术支持”）
- 系统提示词（角色人设、语气、专业领域）
- 关联知识库（不同角色可绑定不同知识库）

4.4.7.2 辅助信息自动切换#

根据辅助信息自动切换角色：
- 订单状态（待付款、待发货、已发货、已签收、售后中）
- 用户等级（普通用户、VIP、企业客户）
- 来源渠道（网站、小程序、App）
切换规则在后台配置（条件 → 角色映射表）
无匹配规则时，使用默认角色

4.5 数据归档#

归档策略：对话数据保留 90 天
归档方式：超过保留期的对话数据压缩打包为 .tar.gz 格式
邮件通知：归档文件通过附件发送到管理员配置的邮箱
邮箱配置：管理员可在网页端配置 SMTP 服务器地址、端口、发件人邮箱、授权码
清理规则：归档文件在邮件发送成功后从主库清理，压缩文件保留 180 天后自动删除

五、API 设计#

5.1 聊天相关#

方法	路径	说明
POST	`/api/chat`	发送消息，返回 AI 回复（模型版本通过配置读取）
POST	`/api/upload/image`	上传图片，调用图像识别模型
POST	`/api/upload/video`	上传视频，调用视频分析模型
POST	`/api/chat/transfer`	转人工客服

5.2 知识库相关#

方法	路径	说明
GET	`/api/knowledge`	获取知识库列表
POST	`/api/knowledge`	导入/更新知识库
DELETE	`/api/knowledge/:id`	删除知识库条目
POST	`/api/tools/convert`	文件转 Markdown（PDF/Word/Excel）
GET	`/api/tools/history`	获取转换历史记录
GET	`/api/tools/download/:id`	下载转换后的 Markdown 文件

5.3 数据分析#

方法	路径	说明
GET	`/api/stats/chat`	对话统计数据
GET	`/api/stats/top-questions`	常见问题 Top 10
GET	`/api/stats/satisfaction`	满意度统计

5.4 后台管理（RBAC + 用户）#

方法	路径	说明
POST	`/api/admin/login`	管理员登录，返回 JWT
GET	`/api/admin/me`	获取当前管理员信息
GET	`/api/admin/users`	获取管理员用户列表
POST	`/api/admin/users`	创建管理员用户
PUT	`/api/admin/users/:id`	更新管理员用户
DELETE	`/api/admin/users/:id`	禁用管理员用户
GET	`/api/admin/roles`	获取角色列表
POST	`/api/admin/roles`	创建角色
PUT	`/api/admin/roles/:id`	更新角色
DELETE	`/api/admin/roles/:id`	删除角色
GET	`/api/admin/permissions`	获取权限列表
PUT	`/api/admin/roles/:id/permissions`	分配角色权限
GET	`/api/admin/logs`	获取操作日志

5.4.1 菜单管理#

方法	路径	说明
GET	`/api/admin/menu/tree`	获取菜单树（含按钮）
GET	`/api/admin/menu/roles`	获取当前角色菜单树（前端路由用）
GET	`/api/admin/menus`	获取菜单列表（分页）
POST	`/api/admin/menus`	创建菜单
PUT	`/api/admin/menus/:id`	更新菜单
DELETE	`/api/admin/menus/:id`	删除菜单

5.5 系统配置#

方法	路径	说明
GET	`/api/system/config`	获取所有系统配置
GET	`/api/system/config/:key`	获取单个配置项
PUT	`/api/system/config/:key`	更新单个配置项
PUT	`/api/system/config/batch`	批量更新配置

5.6 客服工作台#

方法	路径	说明
GET	`/api/agent/sessions`	获取会话列表（支持状态筛选）
GET	`/api/agent/sessions/:id`	获取会话详情（消息列表）
POST	`/api/agent/sessions/:id/takeover`	客服接管会话（AI → 人工）
POST	`/api/agent/sessions/:id/reply`	客服主动回复
POST	`/api/agent/sessions/:id/quick-reply`	使用快捷回复
POST	`/api/agent/sessions/:id/ai-recall`	撤回 AI 消息
POST	`/api/agent/sessions/:id/close`	结束会话
GET	`/api/agent/sessions/:id/user`	获取用户详细信息
GET	`/api/agent/quick-replies`	获取快捷回复列表
POST	`/api/agent/quick-replies`	新增/更新快捷回复

5.7 AI 客服角色与配置#

方法	路径	说明
GET	`/api/config/roles`	获取角色列表
POST	`/api/config/roles`	创建/更新角色
DELETE	`/api/config/roles/:id`	删除角色
GET	`/api/config/switch-rules`	获取自动切换规则
PUT	`/api/config/switch-rules`	配置自动切换规则
GET	`/api/config/email`	获取邮箱配置
PUT	`/api/config/email`	配置 SMTP 邮箱

5.8 数据归档#

方法	路径	说明
POST	`/api/archive/run`	手动触发归档
GET	`/api/archive/status`	查看归档状态

5.9 AI 模型配置#

方法	路径	说明
GET	`/api/config/ai-models`	获取所有模型配置
GET	`/api/config/ai-models/:type`	获取指定类型模型配置（text/image/video）
PUT	`/api/config/ai-models/:type`	更新指定类型模型配置
POST	`/api/config/ai-models/:type/test`	测试指定类型模型连通性

七、多渠道接入#

网站：JavaScript 嵌入脚本，悬浮聊天窗口
微信小程序：小程序组件接入
App：SDK / H5 页面嵌入

八、非功能性需求#

消息响应时间 < 3s
支持并发 ≥ 100 用户
对话数据保留 90 天后归档，压缩文件保留 180 天清理
文件转换支持单次最大 50MB
知识库文档最大单文件 100MB，自动分块存储

产品需求文档

Sat, 13 Jun 2026 00:00:00 GMT

状态图#

stateDiagram-v2 [*] --> 草稿草稿 --> 审核中 : 提交审核中 --> 已发布 : 批准审核中 --> 草稿 : 拒绝已发布 --> [*]

类图#

classDiagram class User { +String name +login() +logout() } class Article { +String title +publish() } User "1" -- "*" Article : 写作

饼图#

pie title 流量来源 "搜索引擎" : 45.6 "直接访问" : 30.1 "社交媒体" : 15.3 "其他" : 9.0

甘特图#

gantt title 项目时间线 dateFormat YYYY-MM-DD section 设计需求分析 :a1, 2025-01-01, 7d UI设计 :a2, after a1, 10d section 开发前端开发 :b1, after a2, 15d 后端开发 :b2, after a2, 18d

时序图#

sequenceDiagram participant User as 用户 participant Server as 服务器 User->>Server: 发送请求 Server-->>User: 返回响应

流程图#

graph TD A[开始] --> B{条件检查} B -->|是| C[处理步骤 1] B -->|否| D[处理步骤 2] C --> E[结束] D --> E

常用网站

Sat, 13 Jun 2026 00:00:00 GMT

序号	网站简称	类型	网址
1	Mermaid墨美图表	doc	https://www.momeitubiao.com/
2	Firefly Astro 文档	doc	https://docs-firefly.cuteleaf.cn/zh/
3	随机密码	tool	https://www.avast.com/zh-cn/random-password-generator#pc
4
5
6
7
8
9
10

安装CC Switch

Fri, 12 Jun 2026 00:00:00 GMT

1.下载#

从CC SWitch下载对应安装包

注：Github Proxy 代理加速

2.安装#

没什特殊的

3.配置#

本地ollama&&Agnes AI

3.1本地Ollama#

打开CC Switch右上角添加供应商
下滑自定义供应商
step 1

step 2
模型可以获取后再设置无需手动输入

3.2本地Agnes AI#

注：当前Agens AI是全球Top 10的AI实验室推出的全模态大模型，无限期免费，支持文本、图片、视频全模态，在多个权威评测榜单上跑分超过GPT 5.4和DeepSeek V4 Pro

注册Agens AI 账号
点击右上角的”进入API平台”按钮，或直接访问
使用邮箱、Google或GitHub账号快速注册登录（无需绑定银行卡）
登录后，点击左侧导航栏的”API Keys”（API密钥）
点击”创建新的密钥”按钮
输入一个名称（如”Claude Code”），然后点击”创建”
复制生成的API Key（以sk-开头），妥善保存，关闭窗口后可在操作处直接复制
打开CC Switch右上角添加供应商
step 3

step 4
模型可以获取后再设置无需手动输入

3.3 CC Switch 启动路由#

左上角设置
step 5

3.3.1 验证配置是否成功#

win+r 输入cmd 回车
在终端内输入claude回车
启动后输入一个简单的问题测试,例如：“5月1日是什么节日”
如果Claude Code 能够正常回复,说明配置成功！
实用技巧1：不想一直确认权限可以：
Terminal window
```
1
claude --dangerously-skip-permissions
```
或者在配置json中添加
```
1
"skipDangerousModePermissionPrompt": true,
```

4.异常问题处理#

访问异常：配置json中添加
```
1
"skipWebFetchPreflight": true,
```
因为Claude Code在访问网页前会调用 Anthropic 的服务来判断网页是否可以访问,这里直接给他权限读取全部的域名访问,就没有限制了

安装Claude Code

Fri, 12 Jun 2026 00:00:00 GMT

前置要求#

注：安装成功时是这个版本号，以及本文档仅适用于windows

软件	版本	状态
git	2.53.0.windows.2	✅
node	24.16.0	✅
vscode	1.142.2	✅
CC Switch	3.16.2	✅

CC Switch 内也可以直接安装Claude但是我没试过

1.安装#

win+r 输入cmd回车
在终端上按住ctrl并打开新的终端 (管理员权限)

在终端内执行

Terminal window

1
npm config set registry https://registry.npmmirror.com/
2
npm config get registry
3
npm install -g @anthropic-ai/claude-code

等待完成后打开新的终端输入
Terminal window
```
1
claude --version
```
显示版本号就说明安装完成

如果提示”claude不是内部或外部命令”，请重启电脑后再试

2.跳过登录#

跳过首次联网校验 (关键！否则还会报地区错误)

win+r 输入cmd回车 ps md $env:USERPROFILE\.claude echo '{"hasCompletedOnboarding":true}' > $env:USERPROFILE\.claude\settings.json

3.安装技能#

部分技能存储路径比较怪，或者无法搜索到，这种情况直接网页下载压缩包安装

离线安装路径：
Terminal window
```
1
%USERPROFILE%\.claude\skills
```
在线安装

安装范围 (推荐选择”User”，全局可用)

如遇install无反应则使用离线安装/从vscode使用/plug安装
1. 运行Claude
2. 安装skill-creator (官方技能创建工具)
  Terminal window
```
1
/plugin marketplace add anthropics/skills
2
/plugin install skill-creator@anthropics
```
  - 使用方式：“使用skill-creator创建一个名为deploy-check的技能，用于执行部署前检查清单”
  - Claude会自动生成符合官方规范的技能文件结构
安装web-access (网页访问与搜索技能)
Terminal window
```
1
/plugin marketplace add browserbase/skills
2
/plugin install browse@browserbase
```
- 使用方式：“5月1日是什么节日”
安装playwright-cli (浏览器自动化技能)

这里是直接在终端内运行
Terminal window
```
1
npm install -g @playwright/cli@latest
2
playwright install chromium
```
如遇playwright install 报错,使用playwright-cli install即可

这里是回到Claude
Terminal window
```
1
playwright-cli install --skills
```
- 使用方式：“截取百度首页的截图并保存为baidu.png”,这里保存图片可能会报错要多试几次，或者单纯打开浏览器并指定网页
会遇到无返回值的问题，详见第8步
安装superpowers (全流程开发增强技能)
Terminal window
```
1
/plugin marketplace add obra/superpowers-marketplace
2
/plugin install superpowers@superpowers-marketplace
```
- 使用方式：直接输入：“/brainstorming 用React做一个待办事项应用，支持添加、删除、标记完成”
- Superpowers会自动引导你完成整个开发流程：
  1. 需求分析与确认
  2. 技术选型与方案设计
  3. 任务拆分与计划制定
  4. 代码编写与实现
  5. 测试验证与代码审查
验证所有技能是否安装成功
1. 重启Claude
  Terminal window
```
1
/skills
```
2. skill-creator、browse、playwright-cli和superpowers都在列表中(如果没找到但是可以打开浏览器,可以搜索那就不管)
3. 输入以下命令可以查看所有可用插件命令 ```ps /help

安装常用语言LSP

让Claude code更好的理解代码仓库

Terminal window

1
/plugin install typescript-lsp@claude-plugins-official
2
/plugin install pyright-lsp@claude-plugins-official
3
/plugin install gopls-lsp@claude-plugins-official

安装agnes-ai 的skill(离线安装)
1. 下载 (百度网盘) agens-ai
@小白Debug 分享的,这里我没搞明白md怎么直接连接到本地文件进行下载所以上传到网盘了

API key是过期的,需要让Claude替换,在生成图片那边会遇到问题

Demo

Fri, 12 Jun 2026 00:00:00 GMT

zhimaxu blog

智能客服PRD

智能客服 PRD v1#

一、项目概述#

二、目标用户#

三、系统架构#

3.1 技术栈#

3.2 核心模块#

四、功能模块#

4.1 聊天核心#

4.1.1 多轮对话#

4.1.2 图片识别#

4.1.3 视频理解#

4.1.4 转人工#

4.2 知识库管理#

4.2.1 静态文档管理#

4.2.2 动态数据库管理#

4.2.3 知识库小工具#

4.3 数据分析#

4.3.1 对话统计#

4.3.2 常见问题分析#

4.3.3 用户满意度#

4.4 后台管理#

4.4.1 RBAC 角色权限管理#

4.4.2 菜单管理#

4.4.3 用户管理#

4.4.4 客服工作台#

4.4.5 系统配置#

4.4.6 AI 模型配置#

4.4.7 AI 客服角色管理#

4.4.7.1 多角色管理#

4.4.7.2 辅助信息自动切换#

4.5 数据归档#

五、API 设计#

5.1 聊天相关#

5.2 知识库相关#

5.3 数据分析#

5.4 后台管理（RBAC + 用户）#

5.4.1 菜单管理#

5.5 系统配置#

5.6 客服工作台#

5.7 AI 客服角色与配置#

5.8 数据归档#

5.9 AI 模型配置#

七、多渠道接入#

八、非功能性需求#

产品需求文档

状态图#

类图#

饼图#

甘特图#

时序图#

流程图#

常用网站

安装CC Switch

1.下载#

2.安装#

3.配置#

3.1本地Ollama#

3.2本地Agnes AI#

3.3 CC Switch 启动路由#

3.3.1 验证配置是否成功#

4.异常问题处理#

安装Claude Code

前置要求#

1.安装#

2.跳过登录#

3.安装技能#

Demo

这是个简单的测试#