逐日AI微信小程序
7 天 MCP:把工具接进任何 Agent
第 1 周 · D3🔒 锁定约 5 小时

resources 与 prompts:URI 模板、变更通知、进度与日志、分页,以及客户端能力

把只读数据做成资源、把重复问法做成提示模板,再补齐 URI 模板、分页、进度、订阅与缓存这几件让服务端在真实数据量下还能用的事。

今日目标 0/3

登录后可以勾选并保存进度。

今日目标

  1. 能判断一份数据该做成资源还是做成工具,并说出判断依据
  2. 能用 URI 模板暴露一组参数化资源,并为列表接口实现游标分页
  3. 能说清订阅流与请求内通知的区别,并各举一个使用场景

昨天你的服务端只有工具,一共两个,谁调都一样快。今天换一份真实体量的数据进来——几千篇笔记——你会立刻撞上分页、缓存和通知这三堵墙。完整的报文骨架 D1 已经拆过一遍,今天只看新增的那几个字段。读完回来把上面三条勾掉。

小白版讲解

资源是应用驱动的:谁决定它进不进上下文

先回到插座那个类比。工具像是电器上的开关:模型看着说明书自己按。资源不一样,它更像插排上贴的标签——宿主应用或用户扫一眼,决定这一路要不要通电。

规范把这件事说得很直白:资源是"应用驱动"(application-driven)的,由宿主应用决定怎么把它并进上下文。典型的界面形态是一个文件选择器、一棵目录树,或者一个搜索框;也可以由应用按启发式规则自动带上。而工具是"模型控制"的,模型看着描述自己挑。

所以同一份数据做成哪一种,判据不是"它是什么",而是这一次由谁来决定用不用它:

情况做成
只读、可枚举、希望用户在界面上挑资源
会产生副作用,或要由模型自己判断何时使用工具
需要一次检索出结果,而不是先列后读工具(哪怕它是只读的)

最后一行是最容易搞错的地方。"搜索代码"看起来是只读的,像资源,但它没法枚举——你不可能把所有可能的查询词列成一张清单让用户挑。能不能被列出来,是资源和工具之间那条最实用的分界线。

这条分界线还有一个说不出口但很现实的好处:资源不进上下文就不花钱。工具的定义无论用不用,每一轮都要塞进请求里;资源只是一条清单项,宿主不选它就一个 token 都不占。一个有三千篇文档的知识库,做成三千个工具会直接把上下文撑爆,做成资源则只在用户点中那一篇时才付费。

问题也就跟着来了:三千篇笔记,resources/list 一次性全吐回去吗?

登录并关联后阅读全文

请先登录网页,并在账户页关联微信小程序账号。关联后每天可免费阅读 1 篇;额外文章需在小程序看广告解锁。

小程序码

微信扫码打开「逐日AI」,进入相同课程和章节,选择看广告解锁,完成后刷新本页。

面试题库

  • 同一份数据,做成 MCP 资源和做成工具有什么区别?你按什么标准选?For the same data, what is the difference between exposing it as an MCP resource versus a tool, and how do you choose?
    国内高频海外高频基础#primitives#server-design

    🔒 解锁本章后查看答题要点。

  • MCP 的分页游标为什么必须是不透明的?如果客户端去解析它,会出什么问题?Why must MCP pagination cursors be opaque, and what breaks if a client parses them?
    国内高频海外高频进阶#pagination#api-design

    🔒 解锁本章后查看答题要点。

  • 订阅流和请求内的进度通知在 HTTP 上都走 SSE,为什么 2026-07-28 规范要把它们分成两个通道?On HTTP both subscription streams and in-request progress notifications ride SSE, so why does the 2026-07-28 spec split them into two channels?
    国内高频海外高频深入#subscriptions#notifications

    🔒 解锁本章后查看答题要点。

评论