如何通过File-Based App开发快速构建MAF MVP项目?
摘要:传统 C# 偏“工程导向”,依赖 .csproj.sln 等完整脚手架,适合大规模软件但在脚本化、快速迭代和 AI 动态生成代码时显得繁琐;Python 之所以在 AI脚本领域强势,关键在于“零配置、即写即用”。.NET 10 的 Fi
大家好,我是Edison。
最近我一直在跟着圣杰的《.NET+AI智能体开发进阶》课程学习MAF开发多智能体工作流,我强烈推荐你也上车跟我一起出发!
上一篇,我们初步学习了Agent Skill如何集成脚本执行能力,虽然它不是官方方案,但至少提供了可行的思路。本篇,我们来了解下.NET 10新推出的File-Based App模式,它和MAF一起可以形成一个强大的“王牌组合”!
1 File-Based App模式介绍
曾经做过Python开发的朋友应该都知道,Python的单文件运行项目让很多非IT专业的开发者都能快速地上手一个实际项目出来,也因此在企业中流行。特别是Edison所在的制造业企业中,广大的非IT部门的同事都喜爱Python开发,不管是机器学习还是Web API项目,虽然都不够工程化,不好维护的屎山占多数。在那时,我就在想,.NET什么时候也可以搞个单文件模式,等着等着,它就来了。
随着.NET 10 的发布,微软通过推出“基于文件的应用程序”(File-Based Apps,通常通过 dotnet file 命令调用)这一功能,标志着 C# 正在经历一场根本性的范式转移。这一特性并非仅仅是 CLI 工具链的微小更新,而是C# 试图在智能体(Agentic AI)时代夺取生态话语权的战略王牌。我知道,这是要抢Python的快速Agent原型开发的阵地了!与 Python 不同,Python 脚本在规模扩大后往往面临性能重构或维护性崩塌;而 C# 脚本本身就是完整的 C# 代码。
传统C#开发的“工程负担”
传统 C# 偏“工程导向”,依赖 .csproj/.sln 等完整脚手架,适合大规模软件但在脚本化、快速迭代和 AI 动态生成代码时显得繁琐;Python 之所以在 AI/脚本领域强势,关键在于“零配置、即写即用”。
单文件C#开发的“一把梭”
.NET 10 的 File-Based Apps 通过“单个 .cs 文件 + 内嵌指令声明依赖/环境 + 直接运行”来降低摩擦,让 C# 具备类似脚本语言的灵活性,同时保留性能、并发与类型安全优势,更适合智能体场景。
因为智能体生成代码通常强调“自包含、立刻可执行、易于单文件分发”,File-Based Apps 正好匹配这些需求。
FileBased App + MAF的“王牌组合”
微软在 .NET 10 推进 File-Based Apps,本质是在为更上层的智能体战略——Microsoft Agent Framework(MAF)铺路。MAF 将 Semantic Kernel 与 AutoGen 的核心能力统一起来,提供一套“构建、编排、观测”智能体系统的标准化框架,让多智能体协作从“拼工具”走向“有体系”。
MAF 支持多种协作模式:顺序(Sequential)、并发(Concurrent)、移交(Handoff)、群聊(GroupChat)、主从(Magnetic)。这些模式的共同痛点是:智能体往往需要临时生成一段代码来处理数据、做计算或验证结果。
File-Based Apps 用“单文件 + 内嵌依赖指令 + 即编即跑”把执行门槛降到最低:每个智能体都能快速产出可运行的 C# 任务片段,减少传统项目结构带来的脚手架成本和交互延迟。同时借助完善的“智能体黄金三角”,打通开发、观察和交互,例如DevUI + AG-UI + OpenTelemetry 的三角组合。
企业内部培训的“低代码模式”
此外,File-Based App模式也特别利于像Edison所在的制造业企业做Workshop工作坊培训,借助单文件启动Agent,业务人员不需要理解太多的代码内容,只需要了解如何启动和测试Agent项目,如何为Agent添加Skill文档即可。在这种模式下,培训的效果会好于之前需要工程化的.NET项目,大大降低学习门槛。
2 快速开始:HR Support Agent
假设你的企业有这样一个需求:HR部门需要自己动手开发一个Agent,为内部用户提供政策咨询等服务。
这时候,IT部同事给了HR部门一个C#文件,并告诉了HR修改系统提示词,如何添加skill文档,接下来HR就自己添加了两个Skill:
Skill1: 差旅政策
首先,我们创建这个SKILL.md,内容如下:
---
name: travel-policy
description: 公司差旅预订与审批政策。适用于航班预订、酒店预订、差旅审批流程或差旅安全指引等相关问题。
