前提条件
1)入驻淘宝开放平台,详情请参考AI应用开发商-接入指南。
2)已经了解知识库的功能概述。
1. 登录淘宝开放平台,依次选择 AI 实验室 > 卡片集 > 我的卡片,如下图所示:
2. 在我的卡片界面,单击创建插件按钮,创建新的卡片。
3. 输入卡片基本信息,并点击确定。
1)卡片标题:用于描述当前自定义卡片的标题内容,最多 12 个字符。
2)卡片图标:目前支持文本卡片、图文卡片和商品卡片三种 Icon,开发人员可根据实际需求选择。
4. 根据实际需求,拖动组件到布局区,如下图所示:
说明:新创建时,系统默认会添加所有组件,可根据实际需求对组件进行添加和删除,同时卡片组件数量不能超过 6 个。
5. 点击布局区内的富文本子项,并点击增加富文本子项,如下图所示:
说明:当前是以新增一行富文本显示内容为例,可根据实际情况添加或修改富文本显示的内容。
6. 选择新增的富文本子项,点击操作栏中的? 图标,进入富文本子项的编辑界面。
7. 在富文本子项的编辑界面,设置子项类型、文本、字体颜色、字体大小、字体加粗、超链接等基本信息,最后单击确认,如下图所示:
注意:如果需要换行,可以在换行的地方按 Enter增加空白行, 即可实现换行。
添加成功后,如下图所示:
8. 完成布局后,点击卡片结构,查看当前布局区域内的卡片顺序及配置。
注意:若一个界面中出现多个相同组件,请在布局完成后,查看每个组件的顺序,为后续工作流的绑定做准备。
1. 组件设置完成后,点击右上角发布,发布当前版本。
2. 在发布的界面,查看当前卡片版本,并填写版本描述,最后单击确认。
注意:已发布版本无法进行编辑保存,只可进行本地模拟操作。
发布成功后,在版本选择中查看发布的版本,如下所示:
说明:绑定自定义卡片需要依靠工作流,如何创建工作流请参考创建工作流。
3. 添加或选择卡片输出节点,并单击去绑定,如下图所示:
4. 在自建卡片列表下,选择目标卡片,设置并绑定卡片数据,最后单击确定。
说明:
1)在绑定数据时,右侧的绑定顺序为卡片设计时的布局顺序,可依次在卡片集>组件区>卡片结构中查看。
2)边距的数据源高度单位为 px。
3)绑定数据来源时,绑定的数据都是前置节点设置的参数,且数据格式必须和搭建卡片时mock的数据格式保持一致。
4)在设置操作按钮时,目前官方仅支持配置最多不超过 3 个操作按钮。
5. 卡片输出节点设置完成后,单击右上角试运行按钮,进入试运行界面。
6. 在试运行界面,输入测试数据,然后点击试运行,如下图所示:
试运行成功后,可在试运行记录中查看记录,如下图所示:
7. 测试通过后,可点击功能区域发布按钮,发布当前工作流。
注意:只有运行成功的工作流才能进行发布。