Agent + MCP:给 Agent 接上真实工具

举报
yd_251796181 发表于 2026/11/17 10:01:22 2026/11/17
【摘要】 AGENT 系列 · 第四篇Agent + MCP:给 Agent 接上真实工具第一篇讲清 Agent 是什么,第二篇动手做出了第一个 Agent,第三篇让几个 Agent 像团队一样协作。这一篇解决一个更落地的问题:怎样让 Agent 不再只会调用演示用的假工具,而是真能查到信息、订得成单、改得了安排。前三篇里的工具——search_stays 查民宿、calc_drive_time 算车...

AGENT 系列 · 第四篇

Agent + MCP:给 Agent 接上真实工具

第一篇讲清 Agent 是什么,第二篇动手做出了第一个 Agent,第三篇让几个 Agent 像团队一样协作。这一篇解决一个更落地的问题:怎样让 Agent 不再只会调用演示用的假工具,而是真能查到信息、订得成单、改得了安排。

前三篇里的工具——search_stays 查民宿、calc_drive_time 算车程、calc_total_price 算总价、get_weather 查天气——都是为了讲清原理设的假想工具。它们的名字和参数都由作者临时约定,背后并没有真实的房源、车次、价格和天气数据。演示时一切顺畅,一旦想真的帮人安排一次出行,问题立刻出现:房源在哪个系统里?价格以谁的为准?订完之后谁来确认?这篇讲的 MCP(Model Context Protocol,模型上下文协议),就是为解决这类接入问题而生的统一办法。

贯穿全文的例子:还是那次两人周末出行。任务不变——住民宿、定交通、看天气、控预算、排行程。变化的是工具的来历:民宿要查真实房源和实时价格,交通要查真实车次,天气要查真实预报,下单和改期要真的写回系统。Agent 本身没有变,变的是它手里的工具从“示意”变成了“实装”。

这篇要讲清的接入链路

环节:为什么不够——光有工具调用,为什么每个工具单独对接会越接越累
环节:MCP 是什么——Host、Client、Server 三方分别是谁,怎么连起来
环节:Server 里有什么——工具、资源、提示词模板三类东西,各自干什么
环节:接线与关系——一次调用完整走一遍;MCP 和工具调用如何分工
环节:权限与落地——读写怎么分、确认点留在哪、最小接入怎么搭、翻车怎么查

先说结论:MCP 不是又一种更强的模型能力,而是一套接入约定。它不让 Agent 变聪明,它让 Agent 能用的工具变得可复用、可替换、可管控。聪明的用法第二篇已经讲过,这一篇只讲一件事——工具从哪来,怎么接得稳。

一、为什么光有工具调用还不够:单独对接,越接越累

第二篇讲的工具调用,解决的是模型一侧的问题:模型知道什么时候该查、该传什么参数、拿到结果后怎么接着想。这一步不可少,但它只管“怎么调”,不管工具本身从哪来。真实工具散落在不同的系统里,每个系统都有自己的接口格式、登录方式、参数口径和错误码。没有统一约定时,每接一个工具,都要为它单独写一遍对接代码。

单独对接的代价:

  • 每个工具重写一遍:接口、鉴权、参数转换、错误处理各写一套。例子:民宿、车次、天气三个系统,三套对接代码。
  • 换模型就要改:工具定义写死在某个模型或应用里,换一处全改。例子:换个模型试效果,四件工具全部重新适配。
  • 换应用也要改:同一个工具在聊天端能用,搬到另一个应用又得重接。例子:出行助手接好的查价工具,行程助手用不上。
  • 口径各自为政:日期、人数、价格单位的定义每个系统都不一样。例子:一处按入住日期算,一处按离店日期算,总价对不上。

工具只有三四个时,这些代价还能忍。工具一旦多起来——查房、查车、查天气、查地图、下单、改期、发通知——对接代码很快比 Agent 本身还厚,而且每改一处都要担心碰坏别处。问题的根源不在某个工具写得不好,而在缺少一层共同约定:工具以什么格式自我介绍,调用以什么格式发起,结果以什么格式返回。MCP 补的正是这一层。

二、MCP 是什么:一套统一的工具接入方式

MCP 是一套开放的协议约定,可以把它理解为工具世界的统一插座:工具一侧按协议提供能力,使用工具的一侧按协议来取用,两边事先不需要互相了解内部实现。接一个新工具,不再是写一套新对接,而是把一个符合协议的服务连上来。

角色分工:

  • Host(宿主):用户直接使用的应用,负责承载对话、管理权限、把模型和工具组织在一起。例子:出行助手这个应用本身。
  • Client(客户端):Host 内部按 MCP 与某个 Server 通话的连接件,一个 Server 对应一条连接。例子:分别连向民宿、交通、天气三个 Server 的连接。
  • Server(服务端):按 MCP 对外提供工具、资源和模板的服务,背后连着真实系统和数据。例子:民宿 Server 背后是房源与订单系统,天气 Server 背后是气象数据。

