卡片

扣子编程支持低代码智能体以卡片形式发送消息，提升低代码智能体的聊天交互体验。

权限说明

卡片暂不支持多人协作。只有卡片的所有者支持编辑和删除自己创建的卡片，工作空间所有者、管理员以及普通成员都没有权限编辑和删除其他成员创建的卡片。

使用官方卡片

扣子编程提供了卡片模板，你可以选择适用的模板，并根据页面提示配置卡片参数。

1. 在智能体编排页面找到要配置卡片的工作流或插件，单击卡片图标。
   
2. 配置卡片。

   1. 选择卡片模板。
      

   2. 选择卡片样式及配置对应参数。

      卡片样式	说明	配置示例
      单张卡片	仅展示一张卡片，适用于展示单一内容。 选择单张卡片时，需完成如下配置： 为卡片内的元素绑定数据：为不同的元素绑定不同的变量。例如为卡片标题绑定 data.doc_results[0].title 变量，卡片标题将展示数组第一个元素中的 title 属性。 单张卡片只支持绑定数组中的第一个元素。 点击卡片跳转：单击卡片时，是否支持跳转到对应的 URL 页面。 打开点击卡片跳转开关，并绑定表示 URL 的变量。设置完成后，当你单击卡片时，将跳转到对应的 URL 页面。
      竖项卡片	支持展示多张卡片。例如搜索到多条新闻时，可通过卡片列表依次展示新闻内容。 卡片列表最大长度：卡片列表的最大数量，最大值为 20。 为卡片整体绑定一个数组：为卡片绑定一个数组类型的变量，例如 data.doc_results。 为卡片内的列表项绑定数据：为不同的卡片元素绑定不同的变量。例如为卡片标题绑定 title，即表示绑定 data.doc_results 数组中 title 属性。 点击卡片跳转：选择单击卡片时，是否支持跳转到对应的 URL 页面。 打开点击卡片跳转开关，并绑定表示 URL 的变量。设置完成后，当你单击卡片时，将跳转到对应的 URL 页面。

   3. 单击确认。
      配置完成后，你在与智能体对话时，智能体将以卡片形式回复消息。

使用自定义卡片

如果扣子编程官方提供的卡片模板不能满足你的需求，你可以自定义卡片样式。

步骤 1 ：创建卡片

1. 在智能体回复卡片配置页面中，单击新增，​页面将跳转至卡片编辑页面。
2. 在页面左侧的卡片页签内，选择模版或者自行拖拽组件构建卡片样式。
   • 模板：双击使用模板，你可以基于模板构建属于你的卡片。
     
   • 组件：通过拖拽布局组件和基础组件，自定义卡片内容。
   • 结构：以导航树的形式展示卡片的组件布局。
3. 在页面左侧的变量页签内，创建变量。
   为卡片组件创建变量，智能体会根据插件或工作流的返回值展示对应的内容。例如，新增 newMovies 变量，Array 类型，默认值如下所示。
   
4. 为卡片组件绑定变量。
   在卡片画布内，选中需要添加变量的组件，然后在组件基本配置的内容区域，单击变量图标并选择要使用的变量。
   
5. 在页面右上角单击预览，扫描二维码在豆包或飞书中查看预览效果。
6. 在页面右上角单击发布。

步骤 2 ：为卡片绑定数据

发布自定义卡片后，你需要为卡片绑定数据，例如插件的返回参数。

1. 在智能体回复卡片配置对话框的工作空间卡片页签中，单击你已创建的卡片。
2. 为卡片绑定数据。
   例如绑定淘票票（GetMovieAndShow）插件的返回参数 data.return_value。
   
   当你在智能体中查询最近上映的电影时，智能体将以卡片形式回复。
   

示例

例如搭建一个新闻助手智能体，其中添加头条搜索插件搜索新闻，并为插件的输出内容配置卡片，以卡片形式回复新闻内容。

1. 登录扣子编程。

2. 在页面顶部选择目标工作空间，然后在左侧导航栏中单击新建项目。

3. 在低代码模式区域，单击智能体开发。

4. 根据页面提示，创建一个新智能体。

5. 在智能体编排页面，添加头条搜索插件，并单击其对应的绑定卡片数据图标。
   

6. 在智能体回复卡片配置对话框，完成如下配置。

   1. 选择扣子编程提供的某款官方卡片，并选择竖向列表。
   2. 设置卡片列表最大长度为 5。
   3. 在为卡片整体绑定一个数组中，绑定数组data.doc_results。
      即为卡片绑定新闻插件的搜索结果集合。
   4. 为卡片内的列表项绑定数据。
      • ①标题：为卡片标题绑定变量 title，即绑定 data.doc_results 数组中 title 字段，用于展示搜索到的新闻标题。
      • ②内容：为卡片内容绑定变量 summary，即绑定 data.doc_results 数组中 summary 字段，用于展示搜索到的新闻内容。
   5. 设置卡片跳转链接。
      打开点击卡片跳转开关，并设置卡片跳转链接为 url。设置完成后，当你单击卡片时，将跳转到对应的 URL 页面。
   6. 单击确认。
      

7. 查看卡片效果。
   当你在智能体中查询今天的科技新闻时，智能体将以卡片形式回复。单击目标卡片，将打开对应的新闻网页。