NetCoreKevin

🧰基于Ollama部署本地模型

• Ollama 支持多种操作系统，包括 macOS、Windows、Linux 以及通过 Docker 容器运行。
• Ollama 对硬件要求不高，旨在让用户能够轻松地在本地运行、管理和与大型语言模型进行交互。
• CPU：多核处理器（推荐 4 核或以上）。
• GPU：如果你计划运行大型模型或进行微调，推荐使用具有较高计算能力的 GPU（如 NVIDIA 的 CUDA 支持）。
• 内存：至少 8GB RAM，运行较大模型时推荐 16GB 或更高。
• 存储：需要足够的硬盘空间来存储预训练模型，通常需要 10GB 至数百 GB 的空间，具体取决于模型的大小。
• Ollama 官方下载地址：https://ollama.com/download
• 1.安装后运行模型 可根据电脑配置自由选择模型 可以使用qwen3:4b来进行测试
• ollama run qwen3:4b
• 系统配置如下
• 

📦上手教程

• 第一步 项目启动与配置 Redis和数据库连接字符串
• json配置文件请配置好数据库链接默认使用MySQL（可自行更改）EFCore框架(不熟悉的可以看看微软官网文档) 其他需要调整和配置json:'ConnectionStrings'，'HangfireRedisSetting'，'SignalrRdisSetting'

• 第二步（默认账户admin，密钥：123456，租户1000）
• 执行初始化数据库命令：在vs中“程序包管理控制台”选择Kevin.EntityFrameworkCore项目 执行NuGet命令 Add-Migration "初始化数据库" 在执行=》 Update-Database 执行完成后开始第三步

• 第三步
• 启动App.WebApi第一次启动会初始化种子数据 种子数据配置可以在kevin.Domain.BaseDatas下面查看和更改 启动后通过http://localhost:9901/swagger/index.html路由查看接口页面和如下页面
• 第四步
• 在vue文件夹下面启动前端 前端运行步骤：1、安装依赖npm install 2、运行npm run serve 3、打包npm run build

🧰AI智能体教程

• 第一步
• 请先完成上手教程在进行AI智能体教程
• 第二步
• 下载安装Qdrant--官网有教程 安装后配置json文件QdrantClientSetting 默认是localhost不需要动的
• 第三步
• 注册AI账户 教程以智谱AI为例 去[官网](https://open.bigmodel.cn)注册登录后获取APIKey
• 第四步
• 配置向量模型和对话模型默认如下

||| |--|--|

• 第五步
• 新建知识库选择向量模型(如果不选择请在json配置中配置)2048（默认）：最高精度，适合对准确性要求极高的场景===》配置智能体==》新建对话就OK了

🌐 新项目使用教程(基于NetCoreKevin进行二次开发)

项目地址：https://gitee.com/netkevin-li/ainet - 1.新建项目直接引用Kevin.Web.Basics - - 2.copy所有的appsettings.json文件到新项目还有Program的代码 - 3.调整配置文件的数据库和redis配置以及json中MigrationsAssembly为新项目的程序集，如上图应设“AINet.Domain” - 4.项目结构可参考上图或者开源架构中的App模块 - 5.因为引用的Kevin.Web.Basics模块 后续更新同步只需拉取NetCoreKevin新代码，好处是可以即保持框架更新也可以开发自己的业务

:envelope: NetCoreKevin前言

基于NET搭建-AI知识库智能体-现代化Saas企业级前后端分离架构：前端Vue3、IDS4单点登录、多缓存、自动任务、分布式、一库多租户、日志、授权和鉴权、CAP集成事件、SignalR、领域事件、MCP协议服务、IOC模块化注入、代码生成器、自动任务、AI、AgentFramework智能体、AISemanticKernel集成、RAG检索增强、AI知识库、AI联网搜索 解耦设计都可以单独引用项目启动时注意相关Redis、db链接配置等相关配置详情可见下面的上手教程

🌐 自动任务配置（Hangfire）

默认基于redis方式注册Hangfire可在Kevin.Hangfire.ServiceCollectionExtensions自行添加或调整注入方式

1.继承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);
        } 
    }

🧠 AI 集成说明

• Skill 工具使用：基于Agent-Framework 语义理解框架，实现自然语言处理及技能（Skill）的调用与编排。
• Tools 工具自定义开发：支持自定义 AI 工具开发，如 OCR 验证码识别等图像识别工具。
• MCP 服务：用于 AI 服务之间的通信与协议扩展。
• Agent-Framework 框架开发：借助 Agent 开发框架构建智能代理，支持多步推理与任务自动化。