最新扣子(Coze)实战案例：扣子卡片的制作及使用，完全免费教程

‍♂️ 大家好，我是斜杠君，手把手教你搭建扣子AI应用。

☘️ 本文是《AI应用开发系列教程之扣子(Coze)实战教程》，完全免费学习。

关注斜杠君，可获取完整版教程。

如果想学习AI应用搭建，请关注公众号，及时获取最新免费教程。

最近，有很多同学问扣子中的卡片有什么用？怎么很少用到，那今天本文就为大家讲解一下扣子中的卡片是做什么的，到底有什么妙用？

温馨提示：本文内容很多，涉及贯穿了搭建扣子应用的很多知识。没看过教程的同学，一定关注后再看，不然容易找不到。 如果学懂本文，你可以完全掌握了扣子卡片的原理，话不多说，上干货。

本文重点，共分五个部分：

1、扣子中的卡片是什么

2、卡片的组成

3、卡片使用范围

4、制作卡片

5、使用卡片

接下来让我们详细一一讲解。

一、什么是卡片

扣子平台中的「卡片」简单说就是让输出的格式更好看。 例如你在扣子上通过插件或工作流返回一篇新闻，如果直接输出，就是一行标题，一段内容，可能有的还会有一个链接。但如果在大模型输出之前，你把这些信息按设定好的格式做成一个好看的卡片，是不是更能提供应用的用户体验，例如下面这样：

当然，也可以有列表形式的卡片：

二、卡片的组成

组成卡片的元素叫做组件。

组件一共分两种：

1. 布局组件

2. 基础组件

布局组件就是用来划分整体区域的，布局组件有如下几种：

对于每一个布局，都可单独进行参数的设置，这样就能组合出很多不同的布局。

例如这个布局：

原始的每行展示数目是3个，我可以改成4个，就变成这样了。

基础组件是具体的展示信息的类型，例如是图片，还是文本，还是按钮等。

基础组件有如下几种：

如下这个卡片就由一个图片和两个文本元素组成。

接下来让我们动手制作一个卡片，然后再使用这个制作好的卡片。通过本节课学习，彻底让大家掌握扣子卡片的使用，让你的应用与众不同。

三、卡片的使用范围

目前消息卡片仅在豆包客户端、飞书客户端内生效。

仅工作流和插件功能支持添加消息卡片。

四、制作卡片

接下来我们来通过一个实际的案例来学习卡片的制作。

这个案例的作用是：调用知乎热榜插件，然后用卡片列表的形式展示给用户。

1. 设置布局

形式如下图所示：

我们要做上面这种类型的卡片，首先要对内容进行分解。从图中可以看出这是一个新闻列表的循环。

所以首先要做出一条新闻的样式，再通过循环就可以展示出多条新闻的列表形式了。

也就是先做出这部分：

上面的这个结构，可以看出，是一个两列布局，有左右两部分内容。左侧是图片，右侧是信息。

那我们首先在画布上添加二列布局组件：

然后在这个布局里加入一个图片组件：

因为我们想要的图片是正方形，这么布局的话，比例不对。应该把1的宽度变小。

例如下图这样，把这个宽度再多分几份，实际是6份：

这时让图片的部分占1分，让文字的内容占5份，这样就能达到我们的效果了。

那该应该如何设置呢？

只需要调整信息部分宽度比例即可，改为5：

这样比例就调整好了。

2. 添加组件

先添加图片组件：

再添加文本组件。文字部分有上下两行，一行是标题，给行是摘要。

那么我们需要添加两个文本组件。

这样结构就准备好了。通过点击结构的按钮，可以看到当前卡片的结构。如下图：

3. 新建变量

因为列表是循环的展示的。正常情况下，循环的数据是接口返回的。在我们这个例子中，就是知乎返回的一个热榜数组。所以在没有调用接口之前，我们需要先通过模拟一个数组来展示这循环列表。

通过变量选项卡新建一个变量：

这里要注意，如下图所示，变量类型要选择数组：

数组变量的值如下，一共有三个元素，也就是对应展示出来的新闻列表也应是三条。

大家可以复制以下数组使用：

[{      "title": "这是一个新闻标题",      "summary": "新闻摘要的作用很重要，它可以决定读者是否阅读一篇新闻，并对读者的观点和态度产生影响。",      "image": "  https://lf-card-builder.oceancloudapi.com/obj/bot-studio-builder/2272053001466355_1709225232250572891.jpg  ",      "url": "  https://www.coze.cn  "  },{      "title": "这是一个新闻标题",      "summary": "新闻摘要的作用很重要，它可以决定读者是否阅读一篇新闻，并对读者的观点和态度产生影响。",      "image": "  https://lf-card-builder.oceancloudapi.com/obj/bot-studio-builder/2272053001466355_1709225232250572891.jpg  ",      "url": "  https://www.coze.cn  "  },{      "title": "这是一个新闻标题",      "summary": "新闻摘要的作用很重要，它可以决定读者是否阅读一篇新闻，并对读者的观点和态度产生影响。",      "image": "  https://lf-card-builder.oceancloudapi.com/obj/bot-studio-builder/2272053001466355_1709225232250572891.jpg  ",      "url": "  https://www.coze.cn  "  }]

设置好以后，接下来我们为卡片元素绑定变量。

4. 绑定变量

选中最外层组件，打开右侧高级配置中的循环渲染开关。如下图：

选择刚才我们创建的列表变量：

可以看到，列表循环展示出来了。循环的数量(三条数据)和我们设置的变量也是一一对应的。

接下来绑定元素（图片、标题、摘要）对应的变量。

图片：

标题：

摘要：

设置好以后是这样的：

到这里，我们的卡片制作工作就完成了。接下来让我使用这个卡片小试牛刀~

5. 保存模板

注意：这个不是必须的。但为了下次制作卡片时可以直接引用，一般会保存为模板。

起一个卡片模板名称：

6. 发布卡片

卡片只有发布以后才能被插件或工作流使用。

点击发布按钮发布一下，如下图：

点击确定按钮，就发布好了。

五、使用卡片

在第三节我们讲过，工作流和插件功能支持添加消息卡片。那么我们就通过插件的方式了使用卡片。

注: 如果有同学对插件的使用不了解，可以看第三章的详细教程。

1. 创建Bot

2. 添加插件

因为我们这个例子是要调用知乎热榜的数据，所以这里我们在插件中心搜索知乎热榜插件。

点击添加以后就加好了。

3. 配置卡片

点击 绑定卡片数据按钮 绑定卡片。

选择「团队卡片」选项卡，并选择刚才我们发布的卡片。

绑定数据源。按以下方式，依次绑定插件返回的数据：

绑定之后的数据如下图所示：

4. 测试卡片

卡片设置好了，接下来让我们测试一下吧。

输入查询知乎热榜：

可以看到，消息以卡片的形式展现出来了。

好了，到这里，我们就把卡片的制作及使用学习完了，希望大家多多使用卡片的形式展现更好的的效果。愿大家在本文中能有所收获。

免费教程地址：https://www.bzfree.com/doc/coze