夜雨聆风学习资料网

ARTICLE · 1360526

MCP资源机制:把企业文档喂给Agent

MCP资源机制:把企业文档喂给Agent

TOPIC:S3-1

企业想让 Agent 真干活,第一道坎不是模型不够聪明,而是它读不到企业里的东西:产品手册在网盘、报价单在表格、工单记录在系统里。MCP 的 Resources 机制就是为这一步准备的——今天讲清原理,再给一段能跑的 Server 代码。

先分清两个词:Tools 是"动作",让 Agent 能执行操作;Resources 是"资料",把文档以只读的方式挂出来。大白话:Tools 是给 Agent 发工牌,Resources 是给它开一个只许看、不许拿的资料柜。

原理:uri 定位,list 发现,read 读取

每个资源有一个固定格式的地址(uri),比如 doc://product/manual。客户端先调 resources/list 拿到目录,再把选中资源的 uri 传给 resources/read 拿内容。注意一个关键设计:资源是 Agent 主动按需拉的,不是 Server 一股脑塞给它——上下文窗口就那么大,目录先行、按需取内容,Token 才花在刀刃上。

代码:20 行把文档挂上去

from mcp.server.fastmcp import FastMCP mcp = FastMCP("company-docs") @mcp.resource("doc://product/manual") def product_manual() -> str: """产品手册(只读快照)""" return open("/data/manual.md", encoding="utf-8").read() @mcp.resource("doc://sales/price-list") def price_list() -> str: return open("/data/price.csv", encoding="utf-8").read() if __name__ == "__main__": mcp.run(transport="stdio")

客户端侧两步:列目录、按 uri 读取。把读到的内容拼进系统提示或对话上下文,Agent 回答"报价是多少"时就有了唯一可信的出处。

为什么这一步值得企业现在就做

给几个可验证的行业坐标:中国 AI Agent 市场规模 2026 年预计 449 亿元,到 2029 年预计达 3320 亿元;同时有 88% 的智能体部署发生过生产事故、约 40% 的试点预计在 2027 年前被废弃。差的那些项目,多数不是输在模型,而是输在数据接不进、权限管不住。Resources 这层把文档留在内网、只放只读快照、每次读取留日志,正是把"试点"变成"生产"的第一道闸门。

踩坑点

  • 大文件直接裸读:一本 200 页手册塞进上下文,一次对话烧掉一大笔 Token。先切分、给每个资源配摘要,正文按需再读。
  • 资源里混敏感字段:报价单里的成本列、客户手机号必须先脱敏再挂载,Server 是最后一道闸。
  • 版本不管理:手册更新了快照没更,Agent 拿旧报价承诺客户。给资源加更新时间戳,读取时校验新鲜度。

行动建议:从企业里挑一份最常被员工翻的文档,今晚就照上面 20 行代码挂成资源,让 Agent 回答一次真实问题,验证这层薄薄的接口值不值。

0基础想学AI,就关注极客AI社群JKAI2e,专业部署企业级AI智能体Agent、GEO、OPC项目合作、陪跑,AI智能体矩阵获客、AI智能体双域生态闭环、全网横纵矩阵链路搭建,自媒体短视频矩阵、公众号矩阵、站群矩阵、AI员工智能体矩阵、定向精准推广获客JKAI2e。

关于本号

极客AI殿堂|技术号·极客沉淀
讲原理,能复现。

主号推荐 · 极客AI聚合社

极客AI聚合社|主号·品牌枢纽
讲清楚、有温度,社群入口。

极客AI聚合社群 · 5 个号怎么选

公众号角色适合看什么
极客AI聚合社主号·品牌枢纽讲清楚、有温度,社群入口
极客AI聚合工具号·低门槛看完就能上手
AI极客殿堂资讯号·高频活跃快而可信,帮你筛信息
极客AI殿堂 (本号)技术号·极客沉淀讲原理,能复现
聚合AI员工JH-Agent实战号·转化促活有结果,可照抄

话题:

#极客AI社群 #聚合AI员工Agent #人工智能体 #AI员工 #AI #Workbuddy #DeepSeek #kimi #GLM #Qwen #MiniMax #Baichuan #Yi #AIagent #AIGC #FED #OPC #GEO #LLM #Prompt #Context #MCP #Skill #Agent #Harness #Token #RAG

✅极客AI社群 欢迎关注!一群极客彼此点燃AI火种,相互学习AI Agent一起搭建起自己的AI提效运营中心。🚀起飞让我们就从极客AI社群开始✊

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料