用途:为基于 MCP 的 API 插件添加 Adaptive Card 响应模板,改善数据在 Microsoft 365 Copilot 中的可视化呈现。
主要能力:
- 静态响应模板:当 API 始终返回相同类型且格式稳定时,在 ai-plugin.json 的 response_semantics.static_template 中定义卡片。
- 动态响应模板:当返回多种类型、每条数据需不同模板时,使用 template_selector 指向每条数据的模板属性,并在 API 响应中内嵌 templates。
- 静态与动态组合:无 template_selector 或值无法解析时回退到静态模板作为默认。
配置要点:
- data_path:JSONPath 指定数据位置,如 "$"、"$.results"、"$.data.items"。
- properties:映射 title、subtitle、url 等用于 Copilot 引用。
- template_selector:每条数据上的模板选择属性。
模板语言:支持条件渲染 ${if(field, field, 'N/A')}、数字格式化 ${formatNumber(amount, 2)}、数据绑定 $data(如 ${$root} 或数组迭代)、条件显示 $when。可用元素包括 TextBlock、FactSet、Image、Container、ColumnSet 与 Action.OpenUrl 等动作。
响应式建议:优先单列布局,避免多列;宽度用 auto 或 stretch,不要固定宽度(图标/头像除外);文本与图片不放在同一行,文本设 wrap;在 Teams(桌面与移动)、Word、PowerPoint 及不同视口宽度下测试。
工作流:先确认 API 返回的数据类型、条目是否同构、卡片字段、是否需要动作、是否存在多种状态或分类需不同模板,再生成对应的 response_semantics、模板与测试场景。
限制:该技能面向 MCP 插件与 M365 Copilot 生态;具体安装命令、收费与价格资料未提供。