更新日志 - AZD 初学者指南

简介

此更新日志记录了 AZD 初学者指南仓库中所有显著的变更、更新和改进。我们遵循语义版本控制原则，并维护此日志以帮助用户了解各版本之间的变化。

学习目标

通过查看此更新日志，您将能够：

• 了解新增功能和内容
• 理解现有文档的改进
• 跟踪错误修复和更正以确保准确性
• 了解学习材料随时间的演变

学习成果

在查看更新日志条目后，您将能够：

• 识别可用于学习的新内容和资源
• 理解哪些章节已更新或改进
• 根据最新材料规划您的学习路径
• 提供反馈和建议以促进未来改进

版本历史

[v3.8.0] - 2025-11-19

高级文档：监控、安全性和多代理模式

此版本新增了关于应用程序洞察集成、身份验证模式以及生产部署中多代理协调的全面 A 级课程。

新增

• ** 应用程序洞察集成课程**：位于 docs/pre-deployment/application-insights.md：

  • 专注于 AZD 的自动部署和配置
  • 提供完整的 Bicep 模板（应用程序洞察 + 日志分析）
  • 包含 1,200+ 行自定义遥测的 Python 应用程序
  • AI/LLM 监控模式（Azure OpenAI 令牌/成本跟踪）
  • 6 个 Mermaid 图表（架构、分布式追踪、遥测流程）
  • 3 个动手练习（警报、仪表盘、AI 监控）
  • Kusto 查询示例和成本优化策略
  • 实时指标流和实时调试
  • 40-50 分钟学习时间，提供生产级模式

• ** 身份验证与安全模式课程**：位于 docs/getting-started/authsecurity.md：

  • 3 种身份验证模式（连接字符串、Key Vault、托管身份）
  • 提供完整的 Bicep 基础设施模板以实现安全部署
  • 包含 Azure SDK 集成的 Node.js 应用代码
  • 3 个完整练习（启用托管身份、用户分配身份、Key Vault 轮换）
  • 安全最佳实践和 RBAC 配置
  • 故障排除指南和成本分析
  • 生产级无密码身份验证模式

• ** 多代理协调模式课程**：位于 docs/pre-deployment/coordination-patterns.md：

  • 5 种协调模式（顺序、并行、层次化、事件驱动、共识）
  • 完整的协调服务实现（Python/Flask，1,500+ 行代码）
  • 3 个专用代理实现（研究、写作、编辑）
  • 服务总线集成用于消息队列
  • Cosmos DB 用于分布式系统的状态管理
  • 6 个 Mermaid 图表展示代理交互
  • 3 个高级练习（超时处理、重试逻辑、断路器）
  • 成本分析（$240-565/月）及优化策略
  • 应用程序洞察集成用于监控

增强

• 预部署章节：现已包含全面的监控和协调模式
• 入门章节：增强了专业身份验证模式
• 生产准备：从安全到可观察性全面覆盖
• 课程大纲：更新以引用第 3 和第 6 章中的新课程

更改

• 学习进程：更好地整合了课程中的安全性和监控内容
• 文档质量：新课程保持一致的 A 级标准（95-97%）
• 生产模式：企业部署的端到端完整覆盖

改进

• 开发者体验：从开发到生产监控的清晰路径
• 安全标准：专业的身份验证和机密管理模式
• 可观察性：完整的应用程序洞察集成
• AI 工作负载：针对 Azure OpenAI 和多代理系统的专门监控

验证

• ✅ 所有课程均包含完整的工作代码（非代码片段）
• ✅ Mermaid 图表用于视觉学习（共 19 个，分布于 3 门课程）
• ✅ 动手练习包含验证步骤（共 9 个）
• ✅ 生产级 Bicep 模板可通过 azd up 部署
• ✅ 成本分析和优化策略
• ✅ 故障排除指南和最佳实践
• ✅ 知识检查点包含验证命令

文档评分结果

• docs/pre-deployment/application-insights.md：- 全面的监控指南
• docs/getting-started/authsecurity.md：- 专业的安全模式
• docs/pre-deployment/coordination-patterns.md：- 高级多代理架构
• 整体新内容：- 一致的高质量标准

