一、平台核心定位
KB Admin 是一套面向企业 / 开发者的一站式 AI 智能体(Agent)管理平台,主打「知识库问答 + 大模型对话 + 可编排技能」的一体化能力,支持零代码快速搭建行业专属 AI 助手,解决企业知识沉淀、智能客服、业务自动化、场景化问答等核心需求,是打造私有化 / 行业化大模型应用的低代码底座。
二、核心业务场景
企业智能客服 / 知识问答助手:将企业文档、产品手册、行业规范等上传构建专属知识库,实现用户 7×24 小时智能问答,自动解答业务咨询、售后问题,大幅降低人工客服成本。
行业专属 AI 顾问:针对政策解读、技术咨询(如 NFC 技术)、专业领域场景,搭建具备行业知识沉淀的专属 AI 助手,提供精准、合规的专业解答。
企业内部知识助手:整合内部培训资料、流程文档、制度文件,为员工提供智能问答、流程指引、知识检索服务,提升内部协作效率。
多模态智能体应用开发:支持文本、语音、图像多模态交互,搭配自定义工具技能,实现业务自动化(如数据查询、流程审批、外部接口调用)的智能体搭建。
三、核心功能模块详解
1. 仪表盘:全局数据概览
实时统计核心业务数据:机器人数量、总对话数、今日对话量、Token 消耗、7 天活跃用户、好评 / 差评数据,直观掌握 AI 助手运行状态与用户反馈。
提供「快速开始」引导流程,三步完成从模型配置到机器人上线的全流程操作,降低新手使用门槛。
2. 模型管理:多模型统一接入
支持全类型 AI 模型接入:包括 LLM 文本模型(如 DeepSeek、智谱系列)、Embedding 向量模型、VLM 视觉模型、ASR 语音识别模型、Reranker 精排模型,覆盖文本、语音、图像全场景需求。
提供「自动发现模型」与「手动添加」两种接入方式,支持主流大模型 API 一键配置,兼容智谱、DeepSeek 等国内外主流模型服务商,满足不同场景的性能与成本需求。
3. 工具与技能:可编排的 Agent 能力扩展
支持「工具服务 + Agent 技能 + MCP 服务器」三层能力扩展,遵循 agentskills.io 开放标准,可快速接入自定义工具、外部接口,为 AI 助手赋予业务自动化能力。
提供示例库、一键导入、新建技能功能,开发者可零代码 / 低代码编排工具逻辑,实现如数据查询、外部 API 调用、业务流程自动化等复杂能力,让 AI 从 “问答” 升级为 “可执行任务的智能体”。
4. 机器人管理:全生命周期 AI 助手运营
可视化管理多 AI 机器人:支持创建、配置、测试、发布全流程管理,可同时搭建多个不同场景的 AI 助手(如政策解读助手、技术咨询助手)。
提供机器人配置、测试对话、小程序入口生成能力,一键生成可嵌入小程序 / 网页的对话入口,快速落地业务场景;同时支持对话数据统计与知识库绑定,实现机器人与专
一、项目整体架构设计
本项目采用前后端分离 + 微服务模块化架构,基于大模型生态构建RAG 知识库 + Agent 智能体核心能力,整体分为五层架构,确保高可用、易扩展、易维护:
接入层:Web 管理后台、第三方 API 接口、小程序 / 网页对话入口
应用层:机器人管理、对话交互、技能编排、用户运营
核心能力层:RAG 知识库引擎、Agent 智能调度、多模型统一管理
服务层:文件处理、向量计算、文本分块、日志审计、数据统计
基础设施层:数据库、向量库、缓存、对象存储、服务器环境
二、技术栈选型
前端(管理后台)
框架:Vue3 / Element Plus
构建:Vite
功能:可视化配置、表单编辑、数据仪表盘、实时对话测试
后端
语言:Python / Java(二选一,主流为 Python)
框架:FastAPI / SpringBoot
核心 SDK:LangChain(RAG+Agent)、大模型 API(智谱 / DeepSeek 等)
数据存储
业务库:MySQL / PostgreSQL
向量库:Chroma / Milvus / FAISS
缓存:Redis
文件存储:本地 / OSS
中间件与工具
文档解析:PyPDF2、python-docx、unstructured
文本分块:递归分块、语义分块
接口文档:Swagger / ReDoc
部署:Docker + Nginx
三、核心模块实现流程
1. 多模型管理模块实现
定义统一模型接口规范,兼容 LLM、Embedding、ASR、VLM 等模型
提供 API 密钥配置、模型状态启停、调用次数统计
实现模型自动负载、失败重试、异常熔断机制
前端可视化展示模型列表、状态、用量数据
2. RAG 知识库模块实现(核心)
文档上传:支持 PDF/Word/TXT/Excel 批量上传
内容解析:提取文本、清洗格式、去除冗余内容
智能分块:按段落 / 语义 / 长度自动切块
向量生成:调用 Embedding 模型生成向量
向量入库:存储到向量数据库并建立索引
检索问答:用户问题 → 检索相似知识 → 拼接 Prompt → 大模型回答
3. Agent 智能体与技能编排实现
定义技能模板(工具入参、出参、调用逻辑)
支持 HTTP 接口、数据库查询、自定义函数等工具接入
大模型负责意图识别 + 工具选择 + 参数填充 + 结果总结
支持多技能串行 / 并行编排,形成业务自动化流程
4. 机器人管理模块实现
新建机器人:绑定知识库、选择模型、配置提示词
风格设定:正式 / 简洁 / 专业 / 幽默等
在线调试:实时对话测试、查看检索过程、优化提示词
发布上线:生成 API / 网页 / 小程序嵌入地址
5. 对话与运营模块实现
对话实时存储、历史记录回溯
好评 / 差评标记、不满意人工介入