.NET+AI | MEAI | 智能工具筛选（12）

张

张建站

2026/6/1 14:31:27

10分钟阅读

目录一句话简介核心价值问题场景工作原理实现方式1. 创建 Embedding Generator2. 注册工具集合3. 配置 Tool Reduction 策略4. 对比测试效果未使用 Tool Reduction使用 Tool Reduction 应用场景最佳实践1. 合理设置 toolLimit2. 中间件顺序3. 监控筛选效果4. 手动验证筛选逻辑效果对比总结上一篇一句话简介Tool Reduction 是 Microsoft.Extensions.AI 提供的智能工具筛选中间件通过语义相似度自动过滤无关工具减少 Token 消耗、降低成本并提升模型工具调用准确率。核心价值✅节省 Token自动过滤无关工具减少上下文窗口占用✅提升准确率减少干扰项让模型更精准地选择工具✅降低成本减少请求大小降低 API 调用费用✅加快响应更少的工具描述更快的推理速度问题场景在企业级 AI Agent 应用中我们可能为模型提供大量工具如 50-100 个但并非所有工具在每次对话中都有用。这会导致问题影响工具数量过多上下文窗口被占满浪费 Token 模型选择困难过多选项导致工具调用错误率上升 API 成本高发送大量工具定义增加调用费用响应速度慢模型需要处理更多信息Tool Reduction 的解决方案在发送请求前根据用户输入和对话上下文自动筛选出最相关的工具子集。工作原理Tool Reduction 采用中间件模式在请求到达 AI 模型前进行智能筛选筛选流程为每个工具的名称和描述生成 Embedding缓存为用户的对话消息生成 Embedding计算余弦相似度选出相似度最高的前 N 个工具只将精选工具发送给模型实现方式1. 创建 Embedding GeneratorTool Reduction 依赖 Embedding Generator 计算语义相似度var azureClient AIClientHelper.GetAzureOpenAIClient(); var baseChatClient azureClient.GetChatClient(gpt-4o).AsIChatClient(); // 创建 Embedding Generator var embeddingsClient azureClient.GetEmbeddingClient(text-embedding-3-small); IEmbeddingGeneratorstring, Embeddingfloat embeddingGenerator embeddingsClient.AsIEmbeddingGenerator();2. 注册工具集合定义一组不同领域的工具函数// 天气工具 [Description(获取指定城市的当前天气信息)] string GetWeather([Description(城市名称)] string city) ${city}的天气晴朗温度 25°C; // 股票工具 [Description(查询股票价格)] string GetStockPrice([Description(股票代码)] string symbol) ${symbol} 当前价格$150.00; // 邮件工具 [Description(发送电子邮件)] string SendEmail([Description(收件人)] string to, [Description(邮件主题)] string subject) $邮件已发送到 {to}主题{subject}; // ... 更多工具 // 注册所有工具 var allTools new ListAIFunction { AIFunctionFactory.Create(GetWeather), AIFunctionFactory.Create(GetStockPrice), AIFunctionFactory.Create(SendEmail), // ... };3. 配置 Tool Reduction 策略使用内置的EmbeddingToolReductionStrategy// 创建策略最多保留 5 个最相关的工具 var strategy new EmbeddingToolReductionStrategy(embeddingGenerator, toolLimit: 5); // 构建启用 Tool Reduction 的客户端 var client baseChatClient.AsBuilder() .UseToolReduction(strategy) // 必须在 UseFunctionInvocation 之前 .UseFunctionInvocation() .Build();核心参数embeddingGenerator: Embedding 生成器用于计算相似度toolLimit: 最多保留的工具数量不包括标记为必需的工具4. 对比测试效果场景用户询问北京今天天气怎么样未使用 Tool Reductionvar normalClient baseChatClient.AsBuilder() .UseFunctionInvocation() .Build(); var response await normalClient.GetResponseAsync( 北京今天天气怎么样, new ChatOptions { Tools [..allTools], ToolMode ChatToolMode.Auto } );结果发送了所有 10 个工具的描述模型需要从 10 个工具中选择9 个无关工具浪费了上下文窗口使用 Tool Reductionvar response await client.GetResponseAsync( 北京今天天气怎么样, new ChatOptions { Tools [..allTools], ToolMode ChatToolMode.Auto } );结果自动筛选出 5 个最相关的工具包含GetWeather过滤掉股票、邮件、数据库等无关工具Token 消耗减少 50%准确率提升应用场景场景工具数量Tool Reduction 的作用企业知识库50 个专业领域查询工具根据问题类型筛选相关领域工具智能客服30 个服务类型工具根据客户意图选择对应服务工具开发助手100 个编程语言和框架工具根据任务类型筛选对应技术栈工具多模态应用20 个图像、文本、音频工具根据输入类型选择对应模态工具最佳实践1. 合理设置 toolLimit// 根据场景调整工具数量限制 var strategy new EmbeddingToolReductionStrategy( embeddingGenerator, toolLimit: 5 // 建议 3-10 个 );建议✅ 工具总数 20不启用 Tool Reduction✅ 工具总数 20-50设置 toolLimit 5-8✅ 工具总数 50设置 toolLimit 8-152. 中间件顺序var client baseChatClient.AsBuilder() .UseToolReduction(strategy) // ⚠️ 必须在 UseFunctionInvocation 之前 .UseFunctionInvocation() .Build();原因Tool Reduction 需要在函数调用前筛选工具列表。3. 监控筛选效果创建监控中间件查看筛选结果public static ChatClientBuilder UseToolListLogging(this ChatClientBuilder builder) { return builder.Use( async (messages, options, innerClient, cancellationToken) { Console.WriteLine($发送 {options.Tools?.Count ?? 0} 个工具到模型); returnawait innerClient.GetResponseAsync(messages, options, cancellationToken); }, null); } // 使用 var client baseChatClient.AsBuilder() .UseToolReduction(strategy) .UseToolListLogging() // 添加监控 .UseFunctionInvocation() .Build();4. 手动验证筛选逻辑// 预先测试筛选结果 var testMessages new[] { new ChatMessage(ChatRole.User, 上海的天气如何) }; var testOptions new ChatOptions { Tools [..allTools] }; var selectedTools await strategy.SelectToolsForRequestAsync( testMessages, testOptions, CancellationToken.None ); Console.WriteLine($原始: {allTools.Count} 个工具); Console.WriteLine($筛选后: {selectedTools.Count()} 个工具); 效果对比指标无 Tool Reduction使用 Tool Reduction改善发送工具数10 个5 个⬇️ 50%Token 消耗~2000~1000⬇️ 50%响应速度3.5 秒2.1 秒⬆️ 40%工具调用准确率85%95%⬆️ 10%API 成本$0.006$0.003⬇️ 50% 总结✅核心价值Tool Reduction 通过语义相似度自动筛选工具节省 Token、降低成本、提升准确率✅实现方式使用EmbeddingToolReductionStrategy策略 .UseToolReduction()中间件✅关键配置合理设置toolLimit参数控制保留的工具数量✅最佳实践在UseFunctionInvocation()之前调用添加监控验证效果✅适用场景企业知识库、智能客服、开发助手等大量工具的 AI Agent 应用下一步探索更多 Microsoft.Extensions.AI 高级功能如自定义 Tool Reduction 策略、性能优化等。引入地址

