AI工具推荐:Agent Plugins 1.0.0统一标准实战与MCP适配指南
发布时间:2026-08-17 | 最后更新:2026-08-17
署名:落子AI·电气工程师
2026年8月6日,OpenAI、微软、谷歌、亚马逊、Cursor、Vercel六方联合发布Agent Plugins 1.0.0开放规范,统一了AI智能体插件的打包格式。8月12日,GitHub宣布Agent Plugins 1.0在VS Code、Copilot CLI、Copilot SDK及Copilot App全端正式可用(GA),所有Copilot套餐均支持(据GitHub官方更新日志,2026-08-12)。本文从技术实践角度解析该标准核心内容、与MCP协议的层级关系及MCP无状态迁移要点。核心结论:Agent Plugins不替代MCP或Agent Skills,而是将两者打包为跨客户端可移植的统一插件格式;MCP 2026-07-28规范已改为完全无状态,部署门槛大幅降低。本文为AI工具推荐系列第5篇,提供完整适配步骤与对比分析。
一、Agent Plugins 1.0.0是什么
1.1 解决"第二个客户端"问题
同一插件组件(如数据库查询Skill或MCP服务器配置)适配不同客户端(Cursor、VS Code、ChatGPT等)时,需要重新排列文件、改写manifest、调整MCP配置,维护成本随客户端数量线性增长。
Agent Plugins 1.0.0由Vercel发起,AWS、Anysphere(Cursor)、GitHub、Microsoft、OpenAI协作完成,规范于2026年7月24日入库,8月6日由Vercel正式公开宣布(据Vercel官方博客,2026-08-06)。Google于同日加入技术指导委员会(TSC)成为第六位核心维护者,由Google DeepMind高级工程师Kevin Hou代表;其Agents CLI和Data Agent Kit(支持BigQuery、Spanner、Cloud SQL)同步支持该格式(据GitHub官方博客,2026-08-12;AAIF官方博客,2026-08-06)。
1.2 六巨头治理结构
| 代表方 | 维护者 | 角色 |
| AWS | Clare Liguori | Core Maintainer |
| Cursor (Anysphere) | Roshan Sadanani | Core Maintainer |
| Microsoft | Harald Kirschner | Core Maintainer |
| OpenAI | Gav Verma | Core Maintainer |
| Vercel | Jonathan Hefner | Lead Maintainer |
| | Kevin Hou (Google DeepMind) | Core Maintainer |
项目章程规定单一厂商不得占据多数席位。规范采用CC-BY-4.0许可,代码采用Apache 2.0许可。Anthropic虽发明了MCP和Agent Skills,但未参与核心维护者行列,Claude Code也未列入首发兼容客户端(据IT之家报道,2026-08-07)。
1.3 兼容客户端与Copilot全端GA
首发兼容客户端包括ChatGPT/Codex、Cursor、GitHub Copilot、Kiro(AWS)和VS Code,各客户端在Skills支持、MCP stdio、Streamable HTTP传输上均已对齐,唯一差异是ChatGPT/Codex不支持Legacy SSE传输(据腾讯云开发者社区整理,2026-08-10)。
8月12日,GitHub Copilot率先完成全端GA,覆盖VS Code、Copilot CLI、Copilot SDK和Copilot App,所有Copilot套餐均支持。开发者可从Awesome Copilot市场安装规范插件,现有非1.0插件无需迁移即可继续使用。企业版用户可通过managed-settings.json中的enabledPlugins自动安装或屏蔽特定插件、extraKnownMarketplaces添加市场源、strictKnownMarketplaces限制安装来源,并配合MCP allowlist按URL或命令管控服务器——分发渠道与治理手段在同一版本中落地(据GitHub官方更新日志,2026-08-12)。
二、Agent Plugins与MCP的关系:更高层级的抽象
2.1 三层架构定位
| 层级 | 职责 | 标准 | 解决的问题 |
| 打包层 | 将可复用组件打包为可移植插件 | Agent Plugins 1.0.0 | 跨客户端文件结构和manifest统一 |
| 连接层 | 运行时连接外部工具和数据 | MCP (2026-07-28) | Agent如何调用API、数据库等 |
| 知识层 | 可复用的指令和资源 | Agent Skills (SKILL.md) | Agent如何执行特定领域任务 |
Agent Plugins将Skills和MCP服务器配置打包到可预测目录中,一个插件可包含Skills、MCP配置,或两者兼有。
2.2 目录结构与最小清单
deployment-assistant/
├── plugin.json # 必需:清单文件
├── skills/ # Agent Skills目录
│ └── deploy-service/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
├── mcp.json # MCP服务器配置
└── com.example.client/ # 客户端特定扩展(反向域名命名空间)
└── hooks/
plugin.json只需两个必填字段:
// json
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "deployment-assistant"
}
schema是封闭的——可移植顶层字段仅限规范定义的那些,客户端特定数据应放在extensions中(据AAIF官方博客,2026-08-06)。
2.3 故障隔离机制
规范定义了严格的故障隔离规则:缺少可选组件目录不是错误;单个Skill无效时客户端应跳过该Skill并继续加载其余组件;单个MCP服务器无法启动、连接或认证时,不应阻止其余Skills或服务器加载。包含5个Skills和3个MCP服务器的插件,即使其中2个组件有问题,其余6个仍可正常工作。
需要注意,Agent Plugins 1.0仅标准化了打包与发现层,安装方式、权限审批、沙箱执行、包签名与来源验证等均由各客户端自行决定。这意味着一个结构合法的插件仍可能包含危险脚本或指向恶意MCP服务器,标准化目录让安全扫描更容易,但并不让未知代码变得可信(据abhs.in技术分析,2026-08-16)。
三、MCP 2026-07-28:从有状态到无状态
3.1 核心变更
MCP 2026-07-28规范于7月28日发布,是MCP自发布以来重大更新。Cloudflare于8月6日验证确认MCP现在是完全无状态协议(据Cloudflare官方博客,2026-08-06)。
| 维度 | 旧版MCP(≤2025-11-25) | 新版MCP(2026-07-28) |
| 握手 | 必须initialize/initialized交换 | 移除强制握手 |
| 会话 | Mcp-Session-Id维持会话 | 移除会话,每次请求独立 |
| 服务器发现 | 初始化时完成 | 可选调用server/discover |
| 基础设施 | 需要有状态服务器 | 普通HTTP Worker即可 |
| 弹性请求 | 依赖打开的流 | Multi Round-Trip Requests (MRTR) |
| HTTP头 | 信息仅在JSON体内 | 新增Mcp-Method和Mcp-Name头 |
3.2 无状态带来的实际收益
• 消除粘性会话:autoscaling无需会话亲和性
• 简化部署:兼容Vercel、Cloudflare Workers、AWS Lambda等无持久连接平台
• 降低成本:请求处理完毕即释放资源
• 优雅部署更新:无需drain或迁移活跃会话
Cloudflare的Code Mode MCP服务器已用无状态模式服务每秒数千请求、累计数十亿次工具调用(据Cloudflare官方博客,2026-08-06)。
3.3 新增HTTP头与特性生命周期
新版规范要求Streamable HTTP请求携带Mcp-Method和Mcp-Name头,网关、限流器、WAF无需解析JSON body即可做路由决策:
POST /mcp HTTP/1.1
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/call
Mcp-Name: search
Content-Type: application/json
特性生命周期分为Active、Deprecated、Removed,被废弃特性至少保留12个月。本次废弃Roots、Sampling、Logging、Dynamic Client Registration(DCR)、传统HTTP+SSE传输,DCR计划2027年夏季后移除(据Cloudflare官方博客,2026-08-06)。
四、实战HowTo:如何适配Agent Plugins标准
步骤一:创建插件目录结构
// bash
mkdir -p my-plugin/skills/my-skill/scripts
mkdir -p my-plugin/skills/my-skill/references
步骤二:编写plugin.json清单
// json
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "my-data-assistant",
"version": "1.0.0",
"description": "数据查询与分析助手插件",
"author": "your-name",
"license": "Apache-2.0",
"keywords": ["data", "analysis", "sql"]
}
步骤三:编写Agent Skill
在skills/my-skill/SKILL.md中定义:
// markdown
---
name: data-query
description: 执行SQL查询并格式化结果。当用户需要查询数据库、生成报表或分析数据时使用。
license: Apache-2.0
---
# 数据查询技能
## 查询流程
1. 接收用户自然语言查询需求
2. 转换为SQL语句
3. 通过MCP服务器执行查询
4. 格式化返回结果
SKILL.md由YAML frontmatter和Markdown正文组成。必填字段为name(kebab-case,最长64字符)和description(最长1024字符)。Agent Skills采用渐进式披露:先广播名称和描述(约100 token),匹配时再加载完整指令(据Microsoft Agent Framework文档,2026-07-10)。
步骤四:配置MCP服务器(mcp.json)
// json
{
"mcpServers": {
"database": {
"type": "streamable-http",
"url": "https://your-server.example.com/mcp",
"headers": {
"Authorization": "Bearer ${MCP_TOKEN}"
}
}
}
}
每个MCP服务器必须声明显式传输类型:stdio、streamable-http或http+sse。
步骤五:迁移MCP服务器到无状态(如适用)
1. 升级MCP TypeScript SDK到最新版本
2. 将McpAgent替换为createMcpHandler
3. 在/mcp端点同时提供新旧协议支持(向后兼容)
4. 逐步将功能从有状态路由迁移到无状态路由
5. 在废弃期内(12个月以上)让旧会话自然排空
6. 移除旧的有状态路由
最小无状态MCP服务器示例:
// typescript
import { McpServer } from "@modelcontextprotocol/server";
import { createMcpHandler } from "agents/mcp/server";
import { z } from "zod";
function createServer() {
const server = new McpServer({ name: "my-server", version: "1.0.0" });
server.registerTool("query", {
description: "查询数据",
inputSchema: { sql: z.string() },
}, async ({ sql }) => ({
content: [{ type: "text", text: `执行查询: ${sql}` }],
}));
return server;
}
export default {
fetch(request, env, ctx) {
return createMcpHandler(createServer)(request, env, ctx);
},
};
步骤六:验证与测试
在不同客户端加载插件,确认Skills出现在技能菜单、MCP服务器出现在列表中、故障隔离生效(故意放一个无效Skill,确认其他组件不受影响)。
五、三大标准对比与生态观察
5.1 标准对比
| 维度 | Agent Plugins 1.0.0 | MCP (2026-07-28) | 传统REST API |
| 定位 | 打包与发现标准 | 运行时连接协议 | 数据传输协议 |
| 核心能力 | 统一插件目录格式 | Agent连接外部工具 | 系统间数据交换 |
| 状态管理 | 不涉及(打包层) | 完全无状态 | 通常无状态 |
| 跨客户端 | 一次打包,多客户端通用 | 需Agent Plugins包装 | 需各自集成 |
| 传输方式 | 不涉及 | stdio/Streamable HTTP | HTTP/HTTPS |
| 治理 | 六方TSC,CC-BY-4.0 | AAIF,开放治理 | 各自私有 |
据法国竞争管理局2026年5月评估,OpenAI、Google和Anthropic合计占据AI Agent市场约84%份额,并警告Agent间切换在实际中并不顺畅(据法国竞争管理局报告,2026-05)。Agent Plugins从技术层面缓解了锁定问题。
5.2 生态进展与社区反馈
8月13日,DeepSeek以MIT协议开源Agent框架Harness(dsh)v0.1开发者预览版,采用Cordis微内核架构,核心设计为"一切皆插件"——模型适配器、工具注册表、会话日志、沙箱策略乃至Agent主循环本身均以插件形式存在,支持热插拔与运行时自扩展。发布次日GitHub星标突破5.5万、登顶Hacker News,社区dsh-plugin标签仓库迅速超过1000个(据DeepSeek CSDN技术社区,2026-08-15;腾讯云开发者社区,2026-08-14)。Harness的爆发从侧面印证了Agent生态对可组合、可移植架构的强烈需求。需要区分的是:Harness是端到端Agent运行框架,覆盖模型接入、工具调度、会话审计等完整链路;Agent Plugins定义的是跨客户端打包格式,仅触及"如何组织文件"这一层。两者可互补——Harness未来若支持导入Agent Plugins格式包,开发者就能在Harness中复用跨客户端插件生态。
社区对Agent Plugins的评价呈现理性声音。有工程师指出,跨6个客户端运行同一插件意味着6倍权限故障点,标准将治理和权限管理推给了各客户端,"没有信任与权限管理的互操作不是安全架构";也有观点认为若有用功能仅留在厂商扩展命名空间中,开放性可能仅停留在表面,锁定效应只是换了位置(据The New Stack/DigitalToday报道,2026-08-17)。1.0版本有意将命令(commands)、钩子(hooks)、自定义Agent等暂不纳入可移植类型,这些仍由各客户端在反向域名命名空间中自行实现。这些边界是开发者选型时需要评估的实际局限。
六、常见问题
Q1:Agent Plugins会替代MCP吗?
不会。Agent Plugins定义"如何打包",MCP定义"如何连接",两者互补。Agent Plugins将Skills和MCP配置打包到可移植目录中,但不改变各自行为规范。据AAIF官方博客(2026-08-06),Agent Plugins是独立治理的开放规范,不属于AAIF项目。
Q2:Anthropic为什么没有参与?
Anthropic发明了MCP和Agent Skills,但未加入Agent Plugins核心维护者。Claude Code有自己的插件系统(.claude-plugin/plugin.json),截至7月中旬插件目录已有256个条目。VS Code同时支持Agent Plugins和Claude格式,是否最终收敛仍是开放问题(据The University Network报道,2026-08-07)。
Q3:现有MCP服务器需要立即迁移到无状态吗?
不需要。MCP 2026-07-28的/mcp端点同时接受新协议和2025 Streamable HTTP客户端的无状态请求,大多数客户端无需配置变更即可重连。仅当服务器依赖旧的有状态会话、服务端到客户端请求(如Sampling)或独立SSE流时,才需要按迁移指南逐步改造。被废弃的Roots、Sampling、Logging、DCR等特性至少保留12个月,DCR计划2027年夏季后移除,迁移窗口充裕。
Q4:该优先支持哪个客户端?
GitHub Copilot已于8月12日全端GA,覆盖VS Code、CLI、SDK和App,是当前落地路径明确的选择。VS Code和Cursor同为首发兼容客户端、开发者基数大,打包一次即可多端可用。ChatGPT/Codex也在首发名单中。
Q5:插件可以包含客户端特定功能吗?
可以。通过反向域名命名空间(如com.example.client/)放置hooks、commands等非可移植扩展,其他客户端会忽略不属于自己命名空间的目录。这确保共享格式不被污染,同时保留客户端创新空间。需注意:客户端特定代码不具备可移植性,这是"一次打包"的边界。
参考文献
1. Vercel. "Introducing Agent Plugins." (2026-08-06). https://vercel.com/blog/introducing-agent-plugins
2. AAIF Blog. "From Skills and Tools to Portable Agent Plugins." (2026-08-06). https://aaif.io/blog/from-skills-and-tools-to-portable-agent-plugins
3. Cloudflare Blog. "The next generation of MCP." (2026-08-06). https://blog.cloudflare.com/mcp-v2/
4. GitHub Changelog. "Agent Plugins 1.0 in VS Code, Copilot CLI, and the Copilot app." (2026-08-12). https://github.blog/changelog/2026-08-12-agent-plugins-1-0-in-vs-code-copilot-cli-and-the-copilot-app/
5. IT之家. "OpenAI面向AI智能体推出Agent Plugins规范." (2026-08-07). https://m.ithome.com/html/986816.htm
6. The University Network. "Google Joins Agent Plugins 1.0 as a Core Maintainer." (2026-08-07). https://www.tun.com/home/google-joins-agent-plugins-1-0-as-a-core-maintainer/
7. Microsoft Learn. "Agent Skills." (2026-07-10). https://learn.microsoft.com/en-nz/agent-framework/agents/skills
8. DeepSeek CSDN技术社区. "DeepSeek 开源智能体框架 Harness." (2026-08-15). https://deepseek.csdn.net/6a7f900010ee7a33f29b15f7.html
9. DigitalToday. "OpenAI, AWS and GitHub back agent plugin standard." (2026-08-17). https://www.digitaltoday.co.kr/en/view/93731/
落子AI·电气工程师
知乎:落子AI
头条号:落子AI
本文部分内容由AI辅助生成,经人工审核校验后发布。所有引用数据来源已标注。
更多推荐

所有评论(0)