技术实现

• 应用程序洞察：日志分析 + 自定义遥测 + 分布式追踪
• 身份验证：托管身份 + Key Vault + RBAC 模式
• 多代理：服务总线 + Cosmos DB + 容器应用 + 编排
• 监控：实时指标 + Kusto 查询 + 警报 + 仪表盘
• 成本管理：采样策略、保留策略、预算控制

[v3.7.0] - 2025-11-19

文档质量改进和新增 Azure OpenAI 示例

此版本提升了整个仓库的文档质量，并新增了完整的 Azure OpenAI 部署示例，包含 GPT-4 聊天界面。

新增

• ** Azure OpenAI 聊天示例**：完整的 GPT-4 部署及工作实现，位于 examples/azure-openai-chat/：

  • 完整的 Azure OpenAI 基础设施（GPT-4 模型部署）
  • Python 命令行聊天界面，支持对话历史记录
  • Key Vault 集成以安全存储 API 密钥
  • 令牌使用跟踪和成本估算
  • 限速和错误处理
  • 全面的 README，包含 35-45 分钟部署指南
  • 11 个生产级文件（Bicep 模板、Python 应用、配置）

• ** 文档练习**：在配置指南中新增动手练习：

  • 练习 1：多环境配置（15 分钟）
  • 练习 2：机密管理实践（10 分钟）
  • 明确的成功标准和验证步骤

• ✅ 部署验证：在部署指南中新增验证部分：

  • 健康检查流程
  • 成功标准清单
  • 所有部署命令的预期输出
  • 快速参考故障排除

增强

• examples/README.md：更新至 A 级质量（93%）：

  • 将 azure-openai-chat 添加到所有相关部分
  • 本地示例数量从 3 更新至 4
  • 添加到 AI 应用示例表
  • 集成到中级用户快速入门
  • 添加到 Azure AI Foundry 模板部分
  • 更新比较矩阵和技术发现部分

• 文档质量：从 B+（87%）提升至 A-（92%），覆盖 docs 文件夹：

  • 在关键命令示例中添加预期输出
  • 包含配置更改的验证步骤
  • 通过实践练习增强动手学习

更改

• 学习进程：更好地整合了中级学习者的 AI 示例
• 文档结构：更多可操作的练习，明确结果
• 验证流程：关键工作流新增明确的成功标准

改进

• 开发者体验：Azure OpenAI 部署时间缩短至 35-45 分钟（相比复杂替代方案的 60-90 分钟）
• 成本透明度：清晰的成本估算（$50-200/月）用于 Azure OpenAI 示例
• 学习路径：AI 开发者有明确的入门点（azure-openai-chat）
• 文档标准：一致的预期输出和验证步骤

验证

• ✅ Azure OpenAI 示例可通过 azd up 完全运行
• ✅ 所有 11 个实现文件语法正确
• ✅ README 指令与实际部署体验一致
• ✅ 文档链接在 8+ 个位置更新
• ✅ 示例索引准确反映 4 个本地示例
• ✅ 表格中无重复外部链接
• ✅ 所有导航引用正确

技术实现

• Azure OpenAI 架构：GPT-4 + Key Vault + 容器应用模式
• 安全性：支持托管身份，机密存储于 Key Vault
• 监控：应用程序洞察集成
• 成本管理：令牌跟踪和使用优化
• 部署：单个 azd up 命令完成设置

[v3.6.0] - 2025-11-19

重大更新：容器应用部署示例

此版本引入了使用 Azure Developer CLI (AZD) 的全面生产级容器应用部署示例，包含完整文档并集成到学习路径中。

新增

• ** 容器应用示例**：新增本地示例，位于 examples/container-app/：

  • 主指南：容器化部署的完整概述、快速入门、生产和高级模式
  • 简单 Flask API：面向初学者的 REST API，支持零扩展、健康探测、监控和故障排除
  • 微服务架构：生产级多服务部署（API 网关、产品、订单、用户、通知），异步消息传递、服务总线、Cosmos DB、Azure SQL、分布式追踪、蓝绿/金丝雀部署