三方的分工很清楚:Server 只管把能力按标准格式摆出来,Client 只管按标准格式取用和传递,Host 负责全局——用哪个模型、连哪些 Server、哪些操作要先问人。模型并不直接和 Server 说话,它仍然只做第二篇那件事:决定调用哪个工具、传什么参数;真正的连接和执行,由 Client 和 Server 完成。这样分工的好处是可替换:换模型,Server 不用动;换 Server 实现,模型和 Host 也不用动。

三、MCP Server 里有什么:工具、资源、模板

一个 MCP Server 对外提供的东西分三类,很多人只注意到第一类。分清三类,接的时候才不会把该读的资料做成工具、把该固定的话术塞进提示词里反复手写。

  • 工具 Tools:可执行的动作,有明确的输入参数和返回结果,由模型决定何时调用。例子:search_stays 查房源、get_weather 查预报、create_booking 下单、change_booking 改期。
  • 资源 Resources:可读取的上下文资料,像文件一样被取来参考,一般由应用或用户决定何时载入。例子:目的地的入住须知、已确认订单的详情、用户保存的出行偏好清单。
  • 提示词模板 Prompts:预先写好的任务模板,填入参数就能发起一类固定任务,省去每次手写。例子:“按预算排行程”模板、“改期对比”模板,填入日期和人数即可用。

三者的区别,抓一个关键点就够了:工具是动词,资源是名词,模板是句式。工具会产生动作和新结果,资源只是被读来当依据,模板则把一组常用的说法和步骤打包好。把入住须知做成资源,Agent 每次排行程时读一遍即可;若误做成工具,模型就得在一堆工具里反复判断要不要“调用”一份须知,既费步数又容易漏读。反过来,下单必须是工具,因为它要真正改变订单状态,只读的资源做不到。

四、一个真实的接线过程:从发现到重试走一遍

接通一个 Server 后,一次完整的调用要走六步。以“查三家周六可住、两人入住、总价可算的民宿”为例:

  1. 发现:Host 启动时连上民宿 Server,完成协议握手,确认双方版本。要点:连不上就明确报错,不带着“假装有工具”继续跑。
  2. 列出工具:Client 向 Server 索取工具清单,拿到每个工具的名字、说明和参数格式。要点:清单就是模型的工具菜单,说明写得含糊,后面必然选错。
  3. 选工具:模型根据任务选中 search_stays。要点:这一步仍是第二篇的工具调用,模型只做选择,不碰连接。
  4. 传参数:按清单里的格式传日期、人数、区域、预算上限。要点:参数先校验再发送,日期和人数口径以 Server 的定义为准。
  5. 拿结果:Server 查真实房源后返回结构化结果:房源、价格、是否可订。要点:结果带状态和来源,Agent 据此继续算总价、做对比。
  6. 出错重试:超时或临时失败时,按规则重试一次;参数错误则不重试,改参数或问人。要点:分清“临时故障”和“用法错误”,前者重试,后者重试只会重复犯错。

走完这六步,“查民宿”才从演示变成实装:结果来自真实房源,价格是当时的价格,可订状态也是真的。后面算总价、排行程、下单,每一步都重复同样的链路,只是换了 Server 和工具。

五、MCP 和工具调用是什么关系:一个管怎么调,一个管从哪来

读到这里最容易冒出的疑问是:第二篇已经讲了工具调用,MCP 是不是把它替代了?不是。两者管的是两层完全不同的事,配合起来才完整。

  • 回答的问题:工具调用(第二篇)是模型怎么决定调哪个工具、传什么参数、怎么用结果;MCP(这一篇)是工具从哪来、按什么格式接入、谁提供、谁维护。
  • 发生的位置:工具调用在模型一侧,每轮思考时发生;MCP 在应用与服务之间,接入和连接时发生。
  • 类比:工具调用是会打电话的人,知道何时打、说什么;MCP 是统一的电话网络,号码规则一致,接谁都一个打法。
  • 缺了会怎样:缺工具调用,有工具也不会用,模型只会凭空回答;缺 MCP,会用但接不上,每个工具都要单独焊死。

合起来的链路是这样的:MCP 负责把工具按统一格式送到模型面前,形成第二篇那份“工具菜单”;工具调用负责让模型在菜单上做选择并发起调用;调用再经 Client 回到 Server 执行。换句话说,工具调用是用法,MCP 是供法。第二篇的提示词、循环、记忆、刹车全部照旧有效,只是菜单上的菜从假想变成了真实供应。

六、权限与安全:给什么权限,才能用什么

工具一旦接上真实系统,权限就不再是小事。原则先摆明:Agent 的能力上限,由 Server 授予的权限决定,不由模型决定。Server 没给的工具,菜单上根本不会出现;给了只读权限,Agent 就只能查不能改。模型再“想”下单,没有下单工具也下不了——这正是想要的安全边界。

做法:

  • 读写分开:查询类工具(查房源、查车次、查天气、查订单)与写入类工具(下单、改期、取消、付款)分开授权、分开审计,能只给读就先只给读。
  • 敏感操作留确认点:凡是花钱、不可撤销、影响他人的操作,执行前必须把对象、金额、后果摆给人确认;确认点设在 Host 一侧,不依赖模型“自觉”。
  • 最小授权:只连任务需要的 Server,只开需要的工具。排行程的 Agent 不需要取消订单的权限,就不要给。
  • 结果要可追溯:每次写入都记录谁发起、改了什么、何时改的,出问题时能查到是哪一步、哪次调用。

