NetCoreKevin — 国产 .NET 企业级 AI 中台智能体开源架构
基于 .NET 9 构建的企业级 AI 中台智能体 SaaS 前后端分离架构,开箱即用集成 AI 知识库、多智能体协同、Skill 技能管理、本地离线大模型、AI 联网搜索、智能体权限管控、一库多租户、分布式微服务 等核心能力,是国产 .NET 阵营中少有的"开箱即用级"企业 AI 中台底座。
🎯 一句话定位
NetCoreKevin = 一个能跑在国产化基础设施上的、面向企业的、All-in-One 的 .NET AI Agent 平台。
- 🇨🇳 国产开源:MIT 协议,Gitee 主仓库,活跃维护
- 🏢 企业级:多租户、权限、审计、分布式缓存、消息队列、任务调度全栈齐备
- 🧠 AI Native:RAG、多智能体、Skill、记忆、流式对话、语音通话——不是 Demo,是生产可用
- ⚙️ .NET 9 + DDD + 微服务:领域驱动 + Consul/CAP/Hangfire 解耦,性能与可维护性兼得
- 🔌 模型中立:支持智谱 / 通义 / DeepSeek / OpenAI 等云端模型,也支持 Ollama 本地离线模型
✨ 核心特性速览
| 维度 | 能力 | 说明 |
|---|---|---|
| 🧠 AI 大脑 | AgentFramework 1.9 | 内置企业级智能体框架,对话 / 工具调用 / 规划统一抽象 |
| 🧩 Skills | 技能动态管理 | 技能在线注册、编辑、加载、权限控制,热生效无需重启 |
| 📚 知识库 | AI-Qdrant 知识库 | 基于 Qdrant 向量数据库的 RAG 检索增强 |
| 🔁 检索增强 | RAG + 重排模型 | 向量召回 + Rerank 二阶段排序,答案更准 |
| 🤝 协同 | 多智能体协同 | 多 Agent 编排、角色分工、上下文共享 |
| 💬 长记忆 | 聊天记录压缩策略 | 历史消息自动摘要压缩,突破上下文窗口限制 |
| 🌐 联网 | AI 联网搜索 | 内置联网搜索技能,让 Agent 拥有实时信息能力 |
| 🔐 安全 | 智能体权限管控 | 菜单/API/数据/技能 四级 RBAC,租户隔离 |
| 💾 离线 | 本地 Ollama 模型 | 支持 qwen3、llama3 等本地模型,完全离线不联网 |
| 🧠 长期记忆 | 智能体记忆 | 跨会话记忆用户偏好与上下文 |
| 🏢 多租户 | 一库多租户 | 单库多租户,接口层强制租户过滤 |
| 📡 实时 | SignalR 实时推送 | 流式对话、Token 逐字打字机效果 |
| 📞 语音 | AI 语音电话模式 | Agent 可外呼/接听电话,语音对话 |
| ⏰ 调度 | Hangfire 分布式任务 | 定时巡检、知识库向量异步构建、自动任务编排 |
| 📨 消息 | RabbitMQ + CAP | 事件总线 + 分布式事务,微服务解耦 |
| 🖥️ 前端 | Vue3 + Ant Design Vue | 管理后台开箱即用,Vite 构建,反向代理已配置 |
🏗️ 整体架构
NetCoreKevin 采用前后端分离 + 微服务 + DDD 分层架构,AI 能力以可插拔模块方式融入业务平台:
| 层级 | 模块 | 职责 |
|---|---|---|
| 接入层 | Kevin.WebApi / Vue3 | API 网关、管理后台 |
| 应用层 | App.Application | 用例编排、DTO 转换 |
| 领域层 | App.Domain / Kevin.Domain | 业务模型、领域服务 |
| AI 中台层 | Kevin.AI.AgentFramework / Kevin.RAG | 智能体、RAG、向量检索 |
| 基础设施层 | EF Core / Redis / Qdrant / RabbitMQ / Ollama | 数据、缓存、向量、消息、推理 |
| 调度层 | Kevin.Hangfire / Consul | 定时任务、服务注册发现 |
| 实时层 | Kevin.SignalR | 长连接、流式响应、语音 |
| 横切层 | Kevin.Cache / Kevin.Permission / Kevin.Authentication.Jwt | 缓存、权限、认证 |
🧠 AI 智能体核心能力(重点介绍)
1. 多智能体协同 + 聊天记录压缩策略
让多个 Agent 分工协作,自动压缩长对话历史,永远在 LLM 上下文窗口内"装得下"。
- 多智能体动态配置:在管理后台为不同业务场景编排专属 Agent(客服 Agent、研发 Agent、运营 Agent…)
- 聊天记录压缩策略:当会话轮次或 Token 数超过阈值,自动调用 LLM 生成摘要压缩,控制成本同时保留关键信息
- 上下文共享:多个 Agent 之间可共享上下文片段,实现"上一个 Agent 查到的东西,下一个 Agent 直接用"
- 角色编排:支持为 Agent 指定 system prompt、可用技能、可用知识库、可用工具
2. AI 知识库 + RAG 检索增强(Qdrant)
文档上传 → 自动切片 → 向量化 → Qdrant 存储 → 检索时重排 → 喂给 LLM,全流程闭环。
- 多格式文档支持:PDF / Word / Markdown / TXT / 网页
- 智能切片:按段落/语义切片,保留上下文
- 向量化:默认使用智谱
embedding-3(2048 维),可切换 OpenAI / Ollama 本地 Embedding - Qdrant 向量数据库:高性能 Rust 实现,单机可承载亿级向量
- 重排模型(Rerank):粗排 + 精排二阶段检索,大幅提升答案准确率
- 异步构建:文档上传后由 Hangfire 后台异步向量化,不阻塞前端
3. Skills 技能管理(动态加载 + 权限管控)
像"插件市场"一样管理 Agent 能使用的工具,在线编辑、热加载、细粒度授权。
- 技能在线管理:后台可视化注册技能,配置参数、描述、入参 Schema
- 动态加载:技能变更无需重启服务,立即对 Agent 生效
- 权限可控:每个 Agent 只能调用被授权的技能,杜绝越权调用工具
- 内置技能:
- 🔍 AI 联网搜索(联网)
- 📚 知识库问答(RAG)
- 💻 代码执行
- 🗄️ 数据库查询
- 📧 邮件 / 短信发送
- 📞 AI 语音电话
- 🛠️ 自定义技能(开发者自由扩展)
4. 本地 Ollama 离线 AI 模型
政企、金融、涉密场景的"刚需"——完全离线运行,数据不出内网。
- 支持
qwen3:4b/llama3/mistral等任意 Ollama 模型 - 硬件门槛低:4 核 CPU + 8GB 内存即可运行小模型
- 配置简单:
{
"OllamaApiSetting": {
"Url": "http://localhost:11434/api/embeddings",
"DefaultModel": "qwen3:4b"
}
}
- 同时支持云端模型(智谱、OpenAI、通义、DeepSeek)与本地模型混合调度
5. 智能体记忆(短期 + 长期)
- 短期记忆:当前会话上下文,自动管理 Token 预算
- 长期记忆:跨会话记住关键事实,例如"该用户是 VIP,偏好日语沟通"
- 可遗忘:支持记忆的过期与清除,遵守数据合规要求
6. AI 语音电话模式
Agent 不仅能打字,还能打电话——真正的 Voice Agent。
- 基于 SignalR + 实时语音流(ASR/TTS)
- 支持电话外呼场景:回访、通知、调研、催办
- 支持呼入场景:智能客服 IVR
- 通话过程可被 Agent 实时转写、分析、归档
7. SignalR 流式对话
- Token 级别流式输出,对话体验顺滑
- 支持打字机效果、思考中动画、引用高亮
- 支持多人协作会话(多人同看一个对话流)
🏢 企业级能力
一库多租户(SaaS 必备)
- 单库多租户:降低运维复杂度,节省成本
- 接口层强制租户过滤:开发者无需手动加
Where(tenantId),由框架自动注入 - 租户级数据隔离:用户、角色、知识库、Agent 配置全部按租户隔离
- 支持混合云部署:可按租户路由到不同数据库
权限与安全
| 安全机制 | 实现 |
|---|---|
| JWT 认证 | Kevin.Authentication.Jwt |
| RBAC 权限 | kevin.Permission,菜单/API/按钮/数据四级 |
| 时序安全密钥 | 防重放攻击 |
| 密码哈希 | BCrypt + Salt,防彩虹表 |
| 慢 SQL 告警 | EF Core 拦截器,自动捕获慢查询 |
| 全链路日志 | log4net 多级别日志 |
分布式与微服务
- Consul:服务注册与发现
- CAP + RabbitMQ:分布式事务 + 事件总线(最终一致性)
- Hangfire:分布式定时任务(基于 Redis)
- Redis:分布式缓存 + Session + SignalR 背板
- 雪花 ID:分布式唯一主键生成器
高可用
- 应用服务无状态,可任意水平扩展
- 数据库读写分离友好(基于 EF Core)
- 向量库 Qdrant 支持集群模式
- 消息队列削峰填谷,保护下游
🛠️ 技术栈
| 类别 | 技术 |
|---|---|
| 后端框架 | .NET 9 / ASP.NET Core / EF Core |
| 架构风格 | DDD + 微服务 + 分层 |
| 数据库 | MySQL 8.0+ |
| 缓存 | Redis 7.0+ |
| 向量库 | Qdrant 1.7+ |
| 消息队列 | RabbitMQ + CAP |
| 实时通信 | SignalR |
| 任务调度 | Hangfire |
| 服务治理 | Consul |
| AI 模型 | Ollama(本地)/ 智谱 / OpenAI / DeepSeek / 通义 |
| AI 框架 | AgentFramework 1.9 |
| 前端 | Vue 3 + Vite + Ant Design Vue + Pinia |
| 日志 | log4net |
| 鉴权 | JWT |
| License | MIT |
🚀 5 分钟快速体验
# 1. 克隆
git clone https://gitee.com/netkevin-li/NetCoreKevin.git
# 2. 启动 Qdrant(向量库)
docker run -p 6333:6333 qdrant/qdrant
# 3. 配置数据库连接(appsettings.json)
# 4. EF Core 迁移
Add-Migration "初始化数据库"
Update-Database
# 5. 启动后端
cd App/WebApi && dotnet run
# 6. 启动前端(管理后台)
cd vue/kevin.web.vue && npm install && npm run serve
| 服务 | 地址 |
|---|---|
| API | http://localhost:9901 |
| Swagger | http://localhost:9901/swagger |
| Hangfire | http://localhost:9901/pchangfire |
| 管理后台 | http://localhost:8080 |
默认账户:admin / 123456(租户 1000)
🧩 内置功能模块
| 模块 | 功能 | 状态 |
|---|---|---|
| 用户管理 | 用户 CRUD、权限绑定 | ✅ |
| 角色管理 | 角色 CRUD、权限配置 | ✅ |
| 权限管理 | 菜单权限、API 权限、数据权限 | ✅ |
| AI 智能体 | 智能对话、工具调用、流式响应 | ✅ |
| 知识库 | 文档管理、向量化、RAG 检索、重排 | ✅ |
| Skills | 技能注册、热加载、权限控制 | ✅ |
| 任务调度 | Hangfire 定时任务 | ✅ |
| 消息推送 | 钉钉、企业微信、短信、邮件 | ✅ |
| 文件存储 | 多云存储(本地/OSS/COS) | ✅ |
| AI 语音 | 语音电话、ASR/TTS | ✅ |
| 实时通信 | SignalR 流式对话 | ✅ |
| 多租户 | 一库多租户、租户路由 | ✅ |
🎯 典型应用场景
- 🏭 企业内部 AI 助手:员工问制度、查流程、订会议室、报修统统搞定
- 🎧 智能客服系统:7×24h 在线,自动回答产品/订单/物流问题,复杂问题转人工
- 📚 企业知识库问答:把制度文档、产品手册喂给 Agent,新员工秒变老员工
- 🛒 电商导购 Agent:商品推荐、参数对比、用户评价摘要
- 🏥 医疗 / 政务辅助问答:本地 Ollama 离线部署,数据不出内网
- 📞 AI 外呼机器人:回访、通知、调研、催办,自动生成通话纪要
- 💼 研发 Copilot:代码生成、Bug 分析、文档撰写、知识检索
🌐 国产化适配
- ✅ Gitee 主仓库,国内访问速度拉满
- ✅ 完全支持本地 Ollama 离线大模型,可运行于国产 CPU/GPU(昇腾/天数等可通过适配层接入)
- ✅ 数据库、缓存、消息队列均支持国产替代方案(达梦、人大金仓、Redis国产分支、国产MQ)
- ✅ MIT 协议,可商用、可二次开发、可作为企业内部平台底座
- ✅ 文档中文,配套 CSDN 教学专栏,学习曲线友好
📊 项目结构
kevin.abp.core/
├── App/ # 业务应用模块
│ ├── Application/ # 应用服务层
│ ├── Domain/ # 领域层
│ ├── RepositorieRps/ # 仓储实现
│ └── WebApi/ # API 入口
├── Kevin/ # 核心框架模块(30+ 可插拔模块)
│ ├── Kevin.AI.AgentFramework/ # AI 智能体框架
│ ├── Kevin.RAG/ # RAG 检索增强
│ ├── Kevin.SignalR/ # 实时通信
│ ├── Kevin.Hangfire/ # 任务调度
│ ├── Kevin.Authentication.Jwt/ # JWT 认证
│ ├── kevin.Permission/ # RBAC 权限
│ ├── kevin.Cache/ # 缓存
│ └── ... # 雪花ID、分布式锁、邮件、短信……
├── Test/ # 单元测试 + 集成测试
├── vue/kevin.web.vue/ # 前端管理后台(Vue3 + Ant Design Vue)
├── Doc/ # 文档资源
└── InitData/ # 初始化数据
📖 文档资源
- 📘 项目 Wiki 完整教程(架构、模块、API、部署运维)
- 📗 SYSTEM_DOCUMENTATION.md(快速入门详细文档)
- 📕 CSDN 教学专栏
- 🧪 二次开发示例项目 ainet
⭐ Star History
如果这个项目对你有帮助,欢迎在 Gitee 上点 ⭐ 支持!
一颗 Star,就是国产 .NET AI 生态向前一步。
🤝 交流社区
项目维护者:NetCoreKevin 开发团队
- 仓库地址gitee:gitee.com/netkevin-li…
- 仓库地址github:github.com/junkai-li/N…
- License:MIT(可商用、可二次开发)
💬 为什么选择 NetCoreKevin?
| 你在找什么 | NetCoreKevin 给你的 |
|---|---|
| 一个能跑在 .NET 上的 AI Agent 平台 | ✅ AgentFramework 1.9,开箱即用 |
| 一个能离线运行的本地 AI 方案 | ✅ Ollama + Qdrant 全本地化 |
| 一个支持 RAG 知识库的中台 | ✅ 文档上传→切片→向量化→检索→重排→LLM 全链路 |
| 一个支持多租户的 SaaS 底座 | ✅ 一库多租户 + 租户级数据权限 |
| 一个前后端分离的微服务架构 | ✅ DDD + Consul + CAP + Hangfire + SignalR |
| 一个国产、可商用、有中文文档的项目 | ✅ MIT + Gitee + 中文 Wiki + CSDN 教程 |
| 一个能让 Agent 打电话的系统 | ✅ AI 语音电话模式 |
| 一个支持多智能体协同的框架 | ✅ 多 Agent 编排 + 记忆 + 上下文共享 + 压缩 |
NetCoreKevin —— 让每一家中国企业,都能拥有自己的 AI 中台。 🚀