• 最佳实践：容器化工作负载的安全性、监控、成本优化和 CI/CD 指南

• 代码示例：完整的 azure.yaml、Bicep 模板和多语言服务实现（Python、Node.js、C#、Go）

• 测试与故障排除：端到端测试场景、监控命令、故障排除指南

更改

• README.md：更新以突出并链接新的容器应用示例，位于“本地示例 - 容器应用”部分
• examples/README.md：更新以强调容器应用示例，添加比较矩阵条目，并更新技术/架构参考
• 课程大纲与学习指南：更新以引用相关章节中的新容器应用示例和部署模式

验证

• ✅ 所有新示例可通过 azd up 部署并遵循最佳实践
• ✅ 文档交叉链接和导航已更新
• ✅ 示例覆盖从初学者到高级场景，包括生产级微服务

注意事项

• 范围：仅限英文文档和示例
• 下一步：未来版本将扩展高级容器模式和 CI/CD 自动化

[v3.5.0] - 2025-11-19

产品重命名：Microsoft Foundry

此版本在所有英文文档中实施了全面的产品名称更改，将“Azure AI Foundry”重命名为“Microsoft Foundry”，以反映微软的官方品牌重塑。

更改

• ** 产品名称更新**：将“Azure AI Foundry”全面重命名为“Microsoft Foundry”：

  • 更新 docs/ 文件夹中英文文档的所有引用
  • 文件夹重命名：docs/ai-foundry/ → docs/microsoft-foundry/
  • 文件重命名：azure-ai-foundry-integration.md → microsoft-foundry-integration.md
  • 总计：7 个文档文件中更新了 23 处内容引用

• ** 文件夹结构更改**：

  • docs/ai-foundry/ 重命名为 docs/microsoft-foundry/
  • 所有交叉引用更新以反映新的文件夹结构
  • 验证所有文档中的导航链接

• ** 文件重命名**：

  • azure-ai-foundry-integration.md → microsoft-foundry-integration.md
  • 所有内部链接更新以引用新文件名

更新文件

• 章节文档（7 个文件）：

  • docs/microsoft-foundry/ai-model-deployment.md - 更新了 3 个导航链接
  • docs/microsoft-foundry/ai-workshop-lab.md - 更新了 4 个产品名称引用
  • docs/microsoft-foundry/microsoft-foundry-integration.md - 已使用 Microsoft Foundry（来自之前更新）
  • docs/microsoft-foundry/production-ai-practices.md - 更新了 3 个引用（概述、社区反馈、文档）
  • docs/getting-started/azd-basics.md - 更新了 4 个交叉引用链接
  • docs/getting-started/first-project.md - 更新了 2 个章节导航链接
  • docs/getting-started/installation.md - 更新了 2 个下一章节链接
  • docs/troubleshooting/ai-troubleshooting.md - 更新了 3 个引用（导航、Discord 社区）
  • docs/troubleshooting/common-issues.md - 更新了 1 个导航链接
  • docs/troubleshooting/debugging.md - 更新了 1 个导航链接

• 课程结构文件（2 个文件）：

  • README.md - 更新了 17 个引用（课程概述、章节标题、模板部分、社区洞察）
  • course-outline.md - 更新了 14 个引用（概述、学习目标、章节资源）

验证

• ✅ 英文文档中无剩余“ai-foundry”文件夹路径引用
• ✅ 英文文档中无剩余“Azure AI Foundry”产品名称引用
• ✅ 所有导航链接在新文件夹结构下正常工作
• ✅ 文件和文件夹重命名成功完成
• ✅ 章节间交叉引用已验证

注意事项

• 范围：仅适用于 docs/ 文件夹中的英文文档
• 翻译：翻译文件夹（translations/）未在此版本中更新
• 工作坊: 本版本未更新工作坊材料 (workshop/)
• 示例: 示例文件可能仍引用旧命名方式（将在未来更新中解决）
• 外部链接: 外部URL和GitHub库引用保持不变

贡献者迁移指南

如果您有本地分支或文档引用旧结构：

