# 预置组件功能介绍 平台提供了多种预置组件方便用户使用。 表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转换。 表2convert_obs_file_to_base64组件参数说明 | 参数分类 | 参数名称 | 参数说明 | |:---|:---|:---| | 输入参数 | obs_path | 待读取的obs文件路径。以"obs://"开头 | | 输入参数 | ak | obs文件所在租户的访问密钥（ak）。 | | 输入参数 | sk | obs文件所在租户的密钥（sk）。 | | 输出参数 | output | 文件转化为base64编码后的输出结果。 | 其中，AK、SK获取方法如下： 登录华为云[管理控制台](https://console.huaweicloud.com/console/#/home)，鼠标移动至页面右上角用户名位置，单击"我的凭证"，在"我的凭证"页面，进入"访问密钥"页签获取AK、SK。如果没有AK、SK可以通过单击"新增访问密钥"进行创建。 图1convert_obs_file_to_base64组件 ![](https://support.huaweicloud.com/usermanual-pangulm/zh-cn_image_0000002571047084.png) #### save_data_to_local_file组件 save_data_to_local_file组件用于将单层级的json格式数据存储到本地的csv或json文件中。 表3save_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数据后文件的长度。 | 图2save_data_to_local_file组件 ![](https://support.huaweicloud.com/usermanual-pangulm/zh-cn_image_0000002571206756.png) #### read_data_from_local_file组件 read_data_from_local_file组件可以用于读取本地数据，组件参数说明如下： 表4read_data_from_local_file组件参数说明 | 参数分类 | 参数名称 | 参数说明 | |:---|:---|:---| | 输入参数 | file_path | 要读取的本地文件路径，支持csv和json两种文件格式。例如：/home/HwHiAiUser/test.csv | | 输入参数 | encoding | 文件内容的编码方式。支持gbk和utf-8两种格式。 | | 输出参数 | data | 从文件中读取到的json数据 | 图3read_data_from_local_file组件 ![](https://support.huaweicloud.com/usermanual-pangulm/zh-cn_image_0000002601606293.png) #### deploy_together组件 deploy_together组件中文名称为同容器组件，所有拖入同容器组件中的子组件会被整合为一个容器服务，从而简化管理和部署流程。这些子组件共享同一个容器的资源，如CPU、内存和环境变量。这些子组件在同一容器中运行，减少了跨容器通信的开销和复杂性，便于统一配置和管理。 同容器组件参数说明如下： 表5deploy_together组件参数说明 | 参数分类 | 参数名称 | 参数说明 | |:---|:---|:---| | 部署配置 | CPU | 部署需要使用的最小CPU值（物理核）。 | | 部署配置 | 内存 | 部署需要使用的最小内存值。 | | 部署配置 | Ascend | 部署使用的npu卡数量。 | | 部署配置 | 环境变量 | 用户在组件代码中定义的外部环境变量。 | 图4deploy_together组件部署配置 ![](https://support.huaweicloud.com/usermanual-pangulm/zh-cn_image_0000002601726231.jpg) #### custom_python_script组件 custom_python_script组件与组件管理中的自定义脚本组件功能基本相同，支持用户自己编写Python代码完成特定组件功能。不同之处在于，custom_python_script组件支持在画布中进行参数的创建与删除，脚本代码的编写，调试过程中出现问题无需返回组件管理页面进行处理，大大方便用户的调试过程，可以在调试完成后归档在组件管理页面中。需要注意的是，每次在画布中拖入custom_python_script组件时，均需创建其参数和补充脚本，删除时，之前创建的信息会丢失。 图5custom_python_script组件配置 ![](https://support.huaweicloud.com/usermanual-pangulm/zh-cn_image_0000002601726251.png) #### call_stream_api组件 call_stream_api组件可以用于调用已经部署好的流式出参的模型服务。例如，nlp模型流式场景的组件参数说明如下： 表6call_stream_api组件参数说明 | 参数分类 | 参数名称 | 参数说明 | |:---|:---|:---| | 输入参数 | body | 调用服务请求所需要的请求体，为对象格式，默认为{}。 | | 输入参数 | headers | 调用服务请求所需要的请求头，为对象格式，默认为{}。 | | 输入参数 | url | 调用服务的请求地址，为字符串格式，画布中可通过"选择服务"按钮进行自动填充。 | | 输入参数 | request_type | 调用服务的请求类型，默认为POST。 | | 输出参数 | response | 调用服务的流式返回值。 | 图6call_stream_api组件 ![](https://support.huaweicloud.com/usermanual-pangulm/zh-cn_image_0000002601726253.png) #### call_api组件 call_api组件可以用于调用已经部署好的五大模型服务（非流式出参场景），组件参数说明如下： 表7call_api组件参数说明 | 参数分类 | 参数名称 | 参数说明 | |:---|:---|:---| | 输入参数 | body | 调用服务请求所需要的请求体，为对象格式，默认为{}。 | | 输入参数 | url | 调用服务的请求地址，为字符串格式，画布中可通过"选择服务"按钮自动填充，实现调用已部署的算法包组件。 | | 输入参数 | headers | 调用服务请求所需要的请求头，为对象格式，默认为{}。 | | 输入参数 | request_type | 调用服务的请求类型，默认为POST。 | | 输出参数 | response | 调用服务的返回值。 | 图7call_api组件 ![](https://support.huaweicloud.com/usermanual-pangulm/zh-cn_image_0000002571047120.png)