---
permalink: /coze-guide/getting-started/12-coze-ai-agent.html
---

# 12.Coze智能体-卡片

在日常协作与信息分发中，我们往往希望能呈现更直观的消息形式。

文字加链接虽然便捷，但有时难以表达重点。

此时，“消息卡片”就能发挥更好的展示作用。扣子平台最近推出了多种类型的消息卡片，并支持在豆包、飞书等客户端中生效。

本文将介绍如何使用官方提供的卡片模板，以及如何创建自定义卡片，以便在工作流或插件中实现更丰富的回复效果。

## 一、什么是消息卡片

消息卡片是在聊天窗口中可视化呈现信息的一种载体。

它可以包含标题、列表、图片、链接等元素，让用户在查看消息时，一目了然地获取关键信息。

目前，扣子的消息卡片只在豆包客户端和飞书客户端中有效，并且只有工作流和插件功能支持将卡片嵌入到输出结果里。

## 二、如何使用官方卡片

如果你想快速完成卡片配置，官方提供的卡片模板是一条捷径。你只需在智能体编排页面中选择合适的卡片样式，并根据系统提示绑定相应的工作流数据，即可完成配置。具体流程如下：

- 进入需要配置卡片的工作流或插件，在对应流程节点上，点击卡片图标。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122435Z-27eeb039f397445b-db70a154.jpg)

- 在弹出的配置窗口中，先选择卡片样式。常见样式包括：
    - 单张卡片：适用于单一内容的展示，如一条新闻或一个活动。
    - 竖向列表：适合同时展示多条信息。例如，一次搜索得到多条新闻时，可用列表形式依次显示。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122436Z-417905270cfe7b73-1d708be7.jpg)

- 如果你选择了竖向列表，需要进一步设置「卡片列表最大长度」或「为卡片整体绑定一个数组」等属性。
- 接着，在页面中为卡片的各部分绑定工作流输出的数据。例如，你可以将工作流中的标题参数绑定到卡片的Title区，或者将工作流中的URL绑定到卡片的点击跳转入口。
- 确认并保存配置后，如果需要在客户端直接跳转到某个链接，还需打开点击卡片跳转开关，并绑定对应的URL参数。
- 最后点击确认，此时官方卡片的配置过程就完成了。

## 四、如何创建自定义卡片

如果官方模板不能满足你的展示需求，可以尝试自己动手创建自定义卡片。

自定义卡片支持更自由的布局与内容设计，适合有特定格式需求的用户。具体操作步骤如下：

- 在智能体或插件的回复卡片配置窗口中，点击新增，进入卡片编辑页面。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122441Z-9e0abbe135b825c7-27e99e96.jpg)

- 在页面左侧的卡片页签下，你可以选择系统已有的模版布局，也可以自行拖拽组件来构建卡片。组件包括基础文本、图片、按钮等，拖拽到画布后还可调整样式与内容。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122436Z-c9796e112deec98a-4c10e73e.jpg)

- 若需要与工作流数据联动，请在左侧的变量页签中创建相关变量，并设置默认值或变量类型。
- 回到画布页面，选中对应组件，在其内容区域处插入绑定的变量。这样，当工作流输出更新时，卡片也会实时展示新的数据。
- 点击页面右上角的预览按钮，并使用豆包或飞书扫描二维码，即可查看实际卡片的展示效果。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122437Z-d60d684afcb4cc7a-5fa1d26b.jpg)

- 确认无误后，点击发布，你的自定义卡片就正式生效了。

## 五、如何绑定卡片到工作流或插件

完成卡片创建后，最后一步是让工作流或插件输出的消息真正使用这张卡片。具体操作如下：

1. 登录扣子平台，选择个人空间或团队空间。
2. 找到需要添加卡片的智能体，进入智能体编排页面，并定位到相应的插件或工作流节点。
3. 点击绑定卡片数据图标，选择绑定卡片。
4. 在「回复卡片配置」对话框中，选择你需要的卡片（官方卡片或自定义卡片均可），然后点击确认。
5. 发布或重新部署智能体，完成配置。此时，当工作流或插件运行时，就会以所选卡片的形式输出消息。

## 小结

消息卡片极大提升了信息的可视化与可读性。

在豆包、飞书等客户端里，卡片可以通过图文结合的方式，让关键信息更突出，让用户在第一时间捕捉到要点。

官方卡片模板提供了开箱即用的简洁方式，如果你追求更细致的个性化布局，也可以借助自定义卡片来自由发挥。

按照以上步骤，相信你能迅速上手，打造符合自己需求的消息展示。

更多干货内容，可以查看电子书。[点击跳转合集页面](https://xiaobot.net/post/8e3ae10c-5aca-43cd-af66-09a7fbe31eb0)