1. 更新文件夹引用：docs/ai-foundry/ → docs/microsoft-foundry/
2. 更新文件引用：azure-ai-foundry-integration.md → microsoft-foundry-integration.md
3. 替换产品名称："Azure AI Foundry" → "Microsoft Foundry"
4. 验证所有内部文档链接是否仍然有效

[v3.4.0] - 2025-10-24

基础设施预览和验证增强

本版本全面支持新的Azure Developer CLI预览功能，并提升了工作坊用户体验。

新增

• ** azd provision --preview功能文档**: 全面覆盖新的基础设施预览功能
  • 命令参考和使用示例在速查表中
  • 在部署指南中详细集成，包含用例和优势
  • 集成预部署检查以确保更安全的部署验证
  • 更新入门指南，强调安全优先的部署实践
• ** 工作坊状态横幅**: 专业HTML横幅，指示工作坊开发状态
  • 渐变设计，带有施工指示器，清晰传达给用户
  • 透明的最后更新时间戳
  • 移动端响应式设计，适配所有设备类型

增强

• 基础设施安全性: 在整个部署文档中集成预览功能
• 预部署验证: 自动脚本现已包含基础设施预览测试
• 开发者工作流: 更新命令序列，推荐将预览作为最佳实践
• 工作坊体验: 为用户明确设定内容开发状态的预期

更改

• 部署最佳实践: 现在推荐以预览为优先的工作流
• 文档流程: 将基础设施验证移至学习过程的早期阶段
• 工作坊展示: 专业状态沟通，明确开发时间表

改进

• 安全优先方法: 现在可以在部署前验证基础设施更改
• 团队协作: 预览结果可共享以供审查和批准
• 成本意识: 在部署前更好地了解资源成本
• 风险缓解: 通过提前验证减少部署失败

技术实现

• 多文档集成: 预览功能记录在4个关键文件中
• 命令模式: 在整个文档中保持一致的语法和示例
• 最佳实践集成: 在验证工作流和脚本中包含预览
• 视觉指示器: 清晰的NEW功能标记，便于发现

工作坊基础设施

• 状态沟通: 专业HTML横幅，带有渐变样式
• 用户体验: 清晰的开发状态避免混淆
• 专业展示: 在设定预期的同时保持库的可信度
• 时间表透明度: 2025年10月的最后更新时间戳，确保责任明确

[v3.3.0] - 2025-09-24

增强的工作坊材料和互动学习体验

本版本引入了全面的工作坊材料，包括基于浏览器的互动指南和结构化学习路径。

新增

• ** 互动工作坊指南**: 基于浏览器的工作坊体验，支持MkDocs预览功能
• ** 结构化工作坊说明**: 从探索到定制的7步指导学习路径
  • 0-简介: 工作坊概述和设置
  • 1-选择AI模板: 模板探索和选择过程
  • 2-验证AI模板: 部署和验证程序
  • 3-解析AI模板: 理解模板架构
  • 4-配置AI模板: 配置和定制
  • 5-定制AI模板: 高级修改和迭代
  • 6-拆除基础设施: 清理和资源管理
  • 7-总结: 总结和下一步
• ️ 工作坊工具: 使用Material主题配置MkDocs，提升学习体验
• ** 实践学习路径**: 3步方法（探索 → 部署 → 定制）
• ** GitHub Codespaces集成**: 无缝开发环境设置

增强

• AI工作坊实验室: 扩展为全面的2-3小时结构化学习体验
• 工作坊文档: 专业展示，带有导航和视觉辅助
• 学习进程: 从模板选择到生产部署的清晰分步指导
• 开发者体验: 集成工具，简化开发工作流

改进

• 可访问性: 基于浏览器的界面，支持搜索、复制功能和主题切换
• 自定进度学习: 灵活的工作坊结构，适应不同的学习速度
• 实践应用: 真实的AI模板部署场景
• 社区集成: Discord集成，提供工作坊支持和协作

工作坊功能

• 内置搜索: 快速关键词和课程发现
• 复制代码块: 所有代码示例支持悬停复制功能
• 主题切换: 支持深色/浅色模式，适应不同偏好
• 视觉资源: 截图和图表，增强理解
• 帮助集成: 直接访问Discord社区支持

