用途:在开发 MCP Apps 或 OpenAI Apps SDK 组件时,判断特定宿主实际支持哪些 API,避免依赖未实现的接口。不支持的 API 返回 undefined 而非抛错,缺少守卫会导致静默失效的按钮而非测试中可见的报错。
主要能力:提供 Microsoft 365 Copilot 公布的支持矩阵,覆盖组件桥接(如 toolInput、callTool、sendFollowUpMessage、requestDisplayMode)、工具描述符 _meta、工具注解、资源 _meta、CSP 属性、宿主提供的工具结果 _meta 与客户端 _meta 等对应关系。ChatGPT 视为完整支持 window.openai 列,Claude 视为完整支持 MCP Apps 列,但运行时仍需验证。
关键限制:onteardown、onhostcontextchanged、ontoolinputpartial、sendLog 均不支持,因此需在每次有意义变更时持久化、初始化时读取主题或使用 prefers-color-scheme 兜底、围绕 ontoolinput 设计加载态、用 console 加调试面板替代 sendLog。destructiveHint、openWorldHint、idempotentHint 不被采用,确认提示需自建。嵌套 iframe 在 Copilot 不可用。
用法规则:不要按宿主名或 user agent 分支,应检测能力;缺失 API 的控件应隐藏而非渲染;每次宿主 API 调用都需定义降级路径。可用 window.openai?.callTool 等最小守卫、条件渲染或启动时 capability probe,MCP Apps 侧可用 app.getHostCapabilities() 与 availableDisplayModes(后者在 Copilot 不支持,需默认 inline)。发布前应重新核对矩阵。相关技能:openai-apps-sdk、mcp-apps-protocol、m365-copilot-packaging。