You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Teams iOS端消息扩展选中查询结果时同步触发invoke与粘贴缩略图卡片异常

异常原因
  • 客户端版本兼容缺陷:Teams 4.11.0版本iOS原生客户端存在逻辑优先级漏洞,当搜索扩展结果项配置了自定义tap动作时,客户端没有拦截「选中结果默认插入顶层卡片到消息编辑区」的内置逻辑,导致自定义invoke请求和默认插入动作同时触发。同版本的macOS端、网页端、安卓端已经修复该逻辑,自定义tap存在时会优先执行自定义逻辑、拦截默认插入,因此表现正常。
  • 响应结构不符合跨端兼容规范:按照Teams搜索扩展的协议规范,preview节点仅用于定义搜索结果列表内的展示样式,选中结果的行为逻辑、默认插入内容以顶层attachment节点的配置为准。当前实现把tap invoke逻辑仅配置在preview节点下,同时在顶层attachment中填充了完整的thumbnail card内容,给iOS端触发默认插入逻辑留了入口。

异常表现参考:
iOS端异常表现:编辑区同时出现自动粘贴的thumbnail card和invoke返回的自适应卡片

修复方案

按照官方跨端兼容规范调整搜索扩展响应结构即可,不需要做客户端侧特殊适配:

  1. 将tap自定义invoke逻辑从preview.content节点移动到顶层attachment的根节点,preview节点仅保留列表展示所需的hero card图片、标题、副标题、正文内容,不再单独配置tap动作。
  2. 如果业务逻辑为点击结果后完全依赖invoke返回的adaptive card填充编辑区,不需要插入预置的thumbnail card,将顶层attachment的contentType修改为application/vnd.microsoft.card.adaptive,content字段置为空对象即可,从根源上避免客户端误插入thumbnail card。

修正后的参考响应结构如下:

{
    "composeExtension": {
        "type": "result",
        "attachmentLayout": "list",
        "attachments": [
            {
                "contentType": "application/vnd.microsoft.card.adaptive",
                "content": {},
                "tap": {
                    "type": "invoke",
                    "value": {
                        "type": "SELECT_CALLBACK",
                        "selectedItemId": 1001
                    }
                },
                "preview": {
                    "contentType": "application/vnd.microsoft.card.hero",
                    "content": {
                        "images": [
                            {
                                "url": "https://localhost/93/937083/Public/img3-a68ff7.jpeg"
                            }
                        ],
                        "subtitle": "Subtitle",
                        "text": "Sample text",
                        "title": "Thumbnail card title"
                    }
                }
            }
        ]
    }
}

注:原响应中图片地址写为https:/localhost缺少一个路径斜杠,虽然不是导致本次异常的原因,但正式上线时需要修正,避免图片加载失败。

调整后在iOS 15.5 + Teams 4.11.0环境下验证,点击搜索结果将仅触发预期的invoke调用,不会再自动粘贴多余的thumbnail card,其余端的原有功能不受影响。

内容的提问来源于stack exchange,提问作者Rony Emrul

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.27 16:57:18