[v3.2.0] - 2025-09-17

主要导航重构和基于章节的学习系统

本版本引入了全面的基于章节的学习结构，并增强了整个库的导航功能。

新增

• ** 基于章节的学习系统**: 将整个课程重构为8个渐进式学习章节
  • 第1章: 基础与快速入门 (⭐ - 30-45分钟)
  • 第2章: AI优先开发 (⭐⭐ - 1-2小时)
  • 第3章: 配置与认证 (⭐⭐ - 45-60分钟)
  • 第4章: 基础设施即代码与部署 (⭐⭐⭐ - 1-1.5小时)
  • 第5章: 多代理AI解决方案 (⭐⭐⭐⭐ - 2-3小时)
  • 第6章: 预部署验证与规划 (⭐⭐ - 1小时)
  • 第7章: 故障排除与调试 (⭐⭐ - 1-1.5小时)
  • 第8章: 生产与企业模式 (⭐⭐⭐⭐ - 2-3小时)
• ** 全面导航系统**: 所有文档中统一的导航页眉和页脚
• ** 进度跟踪**: 课程完成清单和学习验证系统
• ️ 学习路径指导: 为不同经验水平和目标提供清晰的入口点
• ** 交叉引用导航**: 清晰链接相关章节和前置要求

增强

• README结构: 转变为结构化学习平台，基于章节组织
• 文档导航: 每页现在都包含章节上下文和进程指导
• 模板组织: 示例和模板映射到适当的学习章节
• 资源集成: 速查表、常见问题解答和学习指南连接到相关章节
• 工作坊集成: 实践实验室映射到多个章节学习目标

更改

• 学习进程: 从线性文档转变为灵活的章节式学习
• 配置位置: 将配置指南重新定位为第3章，以优化学习流程
• AI内容集成: 在整个学习过程中更好地集成AI相关内容
• 生产内容: 将高级模式整合到第8章，为企业学习者提供服务

改进

• 用户体验: 清晰的导航面包屑和章节进程指示器
• 可访问性: 一致的导航模式，便于课程浏览
• 专业展示: 大学风格的课程结构，适合学术和企业培训
• 学习效率: 通过改进的组织减少找到相关内容的时间

技术实现

• 导航页眉: 在40多个文档文件中标准化章节导航
• 页脚导航: 一致的进程指导和章节完成指示器
• 交叉链接: 全面的内部链接系统，连接相关概念
• 章节映射: 模板和示例清晰关联到学习目标

学习指南增强

• ** 全面学习目标**: 重构学习指南以与8章系统对齐
• ** 基于章节的评估**: 每章包含具体的学习目标和实践练习
• ** 进度跟踪**: 每周学习计划，包含可衡量的成果和完成清单
• ❓ 评估问题: 每章的知识验证问题，提供专业成果
• ️ 实践练习: 实践活动，包含真实的部署场景和故障排除
• ** 技能进展**: 从基础概念到企业模式的清晰提升，关注职业发展
• ** 认证框架**: 专业发展成果和社区认可系统
• ⏱️ 时间管理: 结构化的10周学习计划，包含里程碑验证

[v3.1.0] - 2025-09-17

增强的多代理AI解决方案

本版本改进了多代理零售解决方案，优化了代理命名并增强了文档内容。

更改

• 多代理术语: 将零售多代理解决方案中的"Cora代理"替换为"客户代理"，以便更清晰地理解
• 代理架构: 更新所有文档、ARM模板和代码示例，使用一致的"客户代理"命名
• 配置示例: 使用更新的命名规范，现代化代理配置模式
• 文档一致性: 确保所有引用使用专业且描述性的代理名称

增强

• ARM模板包: 更新零售多代理ARM模板，使用客户代理引用
• 架构图: 刷新Mermaid图表，使用更新的代理命名
• 代码示例: Python类和实现示例现在使用CustomerAgent命名
• 环境变量: 更新所有部署脚本，使用CUSTOMER_AGENT_NAME规范

改进

