企业官网建设流程全解析

MAF 中间件执行顺序：深入理解洋葱模型

一句话简介

MAF 中间件遵循"洋葱模型"执行，请求从外向内，响应从内向外，正确理解执行顺序是构建企业级 Agent 的关键。

🎯 核心价值

• ✅洋葱模型：请求依次经过外层→内层，响应按相反顺序返回

• ✅三层触发频率：Agent Run 1次、ChatClient N次、Function M次

• ✅精确时序：通过时间戳追踪完整执行链路

📝 执行顺序详解

触发次数对比

💻 时序验证示例

带时间戳的中间件

var startTime = DateTime.UtcNow; double GetTimestamp() => (DateTime.UtcNow - startTime).TotalMilliseconds; // Agent Run 中间件 .Use(async (messages, thread, options, inner, ct) => { Console.WriteLine($"[T+{GetTimestamp():F0}ms] 🛡️ Agent Run Pre"); var response = await inner.RunAsync(messages, thread, options, ct); Console.WriteLine($"[T+{GetTimestamp():F0}ms] 🛡️ Agent Run Post"); return response; }, null)

典型输出

[T+0ms] 🛡️ Agent Run Pre [T+50ms] 📊 ChatClient Pre (第1次) [T+1200ms] 📊 ChatClient Post (第1次) [T+1210ms] 🔧 Function Pre: GetWeather [T+1320ms] 🔧 Function Post: GetWeather [T+1330ms] 📊 ChatClient Pre (第2次) [T+2500ms] 📊 ChatClient Post (第2次) [T+2510ms] 🛡️ Agent Run Post

📊 触发次数统计

场景：调用 2 个工具

Agent Run 中间件: 1 次 ChatClient 中间件: 2 次（初始调用 + 工具结果后调用） Function 中间件: 2 次（每个工具各 1 次）

计数器验证代码

var agentRunCount = 0; var chatClientCount = 0; var functionCount = 0; // 统计后输出 Console.WriteLine($"Agent Run: {agentRunCount} 次"); Console.WriteLine($"ChatClient: {chatClientCount} 次"); Console.WriteLine($"Function: {functionCount} 次");

🏢 企业级最佳实践

中间件注册顺序

注册顺序示例

var agent = chatClient.CreateAIAgent(...) .AsBuilder() .Use(LoggingMiddleware) // 最先注册 → 最外层 .Use(SecurityMiddleware) // 中间注册 → 中间层 .Use(CachingMiddleware) // 最后注册 → 最内层 .Build();

执行顺序：

请求 → Logging → Security → Caching → AI模型 响应 ← Logging ← Security ← Caching ←

🎯 总结

• ✅洋葱模型：请求从外向内穿透，响应从内向外返回

• ✅触发频率：Agent Run 1次，ChatClient/Function 多次

• ✅注册顺序：先注册 = 更外层 = 先执行 Pre、后执行 Post

• ✅实践建议：日志最外层，缓存最内层

如需获取文章配套完整代码，可扫码咨询领取。👇