企业级 AI 智能体中台:.NET 10 做后端,Vue 3 做管理后台,知识库、技能、记忆、额度都在界面上配。

48 阅读10分钟

NetCoreKevin

企业级 AI 智能体中台:.NET 10 做后端,Vue 3 做管理后台,知识库、技能、记忆、额度都在界面上配。

An enterprise AI-agent platform on .NET 10 — RAG, skills, memory, multi-tenancy and scheduled tasks, with a Vue admin console.

[!NOTE] NetCoreKevin 面向「要在企业内网里落一个 AI 助手 / SaaS 智能体中台」的场景:多租户、登录鉴权、权限点、审计日志、定时任务、模型接入这些地基已经铺好,你只需要接自己的业务数据和业务系统。如果你只是想调一次大模型接口,这个仓库对你来说太重了。

NetCoreKevin 是什么

把「企业里的 AI 助手」拆开,需要的东西其实就四样:

  • 后端:App/WebApi。.NET 10 + EF Core 10 + MySQL,按 Domain / Application / RepositorieRps / WebApi 四层拆分,API 带 v1、v2 版本。
  • AI 能力:Kevin/kevin.Module。kevin.AI.AgentFramework 基于 Microsoft Agent Framework,kevin.RAG 负责切分、向量化与重排,都在同一个进程里,不用额外起 Python 服务。
  • 管理后台:vue/kevin.web.vue。Vue 3 + Ant Design Vue,租户、用户、角色、智能体、知识库、技能、任务、API Key 全在界面上配。
  • 底座:25 个可插拔模块——权限、缓存、消息队列、分布式锁、SignalR、Hangfire、对象存储、短信、邮件、代码生成器。

它不是脚手架 demo:装好依赖、跑完迁移就能登录后台,有菜单、有权限、有定时任务、有审计日志。

特点

智能体是配置出来的,不是写死的

  • 提示词 / 模型 / 参数:每个智能体单独配置,对话模型与向量模型分开选,温度、上下文裁剪都能调。
  • 技能动态加载:技能是 SKILL.md + 脚本(.py / .ps1 / .sh),后台能新建、在线编辑、随时启停,改完不用重新编译。
  • 知识库(RAG):上传文档自动切分写入 Qdrant,检索结果过一遍 qwen3-rerank 重排再喂给模型。
  • 记忆:按「租户 + 智能体 + 用户」三维隔离存在 Qdrant,是否使用记忆挂在智能体开关上。
  • 多智能体协同:主智能体可以把子任务派给其他智能体执行。
  • 上下文压缩:按配置阈值压缩历史消息,长期使用不会越聊越慢、越聊越贵。
  • 联网搜索:接入火山引擎豆包搜索,模型需要新信息时自己去查。
  • 全模态:图片理解、语音转写(阿里 ASR)、文生图(生成后自动上传 OSS)。

能当企业底座用

  • 一库多租户:共享库按 TenantId 隔离,接口层强制过滤,不用每个租户各建一套库。
  • RBAC 权限:菜单与 API 两个维度,权限点跟角色走;调试期可以用 IsOpenPermission 一把关掉。
  • 额度与审计:每用户每月 Token 额度由定时任务颁发、请求时扣减;审计日志、慢查询告警、分环境文件日志都内置。
  • 对外集成:腾讯云 / 阿里云 / 七牛三种对象存储,腾讯与阿里短信,钉钉消息,RabbitMQ / CAP 消息总线,Consul 服务发现,SignalR 实时推送。

给别的客户端留了口子

  • OpenAI 协议兼容接口:GET /v1/models、POST /v1/chat/completions(支持 stream)。Cherry Studio、Dify、自研客户端只要配一个 sk- 开头的 Key 就能接进来;Key 在后台按用户和租户发放,权限校验、工具调用、聊天记录落库与网页端完全一致。
  • MCP:App/WebApiMcp 提供 MCP 服务端,配置里也支持把现有 HTTP 接口包装成 MCP 工具,或把外部 MCP 服务接成智能体工具。

工程化

  • 25 个可插拔模块:每个能力一个 csproj,通过 IModuleInitializer / IModuleConfigTasks 自行注册,加能力不用改入口文件。
  • 代码生成器:按实体一键生成仓储接口、仓储实现、服务接口、服务实现与控制器。
  • 测试:xUnit 单元测试 + 集成测试,共享测试基础设施。
  • 容器化:App/WebApi/Dockerfile 可直接构建镜像。

|

架构

mermaid diagram

各层通过自己的 ModuleInitializer 暴露注册逻辑,由上层统一调用完成 DI 装配:WebApi 只负责启动与管道,业务契约留在 Domain,实现落在 Application 与 RepositorieRps。

目录

路径内容
App/业务应用:Domain、Application、RepositorieRps、WebApi、WebApiMcp
Kevin/框架核心:EF Core(含慢查询拦截器)、Web 基础组件、25 个可插拔模块
vue/kevin.web.vue/Vue 3 + Ant Design Vue 管理后台
Test/xUnit 单元测试、集成测试、共享测试基础设施
Doc/截图与文档资源
InitData/logo(svg + png)与省市区镇等初始化数据

