.NET 10 AI 学习路线图从 Minimal API 到 Agent 产品一篇写给 .NET 程序员的上手路线。不劝你用 Python 重写后端而是把 AI 当成「新一类后端依赖」来学——先用起来再逐步把数据库、工具和推理挂上去。一、为什么需要这份路线图很多 .NET 开发者面对 2026 年的 AI 浪潮会卡在一个念头「我是不是得转 Python」答案是不用。.NET 10 是 LTS支持到 2028-11底座是C# 14 ASP.NET Core 10 EF Core 10 Aspire 13。这一代最关键的不是某个新语法而是微软把 AI 抽象做进了 BCLMicrosoft.Extensions.AIMEAI统一的IChatClient抽象换模型只要改一行。MCP C# SDK 1.0把你的 Service 方法变成 AI 可调用工具。Agent Framework 1.0管多步推理、上下文压缩、多 Agent 协作。一句话你十年积累的后端代码加几个 Attribute 就成了 AI 时代的工具箱。这份路线图借用「先就业、后深入」的 AI 学习心法——先用起来 → 理解边界 → 搭个人工作流 → 做产品/IP把它完整重排成 .NET 10 版本。二、核心心法四步走步骤心态.NET 10 对应动作先用起来把 AI 当实习生Minimal API MEAI 接一次大模型理解边界知道它为什么胡说DI/EF/AOT 原理 MCP 概念 上下文压缩搭工作流嵌进日常开发RAGEF Core 向量 MCP 暴露旧 Service SSE做产品封装成对外服务Agent Framework 多 Agent A2A Foundry 托管原则别一上来背概念先让 ASP.NET Core 10 跑起来再让大模型在你路由里答一句话然后逐步把数据库/工具/多步推理挂上去。三、阶段一先用起来2~3 周目标跑通一个 .NET 10 后端并让大模型在你的接口里「说一句话」。学什么.NET 10 安装SDK、VS2026 / VS Code C# Dev Kit项目里开LangVersion14/LangVersion。ASP.NET Core 10 Minimal APIapp.MapPost(/chat, ...)、内置DataAnnotations校验、IResult返回、SSE 原生流式text/event-stream。EF Core 10 基础DbContext、ef core migrations、FirstOrDefaultAsync、JSON 列。接 AI 的第一行代码Microsoft.Extensions.AI的IChatClient。builder.Services.AddChatClient(newOpenAIChatClient(gpt-4o-mini,apiKey));控制器里注入IChatClientawait chatClient.CompleteAsync(用一句人话解释什么是 MCP)。做 3 个真实小任务别写教程 Demo一个/echoMinimal API把请求体校验跑通。一个/ask接口把前端问题转发给大模型用HTTP/SSE流式吐字。用EF Core把对话日志存进SQLite能按session查历史。本阶段别碰❌ 别学 Transformer 数学❌ 别自己搭向量库❌ 别写 Agent会劝退里程碑让 ASP.NET Core 10 跑起来让大模型在你的路由里「说一句话」。四、阶段二理解边界3~4 周目标知道 .NET 10 每块干嘛、AI 为什么会胡说。.NET 侧必须懂的 5 件事DI 生命周期AddSingleton/Scoped/TransientandKeyed DI / Keyed Service在 Minimal API 里怎么选。Minimal API 校验链[Required]IValidatableObject 自定义Filter。EF Core 10 新特性直接用在后面 RAG 检索增强生成Retrieval Augmented GenerationLeftJoin/RightJoin原生支持命名查询过滤器IgnoreQueryFilters([TenantFilter])向量相似度搜索production-readyNative AOT 与容器控制台程序dotnet publish直接出镜像冷启动快75%。Aspire 13 是什么不是必学但要知道它能把「Web API Worker DB MQ Redis AI 服务」一键起分布式追踪。AI 侧必须懂的 4 个名词人话版Prompt 边界模型不是搜索引擎缺上下文就编——所以用RAG补上下文基于事实来源。幻觉模型自信地错解法 给原文引用 让 EF 存溯源。上下文窗口Token词元有限长会话要压缩Agent Framework的Automatic context compaction就是干这个。MCP模型上下文协议把「查订单」、「读 Confluence」、「调内部 API」包成标准AI Tool模型按schema调用不用每人写胶水代码。小实验把阶段一的/ask改成系统提示写「你是售后助理只允许用工具查数据」不挂工具时故意问「我上次退货到哪了」观察它怎么编。五、阶段三把 AI 嵌进工作流4~6 周目标用 .NET 原生栈做出一个内部知识库问答。5.1 RAG 落地全程 .NET切片Microsoft.Extensions.DataIngestion读PDF/MD/Confluence导出。向量化IEmbeddingGeneratorM.E.AI抽象可换OpenAI/Azure/Ollama。存储EF Core 10 向量列或Microsoft.Extensions.VectorDataPG / Cosmos / SQLite都行。检索 生成M.E.AI的ChatClient 把命中片段塞进ChatMessage。通俗说公司文档进数据库 → 用户提问变向量 → 找最像的 3 段 → 连同问题喂给大模型 → 回答带引用。5.2 MCP C# SDK关键一步NuGetModelContextProtocol 2026年2月份 1.0 已 GA。# 当下最新版本2026-08-28dotnetaddpackage ModelContextProtocol--version2.2.0[McpServerTool(Title查库存)]publicstaticasyncTaskstringCheckStock(stringsku){// 里面就是普通 EF Core 查询}前端 / Claude / Cursor / 自研 AI Agent 都能发现这个 Tool模型自己决定什么时候调用。对 .NET 人来说你以前写的 Service 方法加个 Attribute 就变成 AI 可调用能力。5.3 异步工作流用Aspire把Web API Worker Qdrant PG组一起跑。用BackgroundService做文档增量嵌入。用SSE / WebSocketStream.NET 10 新增·一等公民做前端流式。阶段交付物一个「内部知识库问答」上传 Markdown → 后台嵌入前端提问 → Minimal API 走 RAG → SSE 吐答案模型可经 MCP 调「查最新价格」「开工单」六、阶段四做 Agent 产品 / 对外服务长期6 周目标把能力封装成可对外服务的 AI Agent 产品。用 Microsoft Agent Framework 1.02026-04 GA关于MAF更多信息请查看https://www.nuget.org/profiles/MicrosoftAgentFramework它把Semantic KernelAutoGen合并了.NET/Python同API。核心构件AIAgent/ChatClient.AsHarnessAgent()自带上下文压缩、Todo、文件记忆、Plan/Execute模式。MCP 集成Agent 直接消费你阶段三写的MCP Server。A2A多个Agent互相派活比如「售前 Agent」转「工单 Agent」。Foundry Hosted Agents本地跑完直接丢Azure AI Foundry托管带鉴权/伸缩/追踪。最小AI Agent示例varagentchatClient.AsHarnessAgent(128_000,16_384,new(){Name售后Agent,ChatOptionsnew(){Instructions先查MCP工具再回答拿不到证据就明说,Tools{newCheckStockTool(),newOpenTicketTool()}}});产品化时补的 .NET 能力鉴权ASP.NET Core Identity 10原生Passkey无密码。多租户EF Core 10命名过滤器TenantFilter。观测Aspire 13 Service Defaults的OpenTelemetry自动埋点让AI Agent每步Tool调用可见。部署Native AOT 容器原生镜像Lambda/ACA/自建 K8s or K3s都行。可交作业选一个做深垂直 Agent比如「.NET 报错诊断 Agent」接 GitHub MCP 文档 MCP 你公司/单位代码索引。企业内部 CopilotOutlook 邮件 → MCP 查 CRM → Agent 起草回复。小程序后台.NET 10 做 API前端微信小程序Agent 管多轮订餐/售后。七、四阶段对照表一眼看懂原文 AI 路线.NET 10 对应做法周期先用起来当实习生Minimal API M.E.AI 接一次 Chat2-3 周懂原理/边界Prompt/幻觉DI/EF/AOT 原理 MCP 概念 上下文压缩3-4 周搭个人工作流RAGEF Core 向量 MCP 暴露旧 Service SSE4-6 周做产品/IPAgent Framework 多 Agent A2A Foundry 托管长期八、给 .NET 程序员的建议别从 Python 重写后端——用 M.E.AI 做统一抽象即可。别一上来学 Transformer——先跑通再深入。先让 ASP.NET Core 10 跑起来。再让大模型在你路由里答一句话。最后把旧系统变成 AI Agent 的工具箱。.NET 10 是 LTS支持到 2028你现在学的这套技术栈至少能撑 3 年。九、书签级清单按序刷安装.NET 10 SDK→ 写一个带校验的Minimal API接Microsoft.Extensions.AI跑通/askSSE用EF Core 10存对话历史 → 加LeftJoin练习用DataIngestionVectorData做 100 篇MD的RAG把「查库存」方法标[McpServerTool]起MCP Server前端接MCP客户端看模型自己调工具引入Microsoft.Agents.AI写单 Agent带 Todo 记忆两个 Agent 用 A2A 分工Aspire Docker 起全套丢容器跑温馨提示别一上来背概念先让 ASP.NET Core 10 跑起来再让大模型在你路由里答一句话然后逐步把「数据库/工具/多步推理」挂上去。