本文通过调用第三方算法的Http接口进行图片清晰化算子的新增作为案例。
新建算子
在算子管理列表,点击【新建】按钮,进入算子新增页面;
填写算子基础信息
在跳转的算子新建页面,填写算子英文名、中文名、选择算子标签、填写算子描述、选择算子输入、输出类型、选择算法来源及算法类型;
算子英文名称:支持英文、数字、下划线,必须以英文开头,最少4字符,最多40字符,具备唯一性;
算子中文名称:支持中文、英文、数字、下划线,最少4字符、最多40字符;
算子标签:下拉选择,表示该算子归属于哪一场景;
算子描述:用于详细描述算子的功能,建议填写100字以上,详细描述算子的作用及算子对应的业务价值等信息;
算子输入类型:表示该算子是处理何种类型的数据,本案例选择图片;
算子输出类型:表示该算子输出何种类型的数据,本案例选择图片;
算法来源:表示算法的来源,本案例选择第三方Http;
算法类型:表示算法是生成类算法还是分析类算法,本案例选择生成类;
定义前端组件
第三方http接入都会基于接口文档,所以在配置前,您会从接口文档中知晓算法所需的输入参数,以及是否需要用户输入额外参数,如本案例中,需要调用的算法输入参数如下:
[
{
"data_type": "image",
"id": "",
"data": "${data base64}"
}
]从输入参数分析,可知本算法无需用户填写额外参数,故前端组件为空
定义算法信息
定义算法信息时,需要输入调用的算法的url地址;
http://1.0.0.127:8080/generator/predict【仅示例】配置页面中的选择算法配置项,为系统默认配置项,用户不可更改,用于执行算法的调用逻辑。
定义算法输入参数
将所调用算法的接口文档提供的输入参数填写至head参数或body参数填写框中;(需要用户填写额外参数的前端组件配置及输入参数配置见算子前端组件配置部分)
这里需要注意的是,若算法需传入的参数为文件,可以使用内置变量${data_base64},在body参数中将该变量填写到对应的存放位置中(如上面输入框的data参数),系统会将文件转换为Base64形式,并传输给算法。
定义算子输出参数
与分析类算法不同的时,生成类算法返回的是base64编码后的文件,所以,在算子输出参数配置处有一些不同。如本次案例中的算法返回如下:
{
"status": 0,
"base64": "/9j/4AAQSkZJRg......",
"message": "success"
}算子输出参数按如下逻辑配置:
某生成类算法返回为base64编码,某次执行的返回结果如下:
{
"status":0,
"result":[
{
"data":"base64ksdjsldkhfs……",
}
],
"message":"success"
}
我们需要取到该文件,则在文件输出路径输入$.result[*].data,系统会将base64编码转换为文件进行输出;
同样的,某生成类算法返回为text,某次执行的返回结果如下:
{
"status":0,
"result":[
{
"translate":"你好!世界!",
}
]
"message":"success"
}
我们需要取到这段文本,则在文件输出路径输入$.result[*].translate,系统会将取到的文本存储为txt文件进行输出。此时需要取到算法返回的文件,则在输出参数中进行如下配置:
| 文件类型 | 文件输出路径 |
|---|---|
| base64编码的文件 | $.base64 |
设置算子基础配置信息
最后设置该算子是否保存生成的文件或是生成的分析结果。一般来说,生成类算法会生成新的文件,此时建议勾选展示生成文件配置项,用于配置生成文件的存储路径;分析类算法会生成可解析的半结构化分析结果,此时建议勾选展示分析结果配置项,用于配置分析结果的存储表及映射关系。
保存算子
点击右下角【确定】按钮,即可保存算子,此时算子状态为【编辑中】。可在算子管理列表进行算子上线操作,上线后,算子会在算子广场及任务画布中展示。
自此本案例结束。