AI 原生开放教材

外观

AI Agents for Beginners（微软官方入门课）系统课程·英文原文 ↗原件 ↓仓库 ↗

🔍 使用 Microsoft Foundry (.NET) 构建企业级 RAG ​

📋 学习目标 ​

本笔记演示如何使用 Microsoft Foundry 中的 Microsoft Agent Framework 在 .NET 中构建企业级检索增强生成（RAG）系统。您将学习如何创建可投入生产的代理，这些代理能够搜索文档并提供准确且具上下文感知的响应，同时具备企业级的安全性和可扩展性。

您将构建的企业级 RAG 功能：

  • 📚 <strong>文档智能</strong>：利用 Azure AI 服务进行高级文档处理
  • 🔍 <strong>语义搜索</strong>：具企业功能的高性能向量搜索
  • 🛡️ <strong>安全集成</strong>：基于角色的访问控制和数据保护模式
  • 🏢 <strong>可扩展架构</strong>：具监控功能的生产级 RAG 系统

🎯 企业级 RAG 架构 ​

核心企业组件 ​

  • Microsoft Foundry：具安全和合规性的托管企业 AI 平台
  • <strong>持久化代理</strong>：带有会话历史和上下文管理的有状态代理
  • <strong>向量存储管理</strong>：企业级文档索引和检索
  • <strong>身份集成</strong>：Azure AD 认证和基于角色的访问控制

.NET 企业优势 ​

  • <strong>类型安全</strong>：对 RAG 操作和数据结构的编译时验证
  • <strong>异步性能</strong>：非阻塞文档处理和搜索操作
  • <strong>内存管理</strong>：高效利用资源处理大型文档集合
  • <strong>集成模式</strong>：与 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 集成：企业身份管理与认证
  • <strong>基于角色的访问</strong>：针对文档访问和操作的细粒度权限
  • <strong>数据保护</strong>：对敏感文档的静态和传输加密
  • <strong>审计日志</strong>：全面的活动跟踪以满足合规要求

性能与可扩展性 ​

  • <strong>连接池</strong>：高效管理 Azure 服务连接
  • <strong>异步处理</strong>：非阻塞操作以支持高吞吐场景
  • <strong>缓存策略</strong>：智能缓存频繁访问的文档
  • <strong>负载均衡</strong>：分布式处理支持大规模部署

管理与监控 ​

  • <strong>健康检查</strong>：内建监控 RAG 系统组件状态
  • <strong>性能指标</strong>：详尽分析搜索质量和响应时间
  • <strong>错误处理</strong>：全面异常管理及重试策略
  • <strong>配置管理</strong>：环境特定设置及验证

⚙️ 先决条件与设置 ​

开发环境：

  • .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 模式 ​

文档管理模式 ​

  • <strong>批量上传</strong>：高效处理大型文档集合
  • <strong>增量更新</strong>：实时添加和修改文档
  • <strong>版本控制</strong>：文档版本及变更跟踪
  • <strong>元数据管理</strong>：丰富的文档属性和分类体系

搜索与检索模式 ​

  • <strong>混合搜索</strong>：结合语义与关键词搜索，实现最佳效果
  • <strong>分面搜索</strong>：多维过滤与分类
  • <strong>相关性调优</strong>：针对特定领域的自定义评分算法
  • <strong>结果排名</strong>：集成业务逻辑的高级排名

安全模式 ​

  • <strong>文档级安全</strong>：针对单个文档的细粒度访问控制
  • <strong>数据分类</strong>：自动敏感度标注与保护
  • <strong>审计轨迹</strong>：全面记录所有 RAG 操作
  • <strong>隐私保护</strong>：个人身份信息检测与脱敏功能

🔒 企业安全功能 ​

认证与授权 ​

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");
}

数据保护 ​

  • <strong>加密</strong>：文档和搜索索引的端到端加密
  • <strong>访问控制</strong>：与 Azure AD 集成的用户与组权限管理
  • <strong>数据驻留</strong>：符合法规要求的地理数据位置控制
  • <strong>备份与恢复</strong>：自动备份及灾难恢复功能

📈 性能优化 ​

异步处理模式 ​

csharp
// Efficient async document processing
await foreach (var document in documentStream.AsAsyncEnumerable())
{
    await ProcessDocumentAsync(document, cancellationToken);
}

内存管理 ​

  • <strong>流式处理</strong>：处理大型文档时避免内存问题
  • <strong>资源池化</strong>：高效重用昂贵资源
  • <strong>垃圾回收</strong>：优化的内存分配模式
  • <strong>连接管理</strong>：合理的 Azure 服务连接生命周期管理

缓存策略 ​

  • <strong>查询缓存</strong>：缓存频繁执行的搜索
  • <strong>文档缓存</strong>：内存中缓存热点文档
  • <strong>索引缓存</strong>：优化的向量索引缓存
  • <strong>结果缓存</strong>：智能缓存生成的响应

📊 企业使用场景 ​

知识管理 ​

  • <strong>企业维基</strong>：跨公司知识库的智能搜索
  • <strong>政策与流程</strong>：自动合规与流程指导
  • <strong>培训材料</strong>：智能学习与发展辅助
  • <strong>研究数据库</strong>：学术与研究论文分析系统

客户支持 ​

  • <strong>支持知识库</strong>：自动化的客户服务响应
  • <strong>产品文档</strong>：智能产品信息检索
  • <strong>故障排除指南</strong>：上下文相关的问题解决辅助
  • FAQ 系统：从文档集合动态生成常见问题解答

法规合规 ​

  • <strong>法律文档分析</strong>：合同和法律文档智能处理
  • <strong>合规监控</strong>：自动化法规合规检测
  • <strong>风险评估</strong>：基于文档的风险分析与报告
  • <strong>审计支持</strong>：智能文档发现助力审计

🚀 生产部署 ​

监控与可观测性 ​

  • Application Insights：详尽的遥测与性能监控
  • <strong>自定义指标</strong>：业务关键指标跟踪与告警
  • <strong>分布式追踪</strong>：跨服务的端到端请求跟踪
  • <strong>健康仪表盘</strong>：实时系统健康与性能可视化

可扩展性与可靠性 ​

  • <strong>自动扩展</strong>：基于负载和性能指标的自动扩缩
  • <strong>高可用性</strong>：多区域部署及故障转移能力
  • <strong>负载测试</strong>：企业负载条件下的性能验证
  • <strong>灾难恢复</strong>：自动备份与恢复流程

准备好构建能在大规模处理敏感文档的企业级 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. <strong>包安装</strong>：安装 Azure AI Agents 所需的 NuGet 包
  2. <strong>环境配置</strong>：加载 Microsoft Foundry 终结点和模型设置
  3. <strong>文档上传</strong>：上传文档进行 RAG 处理
  4. <strong>向量存储创建</strong>：为语义搜索创建向量存储
  5. <strong>代理配置</strong>：设置具备文件搜索能力的 AI 代理
  6. <strong>查询执行</strong>：针对上传文档执行查询