夜雨聆风学习资料网

ARTICLE · 1319821

从「资源可下载」到「Agent 可集成」:打造 Agentic 时代的开放生态基座

从「资源可下载」到「Agent 可集成」:打造 Agentic 时代的开放生态基座
01
引言

作为开放的 AI 开源社区,魔搭社区一直致力于建成中国乃至全球 AI 模型开源的底层基础设施,服务最广泛的 AI 开发者生态。而过去一年,AI 技术的讨论重心正在从「以模型为核心」向「 Agent」扩展。从广受欢迎的 Claude Code、Codex,到各类新兴 Coding Agent 、办公 Agent、Personal Agent,越来越多的智能体开始进入开发者的日常工作流。业界也逐渐形成一个共识:未来的产品不仅需要向人提供服务,更需要向 Agent 提供服务。

这对平台提出了新的要求:

  • 过去使用者是人,人要看文档、装环境、复制配置;现在多了一类使用者是 Agent,它不读图文教程,而是读 Spec、调 endpoint。

  • 过去开放单位是模型权重,解决「拿得到」;现在要开放能力和基础设施,做到可触达、易获取、内容质量高。

  • 过去交互以 GUI 为主,OpenAPI 与 CLI 是辅助,由人驱动;现在需要兼顾 API、MCP、Skills,由智能体驱动。

当 Agent 替人去选模型、选工具、选数据时,平台光「资源丰富」已经不够,还要「容易被集成」。贴合这一业界发展的趋势,魔搭也致力于将与Agent的交互融合到平台能力的中,方便模型与 Agent 能像开发者一样使用魔搭,同时也帮助开发者实现与魔搭更全方面的交互。

这些努力由三个方面构成:

  1. 全面开放 OpenAPI,实现全站可编程——OpenAPI开放接口;

  2. 打造 Agentic 友好站点,实现全站 Agent 可读——GEO/SEO机器可读入口开放。

  3. 构建 Agent 资源库,支持 Agent 运行时——智能工坊与 Agent 实验场;

02
全站接口开放,OpenAPI First

作为全面拥抱开源开放的社区,魔搭通过OpenAPI,开放了其全栈核心接口,其 OpenAPI 支持覆盖了平台的 13 个业务模块,包括社区里的模型、数据集、创空间、合集、用户信息、Skills、MCP、Agents 等核心模块。

项目

规模

paths

64

operations

88

schema

187

业务域

13(User、Models、Datasets、MCP、Studios、Skills、AgentHub、Files、Agent-IDP、Magicube、Collections、Galleries、Agent Playground)

鉴权

Bearer Token / OAuth 2.0

魔搭的 OpenAPI 支持Bearer Token鉴权与 OAuth 2.0 鉴权,并支持机器通过标准 OpenAPI 自发现端点直接读取接口文档。无论是 Agent 系统开发、模型开发流水线,还是 AI 应用与工具等,均可零门槛接入。

除 Restful 接口外,开放能力还以三种形态触达开发者与 Agent:

ModelScope Hub CLI:pip install modelscope-hub 即可使用,如模型下载用 modelscope model download,以便开发者与Agent操作。

MCP:modelscope-mcp-server 由OpenAPI转换而来的远程 MCP,Agent 可标准调用。

Skills:平台官方提供的ms-hub Skills 指引 Agent 针对全站各类资源进行搜索、下载、上传、部署等操作;studio-deploy Skills 让 Agent 一键把应用部署到创空间。

通过这些开放的OpenAPI接口,开发者可以做到无需站点界面,也能通过 AI Agent 完成站点资源获取、使用与贡献。我们的目标是,所有面向用户的平台能力,均同步开放 OpenAPI 接口。

03
GEO:让站点先被 Agent 读懂

传统的站点往往面向人的浏览行为与偏好设计,这使得Agent 访问传统站点时经常会遇到阻力,耗时很久仍拿不到想要的资源;即使进入页面,也要模拟浏览器行为、解析 DOM,消耗大量 Token,还容易出错。魔搭希望将 Agent 视作社区的原住民,通过开放实现“Agent 友好” 的站点功能与服务,扩展社区的 Agentic 读取开放。魔搭全面推进全栈的GEO (Generative Engine Optimization) 接入,支持模型与Agent与平台的原生交互。

以模型页面为例:过去 Agent 通常看到的是一堆 HTML,需要猜字段、解析 DOM,经常出错;而魔搭的站点,不仅可以直接 GET models/{owner}/{name} 拿回结构化 JSON,参数量、任务类型、license、下载量、文件大小等等信息,还可以直接通过 .mdURL 直接读取页面内容,让 Agent 不绕弯路即可完成任务,大大节省 Token。

Agent友好站点核心包括三个方向的特性:

  • 一是可被发现。 除了公开 OpenAPI Spec /.well-known/openapi.json,魔搭还支持了llms.txt、 sitemap.xml、JSON-LD 等标准端点访问。其中站点 AI 导航 /llms.txt 是最重要的对外声明,向抓取方说明站点结构、推荐抓取方式,并给出面向 AI 的使用指令,例如:下载模型请使用 SDK / CLI 而非拼接文件直链;引用页面请使用 canonical 地址;批量检索或需要结构化字段时改用 MCP Server 或公开 OpenAPI,而非抓取 HTML。主要入口如下:

  • 二是可被读取。 魔搭全站核心资源页面均支持在 URL 后加 .md,返回 Markdown 加 frontmatter 的纯文本,Agent 可直接使用。目前已覆盖模型、数据集、创空间、论文及核心文档页面,覆盖面仍在持续扩大中。详细URL格式如下:

资源类型

地址模板

模型

https://modelscope.cn/models/{owner}/{repo_name}.md

数据集

https://modelscope.cn/datasets/{owner}/{repo_name}.md

创空间

https://modelscope.cn/studios/{owner}/{repo_name}.md

论文

https://modelscope.cn/papers/{id}.md

单篇文档 Markdown

https://modelscope.cn/docs/{path}.md

其中 {owner} 为用户名或组织名,{repo_name} 为仓库名,{id} 为论文 ID,{path}为文档路径。

  • 三是可被调用。 魔搭官方 MCP Server 提供标准发现文档 /.well-known/mcp.json,配合 OAuth 授权,Agent 可按标准协议接入平台服务。

此外,robots.txt 已对 LLM 抓取方给出明确指路,sitemap.xml 下挂 7 份子清单覆盖模型、数据集、创空间、MCP、论文、开发者实践与静态入口,浏览器搜索插件 opensearch.xml 与页面 JSON-LD 结构化数据(模型、数据集、创空间、MCP、论文分别对应 SoftwareSourceCode、Dataset、WebApplication、SoftwareApplication、ScholarlyArticle)共同构成完整的对外声明。

借助这些设计,Agent 能像魔搭开发者一样,通过标准 Spec 获取全站资源和服务,自主发现、理解和调用。

04
智能工坊 + Agent 实验场:Agent 资源库与云端运行时

作为中国最大的AI开源社区,魔搭上免费托管的开源模型已经超过 28 万,开源数据集超过 4 万。在核心开源模型和数据集资产以外,魔搭也早早布局 Agent 生态,目前已形成以 Agent 为中心的开放资源库。其中「智能工坊」包含 Skills、MCPs、AgentHub 三类 Agent 资源库,以及 Agent 实验场这一类算力运行时。

MCP 广场于 2025 年 4 月上线,目前托管 1.2 万+ 社区 MCP,简单配置连接即可装入自己的 Agent 调试使用。同时对于支持托管的MCP,魔搭提供了免费部署托管服务,这些托管服务结合模型能力,已经为社区开发者提供了超过24亿次MCP调用。

Skills 中心于 2026 年 3 月上线,方便社区开源和发现 Skills,目前收录超过 8 万+个。特别地,魔搭平台自身的能力也以 Skills 形式开源在这里,例如 ms-hub 用于 Hub 搜索、下载、上传,studio-deploy 用于把应用一键部署到创空间等等。

最近魔搭推出了直接支持Agent生态的 AgentHub 与 Agent 实验场,其中:

  • AgentHub 支持把模型、Skills、MCP 组合成 Agent 模板分享。你可以在上面找到各种 Agent 专家,一条命令下载到本地,或者在云端一键拉起免费体验。目前支持 MS-Agent 和 QwenPaw 两种框架模板上传下载,更多框架正在接入中。

  • Agent 实验场 与 智能工坊的Skills中心、MCP广场、AgentHub 配套,作为云端 Agent 运行时,支持一键试用体验站点的 Agent 模板、Skills、MCPs、模型API 及其自由组合。浏览器即开即用,免于本地环境安装,并支持与 AgentHub 双向导入导出。

通过全栈 Agent 产品的建设,社区希望能将魔搭积累的模型与 API 生态优势放大,用于支撑上层 Agent 构建,并让大家在云端低门槛地完成 Agent 的构建、运行与试用,免于本地复杂的环境安装与管理。

05
持续开放,与社区一起共建

魔搭社区开放生态基座的建设,旨在为开发者提供从模型资源发现、能力集成到 Agent 构建运行的全链路支持,帮助大家从底层基建中解放出来,将更多精力聚焦于上层应用的设计与创新。

期望OpenAPI开放体系、Agent/机器可读入口开放、以及Agent 资源库(智能工坊、 Agent 实验场)能够共同构成开发者及 Agent 的开放生态基座,帮助社区开发者及其 Agent 通过魔搭全栈云端体验或本地环境均可流畅访问、使用、接入魔搭资源、产品及服务。

在后续的工作中,我们仍将持续扩大机器可读页面的覆盖面,把更多产品功能纳入 OpenAPI 开放体系并与平台功能实现 1:1 对应,同时进一步推进和丰富 AgentHub 与 Agent 实验场支持的框架与 Agent 模板生态。

06
🔗 相关链接

Agent 资源库与运行时

  • 🛠 MCP 广场:https://modelscope.cn/mcp

  • 🧩 Skills 中心:https://modelscope.cn/skills

  • 🤖 AgentHub:https://modelscope.cn/agents

  • 🧪 Agent实验场:https://modelscope.cn/agents/playground

相关文档

  • 🚪 站点开放入口:https://modelscope.cn/docs/open-platform/site-entry

  • 🔐 集成通过魔搭登录(OAuth):https://modelscope.cn/docs/accounts/oauth

官方邮箱:contact@modelscope.cn

点击阅读原文,即可跳转Agent实验场~


👇点击关注ModelScope公众号获取
更多技术信息~

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

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

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

相关学习资料