预置组件功能介绍

平台提供了多种预置组件方便用户使用。

表1 预置组件清单
组件类别	组件名称	功能介绍
数据读写	convert_obs_file_to_base64	convert_obs_file_to_base64组件
	save_data_to_local_file	save_data_to_local_file组件
	read_data_from_local_file	read_data_from_local_file组件
逻辑组件	deploy_together	deploy_together组件
自定义脚本	custom_python_script	custom_python_script组件
其他	call_stream_api	call_stream_api组件
其他	call_api	call_api组件

convert_obs_file_to_base64组件

convert_obs_file_to_base64组件用于读取obs上的文件，并将其转换为base64编码，适用于类似图片的小文件base64转换。

表2 convert_obs_file_to_base64组件参数说明
参数分类	参数名称	参数说明
输入参数	obs_path	待读取的obs文件路径。以“obs://”开头
	ak	obs文件所在租户的访问密钥（ak）。
	sk	obs文件所在租户的密钥（sk）。
输出参数	output	文件转化为base64编码后的输出结果。

其中，AK、SK获取方法如下：

登录华为云管理控制台，鼠标移动至页面右上角用户名位置，单击“我的凭证”，在“我的凭证”页面，进入“访问密钥”页签获取AK、SK。如果没有AK、SK可以通过单击“新增访问密钥”进行创建。

图1 convert_obs_file_to_base64组件

save_data_to_local_file组件

save_data_to_local_file组件用于将单层级的json格式数据存储到本地的csv或json文件中。

表3 save_data_to_local_file组件参数说明
参数分类	参数名称	参数说明
输入参数	file_path	本地文件的路径，支持csv和json两种文件格式。例如：/home/HwHiAiUser/test.csv
	data	要写入文件的json数据。
	encoding	文件内容编码。支持gbk和utf-8两种格式，默认值gbk。 file_path文件为csv格式时，建议使用gbk编码。
输出参数	flag	写入json数据后文件的长度。

图2 save_data_to_local_file组件

read_data_from_local_file组件

read_data_from_local_file组件可以用于读取本地数据，组件参数说明如下：

表4 read_data_from_local_file组件参数说明
参数分类	参数名称	参数说明
输入参数	file_path	要读取的本地文件路径，支持csv和json两种文件格式。例如：/home/HwHiAiUser/test.csv
输入参数	encoding	文件内容的编码方式。支持gbk和utf-8两种格式。
输出参数	data	从文件中读取到的json数据

图3 read_data_from_local_file组件

deploy_together组件

deploy_together组件中文名称为同容器组件，所有拖入同容器组件中的子组件会被整合为一个容器服务，从而简化管理和部署流程。这些子组件共享同一个容器的资源，如CPU、内存和环境变量。这些子组件在同一容器中运行，减少了跨容器通信的开销和复杂性，便于统一配置和管理。

同容器组件参数说明如下：

表5 deploy_together组件参数说明
参数分类	参数名称	参数说明
部署配置	CPU	部署需要使用的最小CPU值（物理核）。
	内存	部署需要使用的最小内存值。
	Ascend	部署使用的npu卡数量。
	环境变量	用户在组件代码中定义的外部环境变量。

图4 deploy_together组件部署配置

custom_python_script组件

custom_python_script组件与组件管理中的自定义脚本组件功能基本相同，支持用户自己编写Python代码完成特定组件功能。不同之处在于，custom_python_script组件支持在画布中进行参数的创建与删除，脚本代码的编写，调试过程中出现问题无需返回组件管理页面进行处理，大大方便用户的调试过程，可以在调试完成后归档在组件管理页面中。需要注意的是，每次在画布中拖入custom_python_script组件时，均需创建其参数和补充脚本，删除时，之前创建的信息会丢失。

图5 custom_python_script组件配置

call_stream_api组件

call_stream_api组件可以用于调用已经部署好的流式出参的模型服务。例如，nlp模型流式场景的组件参数说明如下：

表6 call_stream_api组件参数说明
参数分类	参数名称	参数说明
输入参数	body	调用服务请求所需要的请求体，为对象格式，默认为{}。
	headers	调用服务请求所需要的请求头，为对象格式，默认为{}。
	url	调用服务的请求地址，为字符串格式，画布中可通过“选择服务”按钮进行自动填充。
	request_type	调用服务的请求类型，默认为POST。
输出参数	response	调用服务的流式返回值。

图6 call_stream_api组件

call_api组件

call_api组件可以用于调用已经部署好的五大模型服务（非流式出参场景），组件参数说明如下：

表7 call_api组件参数说明
参数分类	参数名称	参数说明
输入参数	body	调用服务请求所需要的请求体，为对象格式，默认为{}。
	url	调用服务的请求地址，为字符串格式，画布中可通过“选择服务”按钮自动填充，实现调用已部署的算法包组件。
	headers	调用服务请求所需要的请求头，为对象格式，默认为{}。
	request_type	调用服务的请求类型，默认为POST。
输出参数	response	调用服务的返回值。