Microsoft Agent Framework

1. 项目概览

项目自带关键图：

官方 README 中的视频入口：

2. 它主要能做什么

Microsoft Agent Framework 提供两大类能力：

和普通 Agent SDK 相比，MAF 更强调从原型到生产：

3. 和 AutoGen / Semantic Kernel 的关系

MAF 的售前价值很大一部分来自“官方继任路线”。

MS Learn 概览中明确说明：Agent Framework 结合了 AutoGen 的简单 Agent 抽象和 Semantic Kernel 的企业级能力，例如 session-based state management、type safety、middleware/filters、telemetry，以及更丰富的模型和 embedding 支持；同时新增了显式多 Agent 执行路径控制的 graph-based workflows。

售前话术：

“如果客户还在评估 AutoGen，那么现在应该直接把 Microsoft Agent Framework 纳入主选项，因为它是 Microsoft 当前面向生产级 Agent 的新路线。”

4. 核心能力清单

5. Agents vs Workflows 怎么讲

MS Learn 给了一个很好的判断标准：

还有一句对售前很有用：

如果可以用普通函数处理任务，就用函数，不要为了 AI 而 AI。

这句话背后的售前价值是：MAF 不是鼓励把一切都变成 Agent，而是把 Agent 放到真正需要推理、工具调用和人机协作的环节；确定性步骤仍用普通代码/Workflow 来控制。这样更符合企业客户对稳定性、成本和可控性的要求。

6. 架构/部署/集成方式

MAF 的典型架构可以理解为：

1. Provider 层：连接 Microsoft Foundry、Azure OpenAI、OpenAI、其他模型供应商。
2. Agent 层：用模型、instructions、tools、session 构建 Agent。
3. Tool/MCP 层：连接企业 API、MCP Server、hosted tools、代码解释器、文件检索等。
4. Workflow 层：图式编排 Agent、函数、人工审批、checkpoint、分支路由。
5. Observability/Governance 层：OpenTelemetry、middleware、日志、策略、内容过滤。
6. Hosting 层：本地开发、Azure Functions、Durable Agents/Workflows、Foundry Hosted Agents、A2A。

面向 Azure 客户时，可重点讲：

7. 怎么用

Python 安装：

pip install agent-framework
pip install azure-identity

.NET 安装：

dotnet add package Microsoft.Agents.AI
dotnet add package Microsoft.Agents.AI.Foundry
dotnet add package Azure.AI.Projects
dotnet add package Azure.Identity

Python 最小示例：

import asyncio
from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential

async def main():
    client = FoundryChatClient(
        credential=AzureCliCredential(),
        # project_endpoint="https://your-project.services.ai.azure.com",
        # model="gpt-4o",
    )

    agent = Agent(
        client=client,
        name="HelloAgent",
        instructions="You are a friendly assistant. Keep your answers brief.",
    )

    result = await agent.run("What is the capital of France?")
    print(result)

if __name__ == "__main__":
    asyncio.run(main())

流式输出：

async for chunk in agent.run("Tell me a one-sentence fun fact.", stream=True):
    if chunk.text:
        print(chunk.text, end="", flush=True)

注意：MS Learn 明确提醒 Agent Framework 不会自动加载 .env 文件；如果需要 .env，要在应用中显式调用 load_dotenv()。

8. 适用场景

9. 不太适合的场景

10. 售前可以怎么讲

一句话定位：

“Microsoft Agent Framework 是 Microsoft 当前面向生产级 Agent 和多 Agent 工作流的新一代框架，把 AutoGen 的多 Agent 思路和 Semantic Kernel 的企业能力统一起来，适合从原型走向可治理、可观测、可恢复的企业级 Agent 应用。”

客户价值话术：

11. 与 AutoGen / CrewAI / LangGraph 的对比

售前建议：

1. 如果客户是 Azure/Microsoft 生态，MAF 应优先进入方案。
2. 如果客户已有 AutoGen，MAF 是迁移主线。
3. 如果客户是纯 Python、非 Azure、偏业务自动化 demo，可同时比较 CrewAI。
4. 如果客户已有 LangChain/LangGraph 生态，则需要从模型 Provider、状态管理、工作流治理、部署要求来选型。

12. PoC 建议

MAF PoC 不建议只做“Hello Agent”，应选一个能体现生产能力的流程。

建议指标：

13. 风险和注意事项

1. GitHub API 本次匿名限流：未能再次通过 GitHub API 校验 stars、forks、latest GitHub release，笔记中包版本使用 PyPI/NuGet 查询结果。
2. 第三方系统风险：README 重要提示明确说明第三方 servers、agents、code、non-Azure Direct models 都需要客户自行承担风险、审查数据流和成本。
3. Azure 认证要慎重：MS Learn 提醒 DefaultAzureCredential 开发方便，但生产建议使用更明确的 credential，如 Managed Identity。
4. Provider 能力不完全等价：AutoGen 迁移指南里部分 provider/能力仍是 planned，需要逐项确认。
5. SDK 不是完整平台：MAF 提供框架和样例，生产仍要应用层权限、审计、UI、CI/CD、部署和监控。
6. AI 责任边界：需要客户自己实现 metaprompt、content filters、安全评测、质量控制等 Responsible AI 缓解措施。
7. 框架仍在快速演进：PyPI/NuGet 版本更新较快，生产 PoC 需固定版本和升级策略。

14. 常见客户问题

15. 我的售前判断

Microsoft Agent Framework 是当前 Microsoft 生态里最值得重点跟踪的 Agent 框架。它的定位非常清楚：不是为了再做一个 Agent demo 框架，而是为企业把 Agent 从 demo 推到生产做基础设施。它把 AutoGen 的多 Agent 思路、Semantic Kernel 的企业工程能力、Azure/Foundry 的部署生态合到一条线上。

如果客户已经在 Microsoft 生态里，MAF 是非常自然的推荐路径。特别是客户提到这些关键词时：Azure OpenAI、Microsoft Foundry、.NET、AutoGen 迁移、生产级工作流、可观测、人审、长任务恢复、企业治理，都可以把 MAF 放到方案核心。

但如果客户只是想快速做一个简单聊天机器人，MAF 可能偏重；如果客户完全不碰 Microsoft 生态，也要和 CrewAI、LangGraph 等做横向比较。售前推进时，最好的切入点不是“它能写一首诗”，而是“它能把 Agent 放进一个可恢复、可审计、可人工介入的业务流程里”。

16. 参考资料

• GitHub: https://github.com/microsoft/agent-framework
• MS Learn 文档: https://learn.microsoft.com/en-us/agent-framework/
• Framework Overview: https://learn.microsoft.com/en-us/agent-framework/overview/agent-framework-overview
• Quick Start: https://learn.microsoft.com/en-us/agent-framework/tutorials/quick-start
• AutoGen 迁移指南: https://learn.microsoft.com/en-us/agent-framework/migration-guide/from-autogen/
• Semantic Kernel 迁移指南: https://learn.microsoft.com/en-us/agent-framework/migration-guide/from-semantic-kernel
• PyPI: https://pypi.org/project/agent-framework/
• NuGet: https://www.nuget.org/profiles/MicrosoftAgentFramework/