• 开发者体验: 文档中更清晰的代理角色和职责
• 生产准备: 更好地与企业命名规范对齐
• 学习材料: 更直观的代理命名，适用于教育目的
• 模板可用性: 简化对代理功能和部署模式的理解

技术细节

• 更新Mermaid架构图，使用CustomerAgent引用
• 将CoraAgent类名替换为CustomerAgent，应用于Python示例
• 修改ARM模板JSON配置，使用"customer"代理类型
• 更新环境变量，从CORA_AGENT_*改为CUSTOMER_AGENT_*模式
• 刷新所有部署命令和容器配置

[v3.0.0] - 2025-09-12

重大变化 - AI开发者聚焦与Azure AI Foundry集成

本版本将库转变为全面的AI聚焦学习资源，并集成Azure AI Foundry。

新增

• ** AI优先学习路径**: 完整重构，优先考虑AI开发者和工程师
• Azure AI Foundry集成指南: 详细文档，涵盖AZD与Azure AI Foundry服务的连接
• AI模型部署模式: 详细指南，涵盖模型选择、配置和生产部署策略
• AI工作坊实验室: 2-3小时的实践工作坊，将AI应用转换为AZD可部署解决方案
• 生产AI最佳实践: 企业级模式，用于扩展、监控和保护AI工作负载
• AI专属故障排除指南: 全面故障排除，涵盖Azure OpenAI、认知服务和AI部署问题
• AI模板库: 推荐的Azure AI Foundry模板集合，附复杂度评级
• 工作坊材料: 完整的工作坊结构，包含实践实验室和参考材料

增强

• README结构: 面向AI开发者，基于Azure AI Foundry Discord社区45%的兴趣数据
• 学习路径: 专门的AI开发者旅程，与传统路径（学生和DevOps工程师）并行
• 模板推荐: 推荐的AI模板，包括azure-search-openai-demo、contoso-chat和openai-chat-app-quickstart
• 社区集成: 增强的Discord社区支持，提供AI专属频道和讨论

安全与生产聚焦

• 托管身份模式: AI专属认证和安全配置
• 成本优化: AI工作负载的令牌使用跟踪和预算控制
• 多区域部署: 全球AI应用部署策略
• 性能监控: AI专属指标和Application Insights集成

文档质量

• 线性课程结构: 从初学者到高级AI部署模式的逻辑进程
• 验证的URL: 所有外部库链接已验证并可访问
• 完整参考: 所有内部文档链接已验证并功能正常
• 生产就绪: 企业部署模式，附真实案例

[v2.0.0] - 2025-09-09

重大变化 - 库重构与专业增强

本版本代表了库结构和内容展示的重大改进。

新增

• 结构化学习框架: 所有文档页面现在包含简介、学习目标和学习成果部分
• 导航系统: 在所有文档中添加了上一课/下一课链接，提供引导式学习进程
• 学习指南: 全面的study-guide.md，包含学习目标、实践练习和评估材料
• 专业展示: 移除所有表情符号图标，提升可访问性和专业外观
• 增强内容结构: 改进学习材料的组织和流程

更改

• 文档格式: 标准化所有文档，采用一致的学习导向结构
• 导航流程: 在所有学习材料中实现逻辑进程
• 内容呈现：移除装饰性元素，采用清晰、专业的格式
• 链接结构：更新所有内部链接以支持新的导航系统

改进

• 无障碍性：移除对表情符号的依赖，以提高屏幕阅读器的兼容性
• 专业外观：干净、学术风格的呈现，适合企业学习
• 学习体验：结构化方法，每节课都有明确的目标和成果
• 内容组织：更好的逻辑流程和相关主题之间的连接

[v1.0.0] - 2025-09-09

初始发布 - 全面的 AZD 学习资源库

新增

• 核心文档结构

  • 完整的入门指南系列
  • 全面的部署和配置文档
  • 详细的故障排除资源和调试指南
  • 部署前验证工具和流程

• 入门模块

  • AZD 基础：核心概念和术语
  • 安装指南：针对不同平台的设置说明
  • 配置指南：环境设置和身份验证
  • 第一个项目教程：逐步动手学习