一个常见的误解:把确认点写进提示词,告诉模型“付款前先问我”,不等于有了确认点。提示词是建议,模型可能漏掉;可靠的确认点是 Host 在执行写入工具前强制拦截,拿到人的明确同意才放行。安全靠机制,不靠叮嘱。

七、最小接入:先接一个只读 Server,跑通再扩

MCP 的价值在复用,但起步最忌讳一口气全接上。工具越多,菜单越长,模型选错的概率越高,出了问题也越难定位是哪一环。最小接入的走法和前几篇一致:先跑通一个小闭环,再逐步加。

  1. 选第一个 Server:只读、最高频。出行例子里先接天气或民宿查询 Server——只查不改,风险最低,用得最多,最容易验证结果对不对。
  2. 核对工具清单。逐个看 Server 给出的工具名、说明和参数格式,用三五个真实问题试调,确认返回的是真实数据而不是示例数据。
  3. 跑通完整链路。让 Agent 用这个 Server 完成一次端到端任务,比如查三家民宿并算出总价,确认发现、调用、结果、出错提示都正常。
  4. 再加第二个 Server。接交通查询,重复同样的核对。两个只读 Server 都稳了,再考虑第三个。
  5. 最后才接写入。下单、改期这类工具单独一批接入,同时把确认点、操作记录和撤销办法一起配好,再小范围试用。

接入检查清单:

  • Server 来源可信,版本和维护状态清楚,不是来历不明的服务
  • 工具清单逐项读过:名字、说明、参数、返回格式都看得懂
  • 每个参数的口径已确认:日期按入住还是离店、价格含不含附加费用
  • 权限按最小原则授予:只读先行,写入单独审批
  • 敏感操作的确认点设在 Host 拦截层,不只写在提示词里
  • Server 不可用时有明确降级:告知用户查不到,而不是编一个结果
  • 调用有记录:调了哪个工具、传了什么、返回什么,事后可查

这份清单里最容易被跳过的是第二项和第六项。工具说明读不懂,多半是 Server 写得含糊,接入后模型必然频繁选错、传错;降级没想好,Server 一宕机,Agent 就可能拿旧数据甚至凭空数据顶上——查不到就说查不到,是真实工具场景里最重要的诚实。

怎么判断接得好不好?换一个同类 Server,Agent 侧要改的东西越少越好。理想状态是只改连接配置,提示词、循环和业务逻辑一字不动——做到这一点,才算享受到了统一接入的好处;每换一次就要改一圈代码,说明对接又焊死回去了。

八、常见翻车:接入之后最容易出的问题

  • 模型总选错工具:常见原因是工具描述不清,两个工具的说明听起来差不多。排查与修法:先改描述,写清“什么时候用我、什么时候别用我”,并给反例;描述改好仍选错,再考虑拆分或合并工具。
  • 参数总传错、结果对不上:常见原因是参数口径不一致,日期、人数、单位、时区的定义两边不同。排查与修法:把口径写进工具说明和参数注释,调用前做一层校验;总价对不上时,先查口径,不要先怀疑计算。
  • Server 挂了,Agent 还在“正常”回答:常见原因是没有降级设计,失败被当成空结果,或拿缓存旧数据冒充实时结果。排查与修法:失败必须显形,明确告知哪项查不到、数据是什么时候的;宁可少给一项,不拿旧数据装新数据。
  • Server 升级后突然全坏:常见原因是工具改名、参数变更、返回格式调整,接入侧没有版本意识。排查与修法:接入时记录 Server 版本;升级前先看变更说明,用固定的一组问题回归测试,通过后再切换。
  • 接的工具越多反而越笨:常见原因是菜单太长,相近工具互相干扰,模型注意力被稀释。排查与修法:按任务裁剪菜单,本次任务用不到的工具不挂载;不同场景的工具分组,按需加载。

排查顺序和前几篇一样:先看调用记录,确认到底调了哪个工具、传了什么、返回了什么;再看工具说明和口径;最后才怀疑模型。接入类的问题十有八九出在前两层,急着换模型,往往是在为说明没写清买单。

下一步:给 Agent 加评测

到这一篇为止,Agent 已经能分工、能协作、能接上真实工具做事了。但一个绕不开的问题始终没有回答:它到底做对了多少?查到的价格对不对、行程排得合不合理、十次里错几次、换了工具或改了提示词之后是变好了还是变差了——凭感觉,永远说不清。

下一篇就来补这一课:给 Agent 加评测,系统地测它做对了多少。怎么准备一批有标准答案的任务,怎么打分,怎么把“好像还不错”变成一组能比较、能复查的数字。工具接得再多,没有评测,也只是在凭感觉放大能力;有了评测,每一次改进才有据可查。

回头看这四篇:第一篇认识 Agent,第二篇做出第一个,第三篇学会协作,这一篇接上真实世界。Agent 的能力边界,正从“会回答”一步步扩到“能办事”——而下一步要学的,是如何确认它真的办对了。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。