必须配置卡片模板、绑定变量并匹配类型,否则无法渲染;创建卡片需设名称、拖入单列布局为根容器,图文组件按1:2分栏更佳,变量名与类型须与工作流输出严格一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在扣子(Coze)平台让智能体返回结果不再是一堆干巴巴的文字,而是像新闻App一样带图、分栏、有标题有摘要的卡片式界面,必须亲手配置卡片模板、绑定变量、设置组件层级——这一步漏掉变量类型匹配,整张卡片就无法渲染。
创建卡片并设置基础结构
登录扣子官网 → 点击左上角「资源库」→ 在顶部导航栏选择「卡片」→ 点击右上角「+ 创建卡片」。
进入编辑页后,先点击左上角默认名称“新卡片”,将其改为有意义的名称,例如“知乎热榜单条卡片”——名称会出现在资源列表中,影响后续查找效率。
点击左侧「组件」面板,拖入一个「单列布局」组件。这个布局是卡片的根容器,所有其他组件都必须放在它内部,否则保存时会报错提示【组件未嵌套在布局中】。
添加图文混合组件并配置占位内容
方法一:在「单列布局」内,依次添加「图片」→「文字」→「文字」三个基础组件。
方法二:直接拖入「多列布局 1:2」,左侧区域放「图片」,右侧上下叠加两个「文字」组件——这种结构更贴近主流资讯卡片的视觉权重分配,图片吸引眼球,右侧双文本分别承载标题与摘要。
点击任一文字组件,在右侧属性栏将「内容」设为纯文本,例如输入“这里是标题示例”;图片组件则在「图片地址」栏粘贴任意可用链接(如 https://via.placeholder.com/300x200 )。此时预览区已能显示静态卡片效果。
创建变量并绑定到组件
第一步:点击顶部「变量」→「新建变量」。
第二步:创建第一个变量,名称填 news_title,类型选 String,默认值填“AI正在改变世界”。
第三步:创建第二个变量,名称填 news_summary,类型也选 String,默认值填“本条新闻摘要长度控制在两行以内为佳”。
第四步:创建第三个变量,名称填 news_image_url,类型选 String,默认值填一张真实可访问的图片链接(不能用 placeholder,否则绑定后图片不显示)。
注意:变量类型必须与工作流输出字段完全一致,String 和 Text 在扣子中不互通,选错会导致组件留空。
将变量动态绑定至对应组件
点击图片组件 → 右侧「图片地址」栏点击「fx」图标 → 在弹出窗口中选择「变量」→ 找到并选中 news_image_url → 点击确认。
点击上方文字组件 → 右侧「内容」栏点「fx」→ 选择变量 news_title。
点击下方文字组件 → 同样绑定 news_summary。
此时卡片仍显示占位文字,但已具备数据驱动能力——只要上游工作流把三个同名变量传入,卡片就会自动替换内容。
发布卡片并关联到智能体
点击右上角「保存」→ 再点击「发布」,卡片即刻生效。
打开目标智能体 → 进入「技能」或「工作流」编辑页 → 找到最终「结束节点」→ 在「消息卡片」下拉菜单中,选择刚发布的卡片名称。
确保该结束节点的「输出参数」中,存在且仅存在三个字段:news_title、news_summary、news_image_url,字段名与类型必须与卡片变量严格一致。