• 部署和配置模块

  • 部署指南：完整的工作流程文档
  • 配置指南：使用 Bicep 的基础设施即代码
  • 生产部署的最佳实践
  • 多服务架构模式

• 部署前验证模块

  • 容量规划：Azure 资源可用性验证
  • SKU 选择：全面的服务层级指导
  • 预检检查：自动化验证脚本（PowerShell 和 Bash）
  • 成本估算和预算规划工具

• 故障排除模块

  • 常见问题：常见问题及解决方案
  • 调试指南：系统化的故障排除方法
  • 高级诊断技术和工具
  • 性能监控和优化

• 资源和参考

  • 命令速查表：重要命令的快速参考
  • 术语表：全面的术语和缩略语定义
  • 常见问题解答：详细回答常见问题
  • 外部资源链接和社区连接

• 示例和模板

  • 简单的 Web 应用示例
  • 静态网站部署模板
  • 容器应用配置
  • 数据库集成模式
  • 微服务架构示例
  • 无服务器函数实现

功能

• 多平台支持：适用于 Windows、macOS 和 Linux 的安装和配置指南
• 多技能水平：内容适合从学生到专业开发者
• 实践导向：动手示例和真实场景
• 全面覆盖：从基础概念到高级企业模式
• 安全优先：贯穿始终的安全最佳实践
• 成本优化：提供经济高效的部署和资源管理指导

文档质量

• 详细的代码示例：实用、经过测试的代码样本
• 逐步说明：清晰、可操作的指导
• 全面的错误处理：常见问题的故障排除
• 最佳实践整合：行业标准和建议
• 版本兼容性：与最新的 Azure 服务和 azd 功能保持同步

计划的未来增强

版本 3.1.0（计划中）

AI 平台扩展

• 多模型支持：Hugging Face、Azure Machine Learning 和自定义模型的集成模式
• AI 代理框架：LangChain、Semantic Kernel 和 AutoGen 部署模板
• 高级 RAG 模式：超越 Azure AI Search 的向量数据库选项（如 Pinecone、Weaviate 等）
• AI 可观测性：增强的模型性能、令牌使用和响应质量监控

开发者体验

• VS Code 扩展：集成 AZD + AI Foundry 的开发体验
• GitHub Copilot 集成：AI 辅助的 AZD 模板生成
• 交互式教程：带有自动验证的 AI 场景动手编码练习
• 视频内容：为视觉学习者提供的 AI 部署视频教程

版本 4.0.0（计划中）

企业 AI 模式

• 治理框架：AI 模型治理、合规性和审计追踪
• 多租户 AI：为多个客户提供隔离 AI 服务的模式
• 边缘 AI 部署：与 Azure IoT Edge 和容器实例的集成
• 混合云 AI：AI 工作负载的多云和混合部署模式

高级功能

• AI 流水线自动化：与 Azure Machine Learning 流水线的 MLOps 集成
• 高级安全性：零信任模式、私有端点和高级威胁防护
• 性能优化：高吞吐量 AI 应用的高级调优和扩展策略
• 全球分发：AI 应用的内容交付和边缘缓存模式

版本 3.0.0（计划中）- 被当前版本取代

提议的新增内容 - 现已在 v3.0.0 中实现

• ✅ 以 AI 为中心的内容：全面的 Azure AI Foundry 集成（已完成）
• ✅ 交互式教程：动手 AI 研讨会实验室（已完成）
• ✅ 高级安全模块：AI 特定的安全模式（已完成）
• ✅ 性能优化：AI 工作负载调优策略（已完成）

版本 2.1.0（计划中）- 部分已在 v3.0.0 中实现

小幅增强 - 部分已在当前版本中完成

• ✅ 额外示例：以 AI 为中心的部署场景（已完成）
• ✅ 扩展 FAQ：AI 特定问题和故障排除（已完成）
• 工具集成：增强的 IDE 和编辑器集成指南
• ✅ 监控扩展：AI 特定的监控和警报模式（已完成）

仍计划在未来版本中实现

• 移动友好文档：适合移动学习的响应式设计
• 离线访问：可下载的文档包
• 增强的 IDE 集成：用于 AZD + AI 工作流的 VS Code 扩展
• 社区仪表板：实时社区指标和贡献跟踪

