# AIRagChatAgent

**Repository Path**: naruto_aI/airag-chat-agent

## Basic Information

- **Project Name**: AIRagChatAgent
- **Description**: 基于MAF组件搭建的AI聊天应用和向量查询
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AiChatAgent

基于 .NET 10 和 Microsoft.Agents.AI 的开源 AI Agent 聊天系统，支持知识库增强（RAG）和多会话管理。

## 项目简介

AiChatAgent 是一个功能完整的 AI 聊天应用，采用 Clean Architecture（整洁架构）设计，支持与大语言模型（LLM）进行对话，并集成了知识库功能，能够上传和管理文档，实现基于知识库的智能问答。

## 核心特性

### 💬 智能对话
- 支持多轮对话，保持上下文
- 流式输出，实时显示 AI 回复
- 会话管理和历史记录
- 支持 Markdown 格式渲染
- 代码语法高亮

### 📚 知识库管理
- 支持多种文档格式：PDF、Markdown、Word、Excel
- 自动文档解析和分块
- 向量化存储（基于 Qdrant）
- 语义搜索和检索
- 文档状态跟踪

### 🏗️ 架构设计
- Clean Architecture 分层架构
- 依赖注入和控制反转
- EFCore ORM + SQLite 数据库
- 向量数据库集成（Qdrant）
- Blazor Server 前端

## 技术栈

### 后端
- **框架**: .NET 10
- **AI 框架**: Microsoft.Agents.AI (RC3)
- **数据库**: SQLite (EFCore 10.0)
- **向量数据库**: Qdrant
- **ORM**: Entity Framework Core
- **API**: Minimal APIs + Scalar

### 前端
- **框架**: Blazor Server
- **UI 组件**: AntDesign Blazor 1.5.1
- **Markdown 渲染**: marked.js + highlight.js
- **样式**: GitHub Markdown CSS

### 文档处理
- **PDF**: PdfPig
- **Word**: DocumentFormat.OpenXml
- **Excel**: EPPlus
- **Markdown**: Markdig

### 日志和监控
- **日志框架**: Serilog
- **日志输出**: Console

## 快速开始

### 环境要求

- .NET 10 SDK
- Qdrant 向量数据库（本地或 Docker）
- OpenAI API Key 或兼容的 LLM API

### 安装步骤

1. 克隆仓库
2. 配置 Qdrant（使用 Docker 或本地安装）
3. 配置 appsettings.json
4. 还原依赖：dotnet restore
5. 运行应用：dotnet run --project src/AiChatAgent.Web
6. 访问：https://localhost:5001

## 功能使用

- /chat - 智能对话
- /knowledge-management - 知识库管理

## API 文档

访问 /scalar 查看 Scalar API 文档。

## 贡献指南

欢迎提交 Issue 和 Pull Request！

## 许可证

MIT License

---

**Happy Coding! 🚀**