# 🔍 使用 Microsoft Foundry (.NET) 构建企业级 RAG ## 📋 学习目标本笔记演示如何使用 Microsoft Foundry 中的 Microsoft Agent Framework 在 .NET 中构建企业级检索增强生成（RAG）系统。您将学习如何创建可投入生产的代理，这些代理能够搜索文档并提供准确且具上下文感知的响应，同时具备企业级的安全性和可扩展性。 **您将构建的企业级 RAG 功能：** - 📚 文档智能：利用 Azure AI 服务进行高级文档处理 - 🔍 语义搜索：具企业功能的高性能向量搜索 - 🛡️ 安全集成：基于角色的访问控制和数据保护模式 - 🏢 可扩展架构：具监控功能的生产级 RAG 系统 ## 🎯 企业级 RAG 架构 ### 核心企业组件 - **Microsoft Foundry**：具安全和合规性的托管企业 AI 平台 - 持久化代理：带有会话历史和上下文管理的有状态代理 - 向量存储管理：企业级文档索引和检索 - 身份集成：Azure AD 认证和基于角色的访问控制 ### .NET 企业优势 - 类型安全：对 RAG 操作和数据结构的编译时验证 - 异步性能：非阻塞文档处理和搜索操作 - 内存管理：高效利用资源处理大型文档集合 - 集成模式：与 Azure 服务的原生集成及依赖注入 ## 🏗️ 技术架构 ### 企业级 RAG 流水线 ``` Document Upload → Security Validation → Vector Processing → Index Creation ↓ ↓ ↓ User Query → Authentication → Semantic Search → Context Ranking → AI Response ``` ### 核心 .NET 组件 - **Azure.AI.Agents.Persistent**：具状态持久化的企业代理管理 - **Azure.Identity**：集成认证保障 Azure 服务访问安全 - **Microsoft.Agents.AI.AzureAI**：针对 Azure 优化的代理框架实现 - **System.Linq.Async**：高性能异步 LINQ 操作 ## 🔧 企业功能与优势 ### 安全与合规 - **Azure AD 集成**：企业身份管理与认证 - 基于角色的访问：针对文档访问和操作的细粒度权限 - 数据保护：对敏感文档的静态和传输加密 - 审计日志：全面的活动跟踪以满足合规要求 ### 性能与可扩展性 - 连接池：高效管理 Azure 服务连接 - 异步处理：非阻塞操作以支持高吞吐场景 - 缓存策略：智能缓存频繁访问的文档 - 负载均衡：分布式处理支持大规模部署 ### 管理与监控 - 健康检查：内建监控 RAG 系统组件状态 - 性能指标：详尽分析搜索质量和响应时间 - 错误处理：全面异常管理及重试策略 - 配置管理：环境特定设置及验证 ## ⚙️ 先决条件与设置 **开发环境：** - .NET 9.0 SDK 或更高版本 - Visual Studio 2022 或安装 C# 扩展的 VS Code - 拥有 Microsoft Foundry 访问权限的 Azure 订阅 **必需的 NuGet 包：** ```xml ``` **Azure 认证设置：** ```bash # 安装 Azure CLI 并进行身份验证 az login az account set --subscription "your-subscription-id" ``` **环境配置：** * Microsoft Foundry 配置（通过 Azure CLI 自动处理） * 确保您已认证到正确的 Azure 订阅 ## 📊 企业 RAG 模式 ### 文档管理模式 - 批量上传：高效处理大型文档集合 - 增量更新：实时添加和修改文档 - 版本控制：文档版本及变更跟踪 - 元数据管理：丰富的文档属性和分类体系 ### 搜索与检索模式 - 混合搜索：结合语义与关键词搜索，实现最佳效果 - 分面搜索：多维过滤与分类 - 相关性调优：针对特定领域的自定义评分算法 - 结果排名：集成业务逻辑的高级排名 ### 安全模式 - 文档级安全：针对单个文档的细粒度访问控制 - 数据分类：自动敏感度标注与保护 - 审计轨迹：全面记录所有 RAG 操作 - 隐私保护：个人身份信息检测与脱敏功能 ## 🔒 企业安全功能 ### 认证与授权 ```csharp // Azure AD integrated authentication var credential = new AzureCliCredential(); var agentsClient = new PersistentAgentsClient(endpoint, credential); // Role-based access validation if (!await ValidateUserPermissions(user, documentId)) { throw new UnauthorizedAccessException("Insufficient permissions"); } ``` ### 数据保护 - 加密：文档和搜索索引的端到端加密 - 访问控制：与 Azure AD 集成的用户与组权限管理 - 数据驻留：符合法规要求的地理数据位置控制 - 备份与恢复：自动备份及灾难恢复功能 ## 📈 性能优化 ### 异步处理模式 ```csharp // Efficient async document processing await foreach (var document in documentStream.AsAsyncEnumerable()) { await ProcessDocumentAsync(document, cancellationToken); } ``` ### 内存管理 - 流式处理：处理大型文档时避免内存问题 - 资源池化：高效重用昂贵资源 - 垃圾回收：优化的内存分配模式 - 连接管理：合理的 Azure 服务连接生命周期管理 ### 缓存策略 - 查询缓存：缓存频繁执行的搜索 - 文档缓存：内存中缓存热点文档 - 索引缓存：优化的向量索引缓存 - 结果缓存：智能缓存生成的响应 ## 📊 企业使用场景 ### 知识管理 - 企业维基：跨公司知识库的智能搜索 - 政策与流程：自动合规与流程指导 - 培训材料：智能学习与发展辅助 - 研究数据库：学术与研究论文分析系统 ### 客户支持 - 支持知识库：自动化的客户服务响应 - 产品文档：智能产品信息检索 - 故障排除指南：上下文相关的问题解决辅助 - **FAQ 系统**：从文档集合动态生成常见问题解答 ### 法规合规 - 法律文档分析：合同和法律文档智能处理 - 合规监控：自动化法规合规检测 - 风险评估：基于文档的风险分析与报告 - 审计支持：智能文档发现助力审计 ## 🚀 生产部署 ### 监控与可观测性 - **Application Insights**：详尽的遥测与性能监控 - 自定义指标：业务关键指标跟踪与告警 - 分布式追踪：跨服务的端到端请求跟踪 - 健康仪表盘：实时系统健康与性能可视化 ### 可扩展性与可靠性 - 自动扩展：基于负载和性能指标的自动扩缩 - 高可用性：多区域部署及故障转移能力 - 负载测试：企业负载条件下的性能验证 - 灾难恢复：自动备份与恢复流程准备好构建能在大规模处理敏感文档的企业级 RAG 系统了吗？让我们一起为企业设计智能知识系统吧！🏢📖✨ ## 代码实现本课的完整示例代码可在 `05-dotnet-agent-framework.cs` 中找到。运行示例： ```bash # 使脚本可执行（Linux/macOS） chmod +x 05-dotnet-agent-framework.cs # 运行 .NET 单文件应用程序 ./05-dotnet-agent-framework.cs ``` 或直接使用 `dotnet run`： ```bash dotnet run 05-dotnet-agent-framework.cs ``` 代码演示了： 1. 包安装：安装 Azure AI Agents 所需的 NuGet 包 2. 环境配置：加载 Microsoft Foundry 终结点和模型设置 3. 文档上传：上传文档进行 RAG 处理 4. 向量存储创建：为语义搜索创建向量存储 5. 代理配置：设置具备文件搜索能力的 AI 代理 6. 查询执行：针对上传文档执行查询 --- **免责声明**：本文件由 AI 翻译服务 [Co-op Translator](https://github.com/Azure/co-op-translator) 翻译完成。尽管我们力求准确，但请注意，自动翻译可能包含错误或不准确之处。原始语言版文件应视为权威来源。对于重要信息，建议使用专业人工翻译。我们对因使用本翻译而产生的任何误解或误释不承担责任。