实现 Agent Plugins 客户端

为 AI 智能体或开发工具实现可移植的 Agent Plugins 加载约定。

合规客户端从目录加载 Agent Plugin,验证 plugin.json,并至少支持一种组件类型:技能或 MCP 服务器。

加载顺序

  1. 确定经过文件系统解析的插件根目录。
  2. 在根目录找到 plugin.json,并使用 $schema 所选择的本地支持 Schema 进行验证。
  3. 如有致命清单违规,拒绝插件;报告并忽略明确规定为非致命的问题。
  4. 从固定位置发现客户端支持的各组件类型。
  5. 对各组件类型或条目应用规定的失败边界。
  6. 应用已实现的客户端扩展命名空间,并忽略其他命名空间。

客户端使用规范 Schema 标识符来选择本地验证和解释规则。加载插件时不获取 Schema。

可移植行为与客户端自有行为

Agent Plugins 定义包结构、验证、发现、MCP 配置、插件变量和失败隔离。以下内容不在其规定范围内:

  • 安装源、注册表或市场
  • 启用、更新或缓存的用户体验
  • 权限提示、信任策略或沙箱
  • 如何向用户或模型展示技能
  • 客户端扩展的内部行为

后续阅读

译文与记录的源版本一致。

来源提交
237bbf575f5843214923419f9d0933852662f4f3
上次同步
2026年8月11日 08:30
规范仓库
规范仓库