发布时间: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

Google

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-MethodMcp-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服务器必须声明显式传输类型:stdiostreamable-httphttp+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辅助生成,经人工审核校验后发布。所有引用数据来源已标注。

Logo

欢迎加入 MCP 技术社区!与志同道合者携手前行,一同解锁 MCP 技术的无限可能!

更多推荐