microsoft/OpenAIWorkshop

这是什么？

这是一个免费的开源代码、文档和示例场景集合，用于学习如何使用微软的 AI 工具设计、构建和部署 AI 智能体（能够自主采取行动而不仅仅是聊天的软件）。它被构建为一个自导式研讨会：您可以跟随业务场景，尝试示例代码，并试验不同的智能体设计。

您可以用它做什么？

• 设计和原型化 AI 智能体以解决现实的业务问题
• 比较不同的智能体设置——单个智能体、多个智能体协同工作，或智能体之间相互移交任务
• 构建完整系统——从数据库和后端工具，到智能体编排，再到 Web 前端（React 或 Streamlit）
• 部署到 Azure 并具备企业级安全性（私有网络、托管标识、自动化 CI/CD）

核心技术

• Microsoft Agent Framework——处理多个智能体的编排、它们之间的移交以及检查点设置
• MCP (Model Context Protocol) Server——一种为智能体提供额外工具（如数据库访问）的标准方式，支持身份验证和基于角色的访问控制
• 工作流编排——具有“扇出/扇入”模式（并行任务合并）、人工审批步骤和实时监控的持久任务系统；包含欺诈检测演示
• 可观测性——对智能体行为、调用的工具以及 AI 模型调用方式的完整追踪，并配有预构建的 Grafana 仪表板
• 智能体评估——使用自定义指标和数据集测试智能体性能
• 状态持久化——在内存或 CosmosDB 中存储对话历史和智能体状态
• 基础设施即代码——用于生产部署的 Terraform/Bicep 模板
• CI/CD 流水线——从开发到生产的自动化升级，支持开发者个人环境和评估门控

如何开始

README 提供了 6 个步骤的路径：

1. 查看设置说明
2. 阅读业务场景和智能体设计
3. 选择多智能体模式（单一、Magentic 编排或移交）
4. 尝试带有“人在回路”的持久化欺诈检测工作流
5. 在自定义之前研究系统架构
6. 使用支持指南进行故障排除

部署选项

提供四种部署方式，均有详细文档：

• Azure Developer CLI——一键快速启动
• 手动部署——使用 Terraform/Bicep 的 PowerShell
• 企业安全——VNet、私有终结点、托管标识
• GitHub Actions CI/CD——支持 OIDC 身份验证

注意事项

• 根据 LICENSE 文件中的条款授权
• 包含行为准则和安全指南
• 微软明确链接到 Agent Framework 项目以供进一步参考