Spec-Driven Azure 智能体应用架构：从规范到云端的完整蓝图

深入解析 agentic-azure-blueprint 项目——一个基于规范驱动开发 (SDD) 的 Azure 智能体应用架构模板，包含 Next.js 前端、FastAPI BFF、LangGraph 编排器的完整实现，以及 .NET Aspire 本地编排和 azd 一键部署的完整工作流。

• 原作者/维护者: Henry Bravo (henrybravo)，Microsoft Cloud & AI 高级解决方案工程师
• 来源平台: GitHub
• 原始标题: agentic-azure-blueprint
• 原始链接: https://github.com/henrybravo/agentic-azure-blueprint
• 发布时间: 2026-06-11

---

agentic-azure-blueprint 是一个面向企业级场景的智能体 (Agentic) 应用架构模板，由微软解决方案工程师 Henry Bravo 开源。该项目采用规范驱动开发 (Spec-Driven Development, SDD) 方法论，提供了一套从本地开发到云端部署的完整工程化方案。

项目的核心目标是解决智能体应用开发中的常见痛点：

• 前后端与编排服务的复杂协调
• 本地开发与云端环境的一致性
• 基础设施即代码 (IaC) 的规范化管理
• AI 模型部署与身份验证的配置复杂性

通过整合 Next.js、FastAPI、LangGraph、.NET Aspire 和 Azure Developer CLI (azd)，该项目为开发者提供了一条清晰的智能体应用构建路径。

---

项目采用经典的三层架构模式，每层职责清晰、接口明确：

服务	技术栈	职责	端口
agentic-ui	Next.js 16 + TypeScript	用户界面与交互	3000
agentic-api	FastAPI + Python	BFF (Backend for Frontend) 层	8080
orchestrator	LangGraph + Python	智能体编排与推理	8000

用户浏览器 → HTTPS → agentic-ui (Next.js)
                    ↓
              /api/* 请求 → agentic-api (FastAPI BFF)
                    ↓
              SSE /turn → orchestrator (LangGraph)
                    ↓
              Managed Identity → Azure AI Foundry

这种分层设计遵循了关注点分离原则：

• UI 层专注于用户体验和交互逻辑
• BFF 层处理认证、请求路由、数据转换
• 编排层负责智能体逻辑、状态管理、LLM 调用

.NET Aspire 是 .NET 8 引入的云原生应用编排框架，在该项目中用于本地开发环境的统一管理：

• 服务发现: 自动处理服务间的网络连接
• 配置管理: 集中管理环境变量和连接字符串
• 遥测仪表板: 内置 OpenTelemetry 支持，实时查看日志、指标、追踪
• 一键启动: 运行 dotnet run apphost.cs 即可同时启动三个服务

开发者也可以选择不使用 Aspire，单独运行每个服务（见项目文档），提供了灵活的工作流选择。

---

项目的 infra/ 目录包含完整的 Azure 基础设施定义，采用 Bicep 语言编写，并基于 Azure Verified Modules (AVM) 最佳实践：