You need to enable JavaScript to run this app. Amazon Lex集成Connect聊天时按钮响应卡不显示的解决方案咨询
优惠活动
大模型
产品
解决方案
定价
更多

Amazon Lex集成Connect聊天时按钮响应卡不显示的解决方案咨询

Amazon Connect集成Lex场景下响应卡正常展示的可落地方案

前置校验项

  • 必须使用Amazon Lex V2版本构建Bot,Lex V1版本的响应卡机制本身不支持向Connect聊天渠道透传结构化卡片内容,这是无卡片渲染的最常见根因
  • Bot发布时必须将对应Connect实例所属的聊天渠道加入授权渠道列表,未在白名单内的渠道发起的调用请求,Lex会自动剥离响应卡结构,仅返回纯文本应答

分步骤配置逻辑

  1. Lex侧配置修正
    • 将响应卡绑定在意图等待用户输入的返回节点上,不要将响应卡配置在聊天流程终止的后置节点,否则Connect会将该内容判定为系统通知而非用户交互卡片,不会渲染按钮结构
    • 卡片内的交互按钮必须选用Postback类型,禁止使用跳转链接类按钮,链接类按钮在Connect组件中会被转换为纯文本,无法保留交互卡片形态
    • 单卡片按钮数量控制在5个以内,卡片正文长度不超过1000字符,超出阈值的内容会被Connect裁剪为纯文本消息
  2. Connect侧适配调整
    • 打开聊天流中“调用Amazon Lex”节点的高级配置,手动开启透传Lex响应卡开关,该开关默认处于关闭状态,未开启时Connect会直接丢弃Lex返回的结构化卡片字段,仅展示文本内容
    • 若使用Connect原生托管聊天组件,需确保组件版本不低于2023年11月发布的稳定版,旧版本存在响应卡渲染缺陷,会导致卡片仅展示文本不展示按钮
    • 若使用自研聊天前端,需在前端逻辑中解析Lex返回的ImageResponseCard结构化字段,将字段内的标题、正文、按钮数组映射为前端可渲染的交互卡片组件,不能仅读取文本字段直接展示
    • 若通过Lambda后置处理Lex的返回结果,处理逻辑必须完整保留responseCard全量结构,禁止在数据加工过程中将卡片字段扁平化为纯文本

常见异常排查方向

  • 确认聊天流中配置的Lex Bot别名与实际发布、完成渠道授权的别名完全匹配,指向测试版本或未授权版本的别名调用,会触发卡片字段剥离逻辑
  • 确认Lex Bot与Connect实例处于同一AWS区域,跨区域调用时,结构化卡片字段会被网关默认剥离

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.20 13:06:10