SuperAPI AI 工具集

mcp-create-adaptive-cards

智能体与模型

查看项目

更新于 10-15 21:52

技能介绍

用途:为基于 MCP 的 API 插件添加 Adaptive Card 响应模板,改善数据在 Microsoft 365 Copilot 中的可视化呈现。

主要能力:

  1. 静态响应模板:当 API 始终返回相同类型且格式稳定时,在 ai-plugin.json 的 response_semantics.static_template 中定义卡片。
  2. 动态响应模板:当返回多种类型、每条数据需不同模板时,使用 template_selector 指向每条数据的模板属性,并在 API 响应中内嵌 templates。
  3. 静态与动态组合:无 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 生态;具体安装命令、收费与价格资料未提供。