企业官网建设流程全解析

MAF 与 MEAI 工具调用中间件集成

一句话简介

MEAI 的 UseFunctionInvocation 与 MAF 的 Function Middleware 是嵌套协作关系，前者负责自动化循环，后者负责业务控制。

🎯 核心价值

• ✅嵌套协作：UseFunctionInvocation 在外层，MAF Middleware 在内层

• ✅职责分离：MEAI 管自动化，MAF 管业务逻辑

• ✅触发次数相等：FunctionInvoker 和 MAF Middleware 触发次数相同

📝 四层调用架构

各层职责对比

💻 执行链路

1. LLM 返回需要调用工具 GetWeather ↓ 2. 🔄 UseFunctionInvocation 检测到 FunctionCallContent ↓ 3. 📝 调用 FunctionInvoker（如果配置了） ↓ 4. 📝 FunctionInvoker 调用 context.Function.InvokeAsync() ↓ 5. 🔧 触发 MAF Function Middleware Pre-Invoke ↓ 6. ⚙️ 执行实际工具函数 GetWeather("北京") ↓ 7. 🔧 触发 MAF Function Middleware Post-Invoke ↓ 8. 📝 返回给 FunctionInvoker ↓ 9. 🔄 UseFunctionInvocation 将结果回传给 LLM

💻 配置示例

完整配置

// 1️⃣ ChatClient 层配置 var chatClient = baseChatClient .AsBuilder() .UseFunctionInvocation(configure: options => { options.AllowConcurrentInvocation = true; // 并发调用 options.MaximumIterationsPerRequest = 10; // 迭代控制 // 可选：自定义 FunctionInvoker options.FunctionInvoker = async (context, ct) => { Console.WriteLine($"📝 MEAI: 调用 {context.Function.Name}"); returnawait context.Function.InvokeAsync(context.Arguments, ct); }; }) .Build(); // 2️⃣ Agent 层配置 var agent = chatClient.CreateAIAgent(...) .AsBuilder() .Use(async (agent, context, next, ct) => { Console.WriteLine($"🔧 MAF: 调用 {context.Function.Name}"); returnawait next(context, ct); }) .Build();

🏢 最佳实践

职责分离原则

// ✅ 推荐：清晰的职责分离 .UseFunctionInvocation(configure: options => { // MEAI 层：只负责自动化控制 options.AllowConcurrentInvocation = true; options.MaximumIterationsPerRequest = 10; // 不配置 FunctionInvoker，让 MAF 层统一处理 }) .Use(async (agent, context, next, ct) => { // MAF 层：统一的企业级控制 ValidatePermission(context.Function.Name); // 权限检查 LogFunctionCall(context); // 审计日志 returnawait next(context, ct); })

避免重复拦截

// ❌ 避免：在两个地方做相同的事 .UseFunctionInvocation(options => { options.FunctionInvoker = async (ctx, ct) => { Console.WriteLine("MEAI: 日志记录"); // 重复！ returnawait ctx.Function.InvokeAsync(...); }; }) .Use(async (agent, ctx, next, ct) => { Console.WriteLine("MAF: 日志记录"); // 重复！ returnawait next(ctx, ct); })

使用场景选择

🎯 总结

• ✅嵌套关系：UseFunctionInvocation → FunctionInvoker → MAF Middleware → 工具

• ✅触发次数：FunctionInvoker 触发次数 == MAF Middleware 触发次数

• ✅职责分离：MEAI 负责自动化，MAF 负责业务逻辑

• ✅最佳实践：不要在两层做重复的事，统一在 MAF 层处理

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