贡献到变更日志

报告更改

在为此存储库贡献时，请确保变更日志条目包括：

1. 版本号：遵循语义版本控制（主版本.次版本.修订版本）
2. 日期：以 YYYY-MM-DD 格式记录的发布或更新日期
3. 类别：新增、变更、弃用、移除、修复、安全
4. 清晰描述：简明描述更改内容
5. 影响评估：更改对现有用户的影响

更改类别

新增

• 新功能、文档部分或功能
• 新的示例、模板或学习资源
• 额外的工具、脚本或实用程序

变更

• 对现有功能或文档的修改
• 提高清晰度或准确性的更新
• 内容或组织结构的重组

弃用

• 正在逐步淘汰的功能或方法
• 计划移除的文档部分
• 有更好替代方案的方法

移除

• 不再相关的功能、文档或示例
• 过时的信息或弃用的方法
• 冗余或合并的内容

修复

• 文档或代码中的错误修正
• 报告问题或问题的解决
• 提高准确性或功能性

安全

• 与安全相关的改进或修复
• 安全最佳实践的更新
• 安全漏洞的解决

语义版本控制指南

主版本（X.0.0）

• 需要用户操作的重大更改
• 内容或组织结构的重大重组
• 改变基本方法或方法论的更改

次版本（X.Y.0）

• 新功能或内容添加
• 保持向后兼容的增强
• 额外的示例、工具或资源

修订版本（X.Y.Z）

• 错误修复和更正
• 对现有内容的小幅改进
• 澄清和小幅增强

社区反馈和建议

我们积极鼓励社区反馈以改进此学习资源：

如何提供反馈

• GitHub 问题：报告问题或提出改进建议（欢迎 AI 相关问题）
• Discord 讨论：分享想法并与 Azure AI Foundry 社区互动
• 拉取请求：直接改进内容，特别是 AI 模板和指南
• Azure AI Foundry Discord：参与 #Azure 频道的 AZD + AI 讨论
• 社区论坛：参与更广泛的 Azure 开发者讨论

反馈类别

• AI 内容准确性：对 AI 服务集成和部署信息的修正
• 学习体验：改进 AI 开发者学习流程的建议
• 缺失的 AI 内容：请求额外的 AI 模板、模式或示例
• 无障碍性：满足多样化学习需求的改进
• AI 工具集成：改进 AI 开发工作流集成的建议
• 生产 AI 模式：企业 AI 部署模式的请求

响应承诺

• 问题响应：48 小时内回复报告的问题
• 功能请求：一周内评估
• 社区贡献：一周内审查
• 安全问题：优先处理并加快响应

维护计划

定期更新

• 每月审查：内容准确性和链接验证
• 季度更新：主要内容添加和改进
• 半年审查：全面重组和增强
• 年度发布：带有重大改进的主要版本更新

监控和质量保证

• 自动化测试：定期验证代码示例和链接
• 社区反馈整合：定期采纳用户建议
• 技术更新：与最新的 Azure 服务和 azd 版本保持一致
• 无障碍性审计：定期审查包容性设计原则

版本支持政策

当前版本支持

• 最新主版本：全面支持并定期更新
• 上一主版本：提供 12 个月的安全更新和关键修复
• 旧版本：仅提供社区支持，不再进行官方更新

迁移指南

当发布主版本时，我们提供：

• 迁移指南：逐步过渡说明
• 兼容性说明：有关重大更改的详细信息
• 工具支持：协助迁移的脚本或实用程序
• 社区支持：专门的迁移问题论坛

导航

• 上一课：学习指南
• 下一课：返回 主 README

保持更新：关注此存储库以获取有关新版本和学习材料重要更新的通知。

免责声明：
本文档使用AI翻译服务Co-op Translator进行翻译。尽管我们努力确保翻译的准确性，但请注意，自动翻译可能包含错误或不准确之处。原始语言的文档应被视为权威来源。对于关键信息，建议使用专业人工翻译。我们不对因使用此翻译而产生的任何误解或误读承担责任。