QKeyMapper：打破Windows输入限制的终极解决方案

QKeyMapper：打破Windows输入限制的终极解决方案【免费下载链接】QKeyMapper [按键映射工具] QKeyMapper，Qt开发Win10&Win11可用，不修改注册表、不需重新启动系统，可立即生效和停止。支持游戏手柄映射到键鼠，手柄摇…...

2026/6/1 14:31:26 阅读更多 →

颠覆网盘下载体验：8大平台直链解析技术深度解析与实战指南

颠覆网盘下载体验：8大平台直链解析技术深度解析与实战指南【免费下载链接】Online-disk-direct-link-download-assistant 一个基于 JavaScript 的网盘文件下载地址获取工具。基于【网盘直链下载助手】修改 ，支持百度网盘 / 阿里云盘 / 中国移动云盘 / …...

2026/6/1 14:31:26 阅读更多 →

Dynamic Workflows 深度解析：Claude Code 为什么把多 Agent 编排写进可执行代码

把多 Agent 编排迁出聊天上下文，用可执行脚本承载复杂工程任务。原文链接：AI小老六导语 Claude Code 的 Dynamic Workflows 容易被误读成“多开几个 subagent”。这个理解太浅了。真正的变化不在并行数量，而在控制平面。过去&#x…...

2026/6/1 14:29:16 阅读更多 →

Windows防撤回终极指南：如何永久保存微信QQ撤回消息

Windows防撤回终极指南：如何永久保存微信QQ撤回消息【免费下载链接】RevokeMsgPatcher :trollface: A hex editor for WeChat/QQ/TIM - PC版微信/QQ/TIM防撤回补丁（我已经看到了，撤回也没用了） 项目地址: https://gitcode.com/…...

2026/6/1 2:02:21 阅读更多 →

终极视频下载解决方案：VideoDownloadHelper 完全指南

终极视频下载解决方案：VideoDownloadHelper 完全指南【免费下载链接】VideoDownloadHelper Chrome Extension to Help Download Video for Some Video Sites. 项目地址: https://gitcode.com/gh_mirrors/vi/VideoDownloadHelper 还在为无法保存网络上的精彩…...

2026/5/31 0:01:42 阅读更多 →

小微企业合作网络与成长预测解析方案【附代码】

✨ 长期致力于小微企业、合作网络、网络结构、企业成长、成长预测研究工作，擅长数据搜集与处理、建模仿真、程序编写、仿真设计。 ✅ 专业定制毕设、代码 ✅ 如需沟通交流，点击《获取方式》 （1）基于提名生成法的合作网络构建与结构…...

2026/5/31 0:03:05 阅读更多 →

终极键盘映射工具：如何免费解决游戏按键冲突问题

终极键盘映射工具：如何免费解决游戏按键冲突问题【免费下载链接】socd Key remapper for epic gamers 项目地址: https://gitcode.com/gh_mirrors/so/socd 你是否曾在激烈的游戏中因为同时按下左右方向键而让角色卡顿不前？是否在关键时刻因为按键…...

2026/6/1 5:51:17 阅读更多 →