实现 Agent Plugins 客户端
为 AI 智能体或开发工具实现可移植的 Agent Plugins 加载约定。
合规客户端从目录加载 Agent Plugin,验证 plugin.json,并至少支持一种组件类型:技能或 MCP 服务器。
加载顺序
- 确定经过文件系统解析的插件根目录。
- 在根目录找到
plugin.json,并使用$schema所选择的本地支持 Schema 进行验证。 - 如有致命清单违规,拒绝插件;报告并忽略明确规定为非致命的问题。
- 从固定位置发现客户端支持的各组件类型。
- 对各组件类型或条目应用规定的失败边界。
- 应用已实现的客户端扩展命名空间,并忽略其他命名空间。
客户端使用规范 Schema 标识符来选择本地验证和解释规则。加载插件时不获取 Schema。
可移植行为与客户端自有行为
Agent Plugins 定义包结构、验证、发现、MCP 配置、插件变量和失败隔离。以下内容不在其规定范围内:
- 安装源、注册表或市场
- 启用、更新或缓存的用户体验
- 权限提示、信任策略或沙箱
- 如何向用户或模型展示技能
- 客户端扩展的内部行为
后续阅读
译文与记录的源版本一致。
- 来源提交
- 237bbf575f5843214923419f9d0933852662f4f3
- 上次同步
- 2026年8月11日 08:30
- 规范仓库
- 规范仓库