快速开始

你需要准备

项说明
.NET SDK10.0+
Node.js16+,只跑管理后台时需要
MySQL8.0+,建议 utf8mb4
Redis7.0+,缓存、Hangfire、SignalR 都用它
Qdrant1.7+,知识库与记忆功能需要
模型服务任意 OpenAI 协议兼容服务——OpenAI / 智谱 / DeepSeek / 通义等云端 API,或 Ollama 等本地部署,有一个即可

1. 克隆代码

git clone https://gitee.com/netkevin-li/NetCoreKevin.git
cd NetCoreKevin
dotnet restore

GitHub 镜像:github.com/junkai-li/N…

2. 配置连接串

编辑 App/WebApi/appsettings.json:

{
  "ConnectionStrings": {
    "dbConnection": "server=127.0.0.1;port=3306;database=kevin_app;user id=root;password=admin123",
    "redisConnection": "127.0.0.1:6379,DefaultDatabase=0,password=123456"
  }
}

同一个文件里还有 Hangfire、Consul、对象存储、模型服务等配置,按需覆盖;appsettings.Development.json 会覆盖同名项。

3. 初始化数据库

Visual Studio 的程序包管理控制台,默认项目选 Kevin.EntityFrameworkCore,启动项目选 App.WebApi:

Update-Database

或者用 CLI:

dotnet ef database update --project Kevin/Kevin.EntityFrameworkCore --startup-project App/WebApi

[!TIP] 仓库里已经带了历次迁移记录,全新库直接 Update-Database 即可。只有改了实体才需要先 Add-Migration "你的改动" 再更新。

4. 启动后端

dotnet run --project App/WebApi

launchSettings.json 里已经指定 ASPNETCORE_ENVIRONMENT=Development 与 http://localhost:9901。

5. 启动管理后台

cd vue/kevin.web.vue
npm install
npm run serve

开发服务器已把 /VarApi 反向代理到 http://localhost:9901,不需要额外配跨域。

访问地址

服务地址
APIhttp://localhost:9901
Swaggerhttp://localhost:9901/swagger
Hangfire 面板http://localhost:9901/pchangfire
管理后台http://localhost:8080

Hangfire 面板默认走 Basic Auth,账号密码取 appsettings.json 的 HangfireSetting.userSetting(默认 admin / admin)。

默认账户

用户名密码租户
admin1234561000

[!WARNING] 以上都是本地开发默认值。上线前请替换数据库密码、Jwt.Key、Hangfire 账号,以及 AESInfo 的 Key / IV——Key 与 IV 必须是 16/24/32 与 16 字节,且一旦变更,历史密文将无法解密。

AI 能力配置

1. 启动 Qdrant

docker run -d --name qdrant -p 6333:6333 -v qdrant_storage:/qdrant/storage qdrant/qdrant

QdrantClientSetting 默认指向 localhost,本机跑的话不用改。

2. 配置模型

向量模型与对话模型在后台「模型管理」里配,也可以直接改 appsettings.json。模型接入走 OpenAI 协议:只要服务商提供 OpenAI 兼容接口,填好地址、模型名和 Key 就能用——OpenAI、智谱、DeepSeek、通义、Kimi、vLLM、Ollama 都在支持范围内。下面以智谱和 Ollama 为例:

云端服务(以智谱为例,注册地址;换成其它 OpenAI 兼容服务的地址和 Key 即可):

{
  "OllamaApiSetting": {
    "Url": "https://open.bigmodel.cn/api/paas/v4/embeddings",
    "DefaultModel": "embedding-3",
    "ApiKey": "your-api-key"
  }
}

Ollama(本地,原生接口不传 ApiKey):

{
  "OllamaApiSetting": {
    "Url": "http://localhost:11434/api/embeddings",
    "DefaultModel": "qwen3:4b"
  }
}

重排模型走 AliRerankApiSetting(默认 qwen3-rerank),不配也能用,只是检索结果不做二次排序。

3. 跑通第一个智能体

  1. 登录后台,进入模型管理,配置对话模型与向量模型。
  2. 新建知识库,选择向量模型(维度需与 QdrantClientSetting.MemoryEmbeddingSize 一致,默认 2048),上传文档等待向量化完成。
  3. 新建智能体:选对话模型,绑知识库,按需勾选技能与记忆。
  4. 新建对话,开始聊。

4. 用 Ollama 跑本地模型(可选)

  • 支持 macOS、Windows、Linux 与 Docker 部署,官方下载:ollama.com/download
  • 硬件建议:4 核以上 CPU、16GB 以上内存、足够的磁盘空间;想跑大模型或微调再上 NVIDIA GPU。
  • 拉一个能跑得动的小模型先试:
ollama run qwen3:4b

然后在后台把对话模型的地址指向 http://localhost:11434。

5. 自动任务(Hangfire)

默认以 Redis 作为 Hangfire 存储,注入方式可在 Kevin.Hangfire/ServiceCollectionExtensions 里调整。

继承 IModuleConfigTasks 实现 ConfigTasks,任务会在启动时自动注册,并且可以直接调用应用服务:

/// <summary>
/// AIKmssTasks 配置任务设置
/// </summary>
public class AIKmssModuleConfigTasks : IModuleConfigTasks
{
    /// <summary>
    /// 配置任务
    /// </summary>
    public Task<bool> ConfigTasks(IRecurringJobManager recurringJobManager)
    {
        recurringJobManager.AddOrUpdate<IAIKmssService>(
            recurringJobId: "每6分钟检测是否有AI文档知识库需要处理",   // 唯一 ID,后续修改或删除都用它
            (s) => s.ProcessKmssVectorData(default),
            "0 0/6 0/1 * * ? ",
            new RecurringJobOptions
            {
                TimeZone = TimeZoneInfo.Local,   // 指定时区,默认 UTC
            }
        );
        return Task.FromResult(true);
    }
}

项目结构

kevin.abp.core/
├── App/                    # 业务应用
│   ├── Application/        # 应用服务层
│   ├── Domain/             # 领域层
│   ├── RepositorieRps/     # 仓储实现
│   ├── AppShare/           # 跨层共享 DTO
│   ├── WebApi/             # API 入口
│   └── WebApiMcp/          # MCP 服务端
├── Kevin/                  # 框架核心
│   ├── Application/        # 核心服务(含 AI)
│   ├── Domain/             # 核心领域模型
│   ├── Kevin.EntityFrameworkCore/   # EF Core 实现(含慢查询拦截器、迁移)
│   ├── Kevin.Web.Basics/   # Web 基础组件(控制器、全局过滤器)
│   ├── RepositorieRps/     # 核心仓储实现
│   ├── kevin.Share/        # 共享 DTO、枚举、常量
│   └── kevin.Module/       # 可插拔模块(25 个)
│       ├── kevin.AI.AgentFramework/  # 智能体框架
│       ├── Kevin.RAG/                # 检索增强(Qdrant / Ollama / Rerank)
│       ├── Kevin.Authentication.Jwt/ # JWT 认证
│       ├── kevin.Permission/         # RBAC 权限
│       ├── kevin.Cache/              # 缓存
│       ├── Kevin.Hangfire/           # 任务调度
│       ├── Kevin.SignalR/            # 实时通信
│       ├── kevin.Cap/ · kevin.RabbitMQ/  # 消息总线
│       ├── Kevin.SMS/ · Kevin.Email/ · kevin.FileStorage/
│       ├── kevin.DistributedLock/ · Kevin.SnowflakeId/
│       └── ...                       # ASR、Consul、代码生成器等
├── Test/                   # 测试套件
│   ├── Kevin.Web.Test/     # 单元测试(xUnit)
│   ├── Kvin.Integration.Tests/  # 集成测试
│   └── Testing.Shared/     # 共享测试基础设施
├── vue/kevin.web.vue/      # 管理后台(Vue 3 + Ant Design Vue)
├── Doc/                    # 文档与截图
└── InitData/               # 初始化数据

功能模块

模块功能状态
用户 / 角色 / 权限用户 CRUD、角色 CRUD、菜单与 API 权限点✅
多租户一库多租户、租户级数据隔离✅
AI 智能体智能对话、工具调用、多智能体协同、上下文压缩✅
知识库文档上传、切分向量化、RAG 检索与重排✅
技能(Skill)在线编辑、动态启停、脚本执行、地址白名单校验✅
记忆租户 + 智能体 + 用户三维隔离✅
多模态图片理解、语音转写、文生图✅
OpenAI 兼容/v1/models、/v1/chat/completions、Key 管理✅
任务调度Hangfire 定时任务与面板✅
Token 额度月度额度颁发、请求扣减✅
文件存储腾讯云 / 阿里云 / 七牛✅
消息服务钉钉消息、站内 SignalR 推送✅

现状与不足

坦白说,下面这些是使用前应该知道的事实:

  • 向量维度绑定模型:MemoryEmbeddingSize 默认 2048,对应智谱 embedding-3;换 embedding 模型要同步改维度并重建集合,否则检索会报维度不匹配。
  • 模型 Key 要自备:OllamaApiSetting、AliRerankApiSetting、AliyunAsr、DoubaoSearchApiSetting 默认留空或指向智谱示例,没配的能力不可用,也不会伪造结果。
  • 迁移不会自动跑:项目没有启动时自动迁移,升级代码后要自己 Update-Database。
  • 外部服务要自己开通:短信、邮件、对象存储的密钥默认是空值,用到时再去 appsettings.json 填。
  • 一键部署还没做:docker-compose.yml 目前是空文件,MySQL、Redis、Qdrant 需要自己准备,本地起三个容器即可。
  • 前端构建链偏旧:Vue CLI 5(webpack),还没迁到 Vite。
  • AI 默认值按通用场景给:提示词、上下文压缩阈值、工具编排这些默认值不一定适合你的业务,需要按场景调。

文档资源