AI 求职每日一课 · 2026-10-27
第 2 月 · 会构建 · 第 8 周 · 连接工具、状态、记忆与 MCP

AI 求职每日一课 · 2026-10-27

MCP 的三类服务端能力分别承载上下文数据、可调用动作与可复用交互模板。按用途拆接口后,仍要逐次检查权限;发现了能力,不代表已经读取、执行或授权。

课程阶段:第 2 月 · 会构建

本周主题:第 8 周 · 连接工具、状态、记忆与 MCP

今日主课:Resources、Tools、Prompts:数据、动作与模板如何分工

今日成果:运行一个本地能力路由器,区分读取资源、取得提示模板和调用工具,并验证越权与模板注入不能触发动作

适用岗位:AI 应用工程师 / Agent 工程师 / AI 前端 / AI 后端

预计用时:25 分钟

今日 TL;DR

MCP 的三类服务端能力分别承载上下文数据、可调用动作与可复用交互模板。按用途拆接口后,仍要逐次检查权限;发现了能力,不代表已经读取、执行或授权。

  • Resources 用 URI 标识可读取内容,适合岗位资料、文档和其他上下文;应用决定如何取用。
  • Tools 用名称与参数描述动作,模型可以建议调用,执行授权仍归应用与服务端;工具也可以只读。
  • Prompts 提供参数化模板,通常由用户选择使用;取得模板不能自动执行其中提到的工具。

为什么今天学这个

昨天建立了“MCP连接成功不等于业务授权”的边界。本周第二天接着回答接口设计问题:岗位知识库、求职分析模板、创建面试准备单,应该分别怎么暴露?如果把所有能力都做成一个万能工具,模型很难知道哪个只提供背景、哪个会真正改数据,排错也会失去清晰边界。

Resources 是资源,可以理解为“可按地址取得的资料”;Tools 是工具,是“给出参数后执行的一次动作”;Prompts 是提示模板,是“选定一个工作方式后拿到的一组消息”。官方规范常将它们分别描述为应用控制、模型控制、用户控制。这是典型交互设计的区别,不是强制的授权规则,更不代表模型拥有工具最终执行权。Host可以让用户手选工具,也可以在受控流程里主动读取资源,界面设计仍要服务实际任务。

接着上周的可审计Agent项目,本课沿用岗位查证:用户选定岗位后,应用读取岗位Resource,用户选一个分析Prompt,模型如需统计关键词可建议只读Tool。周六跨工具准备台会复用这三类合同。今天不接模型和远程协议,先用可重复的本地函数明确边界;明天把执行进度落到检查点,才能在中断后区分“模板取过了”和“业务动作真的完成了”。

一张图讲清楚

用户选择分析模板Prompts 取得消息模板
应用选择岗位URIResources 读取授权资料
Prompts 取得消息模板Host 组装上下文
Resources 读取授权资料Host 组装上下文
Host 组装上下文模型建议调用Tools
模型建议调用Tools校验身份参数与动作范围
校验身份参数与动作范围Tools 执行并返回结果
Tools 执行并返回结果应用验收与记录

两条输入线最终汇合到上下文,但没有任何一条“模板直接执行”的边。URI只标识资源,不是访问许可证;工具名称只说明调用对象,不证明调用成功。资源内容和Prompt模板都可能包含不可信文本,不能因此扩大工具集合或改变用户身份。图里将授权集中画在工具前,实际读取私有Resource和取得含敏感信息的Prompt时也必须鉴权。

三个核心要点

  • 按业务语义选择能力。 静态岗位说明可做Resource;关键词统计可做只读Tool;“按证据分析岗位”的消息结构可做Prompt。Tools不等于写操作,Resources也不等于无敏感信息。发现阶段应给清晰描述、输入合同和返回类型,而不是一个任意SQL或Shell接口。
  • 发现、获取和执行分别留证。 协议中的resources/list、resources/read、prompts/list、prompts/get、tools/list、tools/call有不同含义;列表成功只证明能力可发现。得到模板后,Host还要决定是否应用;工具结果也要检查业务状态,不能见到一条自然语言“完成”就结束任务。
  • 每类能力都需要最小权限。 从服务端会话取租户,读取Resource时检查归属,调用Tool时检查参数与动作,渲染Prompt时限制输入并保持外部文本的数据身份。工具的只读等注解是提示信息,不能代替服务端授权或作为安全保证。

最小可运行示例

保存为 mcp_capabilities.py,Python 3.10+ 标准库即可,运行 python3 mcp_capabilities.py。输入是本租户岗位URI和模板名;输出是资料、模板与统计结果。这是模拟MCP三类能力的离线业务路由器,不实现JSON-RPC、连接握手、网络认证或真实模型调用。正式连接应采用相应SDK,外层业务授权保留。

from dataclasses import dataclass

@dataclass(frozen=True)
class Session:
    tenant: str

DATA = {
    "job://tenant-a/role-1": ("tenant-a", "需要 Python 与 RAG 经验"),
    "job://tenant-b/role-2": ("tenant-b", "其他客户的岗位"),
}
AUDIT = []

def read_resource(session, uri):
    item = DATA.get(uri)
    if item is None or item[0] != session.tenant:
        raise PermissionError("resource unavailable")
    AUDIT.append("resources/read")
    return {"uri": uri, "mimeType": "text/plain", "text": item[1]}

def get_prompt(session, name, arguments):
    if name != "analyze_job" or set(arguments) != {"uri"}:
        raise ValueError("unknown prompt or arguments")
    # 只返回模板消息;不读取资源,更不执行消息里提到的动作。
    AUDIT.append("prompts/get")
    return [{"role": "user", "content": {
        "type": "text",
        "text": "请分析已授权岗位,证据不足时说明。URI参考:"
                + str(arguments["uri"]),
    }}]

def call_tool(session, name, arguments):
    if name != "count_terms" or set(arguments) != {"uri"}:
        raise ValueError("tool or arguments denied")
    resource = read_resource(session, arguments["uri"])
    AUDIT.append("tools/call")
    return {"counts": {word: resource["text"].count(word)
                       for word in ("Python", "RAG")}}

if __name__ == "__main__":
    session = Session("tenant-a")  # 生产由认证中间件建立
    uri = "job://tenant-a/role-1"
    messages = get_prompt(session, "analyze_job", {"uri": uri})
    assert AUDIT == ["prompts/get"]
    print("template_only", len(messages))
    print(read_resource(session, uri)["text"])
    print(call_tool(session, "count_terms", {"uri": uri}))
    try:
        call_tool(session, "count_terms",
                  {"uri": "job://tenant-b/role-2"})
    except PermissionError as exc:
        print(type(exc).__name__, str(exc))
    before = list(AUDIT)
    get_prompt(session, "analyze_job", {"uri": "delete_everything"})
    assert AUDIT == before + ["prompts/get"]
    print("untrusted_reference_did_not_execute")

预期依次输出template_only 1、岗位原文、Python与RAG各1次的counts、PermissionError resource unavailable,以及untrusted_reference_did_not_execute。最后一个值故意不是合法URI:模板只把它放到数据位置,没有执行器;如果后续真正读取它,read_resource会拒绝。生产模板应额外校验URI形状、长度和允许的协议,不要把这个教学行为当作完整输入验证。

这个实现没有list接口,也没有根据模型输出自动分派Tools。目的是证明三类动作在审计记录中可区分。read_resource成功只能证明读取了本租户资料;count_terms是确定性字符统计,不证明候选人与岗位匹配,更不预测面试结果。对资源实际访问仍需数据库级授权与最小字段投影,不能只在Host用字符串前缀隔离租户。

生产环境会怎么翻车

  1. 模板一取就创建工单。 症状:用户只预览Prompt却产生写入。根因:模板加载器混入执行器。处理:prompts/get只返回消息,真正工具调用经过独立授权、参数摘要与必要确认,执行回执另记。
  2. URI猜对便读到别人的岗位。 症状:跨租户数据出现在上下文中。根因:只验证地址格式,未验证对象归属。处理:从可信会话注入身份,在资源服务逐次鉴权,对不存在和无权访问避免泄漏对象存在性。
  3. 只读注解被当成安全证明。 症状:一个标注readOnly的工具仍修改外部数据。根因:信任服务器的描述超过实际执行合同。处理:审查实现、限制凭据作用域、隔离写接口并用业务日志检查;未知服务器的注解按不可信提示处理。
  4. 模板或文档改变系统指令。 症状:资料里出现“导出所有客户”,模型照做。根因:外部内容被提升为指令。处理:保持内容来源、限制工具白名单、服务端拒绝越权,记录异常并回归,不依赖一句“忽略恶意文本”。

动手练习

用20分钟增加一个 resources/list 的本地替身,仅返回本租户URI,并增加 list_prompts 返回模板名和参数说明。完成条件:正常读取、跨租户拒绝、未知工具拒绝、模板不执行四项都有断言;审计能分开列出发现、获取、执行。再写一段解释:为什么count_terms虽然只读仍是Tool?因为它提供参数化计算动作;不是所有只读能力都必须做Resource。不要引入真实发信或删除接口来演示。

面试表达

30 秒回答

Resources按URI提供上下文,Tools暴露可调用动作,Prompts返回可复用消息模板。典型控制方分别是应用、模型建议和用户选择,但授权始终由应用与服务端检查。我会分开发现、读取、模板获取和工具执行的审计;模板与资料都是外部内容,不能让它们自动授予权限。

追问与 3 分钟回答

如果问“搜索是Resource还是Tool”,我会先看接口语义:按一个稳定URI取已知岗位详情适合Resource;根据查询词执行搜索并返回命中结果适合Tool。Tool可以只读,Resource也可由动态后端产生。选择依据是交互、参数、结果和可发现性,而不是把静态与动态机械地一分为二。

如果问“Prompt中提到删除工具怎么办”,我会解释取得模板与执行动作之间没有必然关系。Host可以展示模板,用户决定应用,模型可能建议工具,但调用前必须检查当前用户权限、目标对象和动作范围。对外发信或其他副作用另走确认与幂等。拒绝后应返回明确状态,不能为了满足模板而换更强权限重试。

作品集会展示三类接口、服务端授权点和四个失败输入。记录可以帮助排错,但只保存必要字段;资料和提示里的隐私不能无限写进日志。明天的检查点还要保存模板版本与资源版本,否则恢复时可能拿旧批准执行新内容。

今日自测

1. 基础理解

取得一个Prompt模板,是否表示里面提到的Tools已经调用?不是。prompts/get返回消息模板;调用工具是单独的动作,需要授权、执行与结果记录。

2. 工程取舍

关键词统计只读,为什么可以设计成Tool?它接收参数执行计算并返回结果,符合Tool语义。只读并不等于Resource;Resource更适合按URI提供上下文。

3. 场景应用

远程工具标注readOnlyHint=true,可以跳过权限检查吗?不可以。注解是提示,尤其来自未知服务器时不应当成安全事实;仍要验证凭据、对象、实现及实际副作用。

市场雷达

本期无新增市场信号。今日读取官方协议说明以核验能力与安全边界,未将文档访问日期当成最近30天的规范发布日期,也未编造JD或招聘数字。

权威来源

  • MCP Resources规范 — URI、资源读取和应用控制的典型交互。
  • MCP Tools规范 — 工具发现、调用与安全考虑;工具描述/注解不替代信任与授权。
  • MCP Prompts规范 — 参数化消息模板及用户控制的典型交互。

上述三个官方页面于2026-10-27 09:02(Asia/Shanghai)实际访问HTTP 200。本课固定引用2025-06-18版本说明基本语义,不声称它是当前最新版;生产需与实际Server协商版本。示例是本课编写并离线验证的业务骨架,不是官方SDK示例。

明天会用到

明天学习检查点和断点续跑:保存已完成动作、资源与模板版本、待执行请求及真实回执,中断后先核实副作用,再决定从哪条边继续。今天区分的三类记录,是恢复时判断事实的基础。