华为云用户手册

Redis和E CS 之间的连接问题 客户端所在的ECS必须和Redis实例在同一个VPC内，并且需要确保ECS和Redis之间可以正常连接。 如果是Redis 3.0或Redis 6.0企业版实例，Redis和ECS的安全组没有配置正确，连接失败。 解决方法：配置ECS和Redis实例所在安全组规则，允许Redis实例被访问。具体配置，可以参考配置安全组。 如果是Redis 4.0及以上基础版实例，开启了白名单功能，连接失败。 如果实例开启了白名单，在使用客户端连接时，需要确保客户端IP是否在白名单内，如果不在白名单，会出现连接失败。具体配置操作，可以参考配置白名单。客户端IP如果有变化，需要将变化后的IP加入白名单。 Redis实例和ECS不在同一个Region。 解决方法：不支持跨Region访问，可以在ECS所在的Region创建Redis实例，创建时注意选择与ECS相同VPC，创建之后，使用数据迁移进行迁移，将原有Redis实例数据迁移到新实例中。 Redis实例和ECS不在同一个VPC。 不同的VPC，网络是不相通的，不在同一VPC下的ECS是无法访问Redis实例。可以通过创建VPC对等连接，将两个VPC的网络打通，实现跨VPC访问Redis实例。 关于创建和使用VPC对等连接，请参考VPC对等连接说明。

迁移任务安全组说明 使用DCS在线迁移时，创建迁移任务需要选择安全组，迁移任务所选安全组的“出方向规则”需要放通源端Redis和目标端Redis的IP和端口（默认情况下安全组出方向是全部放通的，则无需再单独放通）。 使用DCS的备份迁移时，会使用到“default”安全组，需确认“default”安全组的“出方向规则”全部放通（默认情况下安全组出方向是全部放通的，则无需再单独放通）。 图2 迁移任务安全组“出方向规则”

VPC内访问Redis 3.0/Memcached/Redis 6.0企业版实例 为避免跨VPC访问导致时延增大影响DCS缓存实例性能，建议客户端部署在与DCS缓存实例处于相同虚拟私有云（VPC）和相同子网的弹性云服务器（ECS）上。 除了建议ECS、DCS缓存实例处于相同VPC之外，还需要他们的安全组分别配置了正确的规则，客户端才能访问DCS缓存实例。 如果ECS、DCS缓存实例配置相同的安全组，安全组创建后，默认包含组内网络访问不受限制的规则。 如果ECS、DCS缓存实例配置了不同安全组，可参考如下配置方式： 假设ECS、DCS缓存实例分别配置了安全组：sg-ECS、sg-DCS。 以Redis 3.0访问端口6379为例，其它实例请以实际情况为准。 以下规则，远端可使用安全组，也可以使用具体的IP地址。 配置ECS所在安全组。 ECS所在安全组需要增加如下出方向规则，以保证客户端能正常访问DCS缓存实例。如果出方向规则不受限，则不用添加。 配置DCS缓存实例所在安全组。 DCS实例所在安全组需要增加如下入方向规则，以保证能被客户端访问。 缓存实例的入方向规则中，源地址建议使用指定IP地址，慎用“0.0.0.0/0”，避免绑定相同安全组的弹性云服务器遭受Redis漏洞攻击。

迁移后验证 数据迁移前如果目标Redis中数据为空，迁移完成后，可以通过以下方式确认数据的完整性： 连接源Redis和目标Redis。连接Redis的方法请参考Redis-cli客户端连接Redis。 输入info keyspace，查看keys参数和expires参数的值。 对比源Redis和目标Redis的keys参数分别减去expires参数的差值。如果差值一致，则表示数据完整，迁移正常。 注意：如果是全量迁移，迁移过程中源Redis更新的数据不会迁移到目标实例。

迁移实例数据 登录分布式缓存服务管理控制台。 在管理控制台左上角单击，选择源Redis所在的区域。 单击左侧菜单栏的“数据迁移”。页面显示迁移任务列表页面。 单击右上角的“创建在线迁移任务”。 设置迁移任务名称和描述。 配置在线迁移任务虚拟机资源的VPC、子网和安全组。 迁移任务需要与源Redis和目标Redis实例网络互通，请选择与Redis实例相同的VPC。 迁移任务创建后，会占用一个租户侧IP，即控制台上迁移任务对应的“迁移机IP”，如果目标Redis配置了IP白名单，需要放通迁移机IP。 迁移任务所选安全组的“出方向规则”需放通源端Redis和目标端Redis的IP和端口（安全组默认情况下为全部放通，则无需单独放通），以便迁移任务的虚拟机资源能访问源Redis和目标Redis。 在线迁移任务创建完成后，单击在线迁移任务右侧“操作”列的“配置”，配置在线迁移的源Redis、目标Redis等信息。 迁移方法请选择“全量迁移＋增量迁移”，仅当选择“全量迁移＋增量迁移”的迁移方法时，支持通过控制台交换源端与目标端实例的IP地址。如果选择“全量迁移”，需要手动切换业务连接Redis的IP地址。 表1 在线迁移方法说明 迁移类型 描述 全量迁移 该模式为Redis的一次性迁移，适用于可中断业务的迁移场景。全量迁移过程中，如果源Redis有数据更新，这部分更新数据不会被迁移到目标Redis。 全量迁移＋增量迁移 该模式为Redis的持续性迁移，适用于对业务中断敏感的迁移场景。增量迁移阶段通过解析日志等技术， 持续保持源Redis和目标端Redis的数据一致。 增量迁移，迁移任务会在迁移开始后，一直保持迁移中状态，不会自动停止。需要您在合适时间，在“操作”列单击“停止”，手动停止迁移。停止后，源端数据不会丢失，只是目标端不再写入数据。增量迁移在传输链路网络稳定情况下是秒级时延，具体的时延情况依赖于网络链路的传输质量。 当迁移方法选择“全量迁移+增量迁移”时，支持选择是否启用“带宽限制”。 启用带宽限制功能，当数据同步速度达到带宽限制时，将限制同步速度的继续增长。 选择是否“自动重连”。如开启自动重连模式，迁移过程中在遇到网络等异常情况时，会无限自动重连。 自动重连模式在无法进行增量同步时，会触发全量同步，增加带宽占用，请谨慎选择。 “源Redis实例”和“目标Redis实例”，请分别选择需要升级的Redis 3.0实例和新建的高版本Redis实例。 如果源Redis和目标Redis为密码访问模式，请分别在“源Redis实例密码”和“目标Redis实例密码”处输入实例密码后，单击密码右侧的“测试连接”，检查实例密码是否正确、网络是否连通。如果源Redis和目标Redis为免密访问模式，无需输入密码，直接单击“测试连接”。 在“源DB”和“目标DB”中，可以选择是否需要指定具体迁移的DB。例如源端输入5，目标端输入6时，表示迁移源Redis DB5中的数据到目标Redis的DB6。当源端不指定DB，目标端指定DB时，表示默认迁移源端的全部数据到目标端指定的DB；当目标端不指定DB时，表示默认迁移到与源端对应的DB。本次操作“源DB”和“目标DB”置空即可。 单击“下一步”。 确认迁移信息，然后单击“提交”，开始创建迁移任务。 可返回迁移任务列表中，观察对应的迁移任务的状态，迁移成功后，任务状态显示“成功”。 如果是增量迁移，会一直保持迁移中的状态。 如需手动停止迁移，请选中需要停止的迁移任务，单击“停止”。 数据迁移后，目标端与源端重复的Key会被覆盖。 如果出现迁移失败，可以单击迁移任务名称，进入迁移任务详情页面，查看“迁移日志”。

方案概述 Redis开源社区自2019年5月19日发布Redis 3.0最后一个小版本后，一直未对Redis 3.0进行更新。华为云DCS也于2021年3月发布了停售DCS Redis 3.0的公告。 鉴于Redis 3.0版本较老，开源社区已不再对其进行更新，DCS提供的Redis 4.0/5.0/6.0/7.0高版本兼容Redis 3.0，建议客户尽快将DCS Redis 3.0升级到高版本。 DCS暂不支持直接升级实例版本，只能通过数据迁移将低版本实例中的数据迁移到高版本，从而实现Redis版本升级。本章节介绍如何通过数据迁移+交换实例IP的方式升级Redis 3.0实例到高版本。

前提条件 创建与Redis 3.0相同VPC和子网，相同实例类型、相同访问密码、且规格不小于原实例规格的高版本Redis实例。例如，用户需要将Redis 3.0 16GB主备实例升级到Redis 5.0版本，则需要提前创建一个不小于16GB的Redis 5.0主备实例。 创建Redis实例的操作，请参考创建DCS Redis缓存实例。 手动备份Redis 3.0源实例数据。备份数据的操作，请参考如何导出Redis实例数据？。

约束与限制 DCS Redis 3.0实例支持绑定弹性IP公网访问，Redis 4.0及以上版本的实例不支持直接绑定弹性IP，公网访问方式需通过ELB实现，开启Redis 4.0及以上版本实例公网访问的方式请参考开启Redis公网访问并获取公网访问地址，如果用户业务依赖公网访问，升级前请先进行评估。 通过数据迁移的方式升级Redis版本，对客户业务可能有以下影响： 数据同步完成后，需要交换源Redis与目标Redis实例的IP地址，交换IP地址时会有一分钟内只读和30秒左右的中断。 如果升级后实例与原实例密码不一致，数据同步完成后，需要切换访问Redis的密码，切换时需要停止业务。因此，建议升级前后实例密码保持一致。 建议在业务低峰期进行实例升级操作。

创建imap邮件连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“imap邮件”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 IMAP服务器地址 填写IMAP邮箱服务器地址。一般为IP地址或者 域名 形式。 不需要包含协议方案及端口号。 端口 SMTP邮箱服务器地址的端口。 邮箱地址 发件人邮箱地址。比如lilei@imap.com。 密码 发件人邮箱密码。 是否使用SSL加密 选择是否启用SSL加密。 描述 填写连接器的描述信息，用于识别不同的连接器。

配置参数 参数 说明 收件人 填写邮件的收件人邮箱地址列表，多个电子邮件地址使用英文逗号（,）分隔。 抄送 填写邮件的抄送人邮箱地址列表，多个电子邮件地址使用英文逗号（,）分隔。 密送 填写邮件的密送邮箱地址列表，多个电子邮件地址使用英文逗号（,）分隔。 主题 填写邮件的标题。 内容 填写邮件的内容。 内容类型 选择内容类型。 文本 HTML 重要性 选择邮件的重要性。 None 低 中 高 附件 添加邮件附件，格式为json数组，必填项为filename及contentData。可选填contentType，类型为mime.例如：[{"filename": "xxx.pdf","contentData": "text file","contentType":"application/pdf"}]

创建SMTP邮箱连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“SMTP邮箱”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 SMTP服务器地址 填写SMTP邮箱服务器地址。一般为IP地址或者域名形式。 不需要包含协议方案及端口号。 端口 SMTP邮箱服务器地址的端口。 邮箱地址 发件人邮箱地址。比如lilei@imap.com。 密码 发件人邮箱密码。 是否使用SSL加密 选择是否启用SSL加密。 描述 填写连接器的描述信息，用于识别不同的连接器。

参数说明 表1 IBM MQ常见的 CCSID 及其对应的字符编码 CCSID 描述 819 ISO 8859-1 (Latin 1) 1208 UTF-8 13488 UTF-16BE (Big Endian) 1200 UTF-16LE (Little Endian) 437 PC US ASCII 500 EBCDIC International 1047 EBCDIC US/Canada Open Systems 1140 EBCDIC US/Canada with Euro Symbol 父主题： 附录

设置数据结构 用户在编辑组合应用时，可以通过变量点选的方式引用前置节点payload中的字段。 当前支持两种方式配置节点payload的数据结构。 节点实际的payload的数据结构必须与设置的相同，否则将无法在后续节点中正常使用payload中的字段。 导入json 用户单击“导入json”按钮，选择需要导入的json文件，完成后可以在表格中看到导入的payload的数据结构。 例如，导入json文件内容如下： { "id":["123456"], "sort": 1, "attribute":{ "custom_fields":[{ "code":"codeA", "value":"111" }] } } 手动新增字段 用户单击表格中“新增根字段”按钮，表格中会自动生成一个待修改的字段；单击编辑按钮，修改字段名称和字段类型。如需继续新增字段请单击“新增根字段”按钮。 单击Object类型的节点对应的新增按钮，可以新增当前节点的子节点或相邻节点。 父主题： 参数设置与变量点选

重命名 存在需要名称不明确或错误的流节点时，用户可以重新编辑节点名称。 登录新版ROMA Connect控制台。 在左侧导航栏选择“组合应用”，在组合应用页面找到要编辑的组合应用。 单击组合应用上的“”，选择“编辑”，进入组合应用的编辑界面。 单击对应节点，打开节点编辑页面，单击节点名称右侧铅笔图标，在文本框中输入节点的新名称。 单击“√”图标保存输入的节点新名称。 单击组合应用详情页面右上方“保存”按钮。

复制与粘贴 一个组合应用里面需要多条重复的流时，用户可以对其中一个流节点做复制、粘贴操作。 登录新版ROMA Connect控制台。 在左侧导航栏选择“组合应用”，在组合应用页面找到要编辑的组合应用。 单击组合应用上的“”，选择“编辑”，进入组合应用的编辑界面。 将鼠标悬浮在需要复制的节点上，单击“复制”图标，完成节点复制。 将鼠标移动到待添加复制节点的连接线上，出现加号图标后，右键加号图标，单击“粘贴”按钮。

导入组合应用文件 在组合应用模板界面，可单击“文件导入”选项，通过上传组合应用的 JSON 文件，快速创建一个新的组合应用。 该功能适用于需要复用已有组合应用配置的场景，例如迁移组合应用、备份恢复或共享组合应用模板。通过导入 JSON 文件，系统会自动解析文件内容并生成对应的组合应用，包括其包含的业务流、触发器、连接器、处理器、变量等配置。 导入导出组合应用的操作步骤详见导入组合应用。 父主题： 创建组合应用

政企 iPaaS可以助力企业实现人员管理、新闻公关、门禁检测和企业数据入湖等能力，典型的集成模板包括： 实验室门禁安全监测：根据门禁刷卡信息，对进入人员与授权人脸库中进行比对，确认是否有非授权人闯入，进行 消息通知 和人脸图像留存。 根据打卡信息自动推送加班数据：每周根据打卡信息统计加班时长，并推送加班TOP排名数据。 数据接入：RabbitMQ对接 数据接入服务 实现园区数据调用的规整化。 图4 政企模板示例

医疗行业 iPaaS集成模板，帮助医疗机构将不同的临床和业务系统（如电子病历、病人管理系统、实验室信息管理系统等）进行集成，提升数据共享效率。典型的医疗行业集成模板包括： 药品管理系统集成：将药品库存、供应链和分发系统与医疗管理平台集成，确保药品管理的实时性与精确性。 医保支付子系统与药店零售进销存管理系统集成：医保支付系统付费的药品数据推送给药店进销存管理系统。 药店信息管理系统与其他药店管理系统集成：药店在进行零售活动时进行订单的跟踪和管理。

电商行业 iPaaS可以实现供应链、库存、订单、客户、支付等系统的高效集成，确保电商平台能够及时响应市场需求和客户反馈。常见的电商行业集成模板包括： 新增客户信息发送欢迎短信并通知客户经理：有新增客户信息时，主动发送欢迎短信给客户，并短信、邮箱、企微通知客户经理跟进。 热门商品库存预警：连接门店仓库管理系统，根据销量识别热门商品，对库存进行监测并预警通知。 生成品牌故事与自动化营销：定时根据关键字撰写文案发送给目标客户的企微 图2 电商模板示例

协同办公 协同办公模板助力企业集成各种办公软件，提升办公效率，典型的集成模板包括： 候选人面试通过后向候选人邮箱发送通知：每天定时查询面试已通过暂未发送通知信息的候选人表，获取候选人姓名、邮箱，通过QQ邮箱向候选人发送面试通过邮件，后将数据表中该候选人信息更改为已发送通知状态。 实时翻译邮件内容并推送至企业微信：当收到新的qq邮箱邮件时，自动检测邮件内容语言，将邮件内容翻译成所需的目标语言，将翻译内容推送至企业微信。 每小时监控流水线告警情况：设置定时器每小时触发一次异常监控上报处理，同时上传MySQL数据库及消息通知服务。 图5 协同办公示例

配置参数 表1 更新问卷状态 参数 说明 问卷编号 填写问卷编号。 Unix时间戳 用于请求的有效期检查，有效期时间为请求时间起30s内。需填写请求调用时的Unix时间戳。（Unix时间戳：格林威治时间1970年01月01日00时00分00秒起至请求调用时间的总秒数） 是否使用缓存 指定查询类接口是否使用缓存，默认值为“是”。 是 否 问卷状态 选择问卷状态。 发布或运行 暂停 删除 表2 获取问卷列表 参数 说明 Unix时间戳 用于请求的有效期检查，有效期时间为请求时间起30s内。需填写请求调用时的Unix时间戳。（Unix时间戳：格林威治时间1970年01月01日00时00分00秒起至请求调用时间的总秒数） 是否使用缓存 指定查询类接口是否使用缓存，默认值为“是”。 是 否 问卷发布者 不填时获取主账户发布的问卷，企业微信子账户需要在子账户名前加“qw$”前缀。 问卷编号 输入问卷编号。 文件夹名 获取该文件夹的问卷。 问卷名模糊查询关键字 不能包含特殊字符，精确匹配问卷名中包含模糊关键字的问卷，长度不超过10个字母或汉字。 查询开始时间戳 查询此时间戳以后的问卷（含节点时间），Unix时间戳（格林威治时间1970年01月01日00时00分00秒起至现在的总毫秒数）。 查询结束时间戳 查询此时间戳以前的问卷（不含节点时间），Unix时间戳（格林威治时间1970年01月01日00时00分00秒起至现在的总毫秒数） 分页页码 默认值为1，即返回第1分页。 分页大小 默认分页数为10，最大分页数为300，超过最大分页数时，使用默认分页数10。 是否获取企业的所有问卷 “是”表示获取企业的所有问卷，“否”表示仅获取主账户的问卷，仅在creator为主账户时有效，默认为“否”, 即仅获取主账户的问卷。 是否仅获取星标问卷 “是”表示仅获取星标问卷，“否”表示获取星标与非星标问卷，默认为“否”。 按时间查询类型 选择查询类型。 不按时间查询 按问卷开始时间 按问卷创建时间 排序规则 选择排序规则。 按问卷编号升序 按问卷编号降序 按问卷开始时间升序 按问卷开始时间降序 按问卷创建时间升序 按问卷创建时间降序 问卷状态 获取指定状态的问卷。 未发布 已发布 已暂停 已删除 彻底删除 被审核 问卷审核状态 获取指定审核状态的问卷。 已通过 审核中 未通过 待实名 表3 获取问卷详情 参数 说明 问卷编号 输入问卷编号。 Unix时间戳 用于请求的有效期检查，有效期时间为请求时间起30s内。需填写请求调用时的Unix时间戳。（Unix时间戳：格林威治时间1970年01月01日00时00分00秒起至请求调用时间的总秒数） 是否使用缓存 指定查询类接口是否使用缓存，默认值为“是”。 是 否 是否获取题目信息 选择是否获取题目信息，默认值为“是”。 是 否 是否获取题目选项信息 选择是否获取题目选项信息，默认值为“是”。 是 否 是否获取问答选项列表 选择是否获取问答选项列表，默认值为“否”。 是 否 是否获取题目设置信息 选择是否获取题目设置信息，默认值为“否”。 是 否 是否获取分页信息 选择是否获取分页信息，默认值为“否”。 是 否 是否返回简洁数据 选择是否返回简洁数据，默认值为“否”。 是：参数值为“是”时，是“否获取题目信息”、“是否获取题目选项信息”、“是否获取问答选项列表”、“是否获取题目设置信息”、“是否获取分页信息”的配置不生效。 否 数据是否返回json格式 仅“是否返回简洁数据”配置为“是”时生效。 选择数据是否返回json格式，默认值为“否”。 是 否 是否返回问卷标题 仅“数据是否返回json格式”配置为“是”时有效。 选择是否返回问卷标题，默认值为“否”。 是 否

创建自然语言处理连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“自然语言处理“连接器。 在弹窗中配置连接信息，完成后单击“确定“。 参数 说明 连接名称 填写连接器实例名称。 访问密钥ID 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 秘密访问密钥 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 描述 填写连接器的描述信息，用于识别不同的连接器。

创建 AI开发平台 连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“AI开发平台“连接器。 在弹窗中配置连接信息，完成后单击“确定“。 参数 说明 连接名称 填写连接器实例名称。 访问密钥ID 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 秘密访问密钥 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 描述 填写连接器的描述信息，用于识别不同的连接器。

创建 图像搜索 连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“图像搜索“连接器。 在弹窗中配置连接信息，完成后单击“确定“。 参数 说明 连接名称 填写连接器实例名称。 访问密钥ID 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 秘密访问密钥 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 描述 填写连接器的描述信息，用于识别不同的连接器。

配置参数 表1 对话问答 参数 说明 Content-Type 发送的实体的MIME类型。 project_id 项目ID。 deployment_id 模型的部署ID。 region_id 区域ID。 messages 多轮对话问答。 role 角色。 content 问答对文本内容。 user 用于代表客户的唯一标识符，最小长度：1，最大长度：64。 stream 流式调用的开启开关。 true为开启流式调用，如果要开启流式调用，请使用流式SDK； false为关闭流式调用。默认为关闭状态。 temperature 用于控制生成文本的多样性和创造力。参数的取值范围是0到1，其中0表示最低的随机性。一般来说，temperature越低，适合完成确定性的任务。temperature越高，例如0.9，适合完成创造性的任务。temperature参数可以影响语言模型输出的质量和多样性，但也不是唯一的因素。还有其他一些参数，如top_p参数也可以用来调整语言模型的行为和偏好，但不建议同时更改这两个参数。 top_p 一种替代温度采样的方法，称为nucleus sampling，其中模型考虑具有top_p概率质量的标记的结果。因此0.1意味着只考虑构成前10%概率质量的标记。通常建议更改此值或温度，但不要同时更改两者。通常建议更改top_p或temperature来调整生成文本的倾向性，但不要同时更改这两个参数。 max_tokens 用于控制聊天回复的长度和质量。一般来说，较大的max_tokens值可以生成较长和较完整的回复，但也可能增加生成无关或重复内容的风险。较小的max_tokens值可以生成较短和较简洁的回复，但也可能导致生成不完整或不连贯的内容。因此，需要根据不同的场景和需求来选择合适的max_tokens值。最小值：1，最大值：2048，默认值：16。 n 表示对每个问题生成多少条答案。n参数的默认值是1，表示只生成一个答案。如果想要生成多条答案，可以设置n参数为一个大于1的整数，例如n=2。这样，API会返回一个包含2个答案的数组。最小值：1，最大值：2，默认值：1。 presence_penalty 用于控制生成文本中的重复程度。正值会根据它们到目前为止在文本中的现有频率来惩罚新tokens，从而降低模型逐字重复同一行的可能性。 presence_penalty 参数可以用来提高生成文本的多样性和创造性，避免生成单调或重复的内容。最小值：-2，最大值：2。 表2 对通用文本 参数 说明 Content-Type 发送的实体的MIME类型。 project_id 项目ID。 deployment_id 模型的部署ID。 region_id 区域ID。 prompt 向模型输入的文本信息，最小长度：1，最大长度：4096。 user 用于代表客户的唯一标识符，最小长度：1，最大长度：64。 stream 流式调用的开启开关。 true为开启流式调用，如果要开启流式调用，请使用流式SDK； false为关闭流式调用。默认为关闭状态。 temperature 用于控制生成文本的多样性和创造力。参数的取值范围是0到1，其中0表示最低的随机性。一般来说，temperature越低，适合完成确定性的任务。temperature越高，例如0.9，适合完成创造性的任务。temperature参数可以影响语言模型输出的质量和多样性，但也不是唯一的因素。还有其他一些参数，如top_p参数也可以用来调整语言模型的行为和偏好，但不建议同时更改这两个参数。 top_p 一种替代温度采样的方法，称为nucleus sampling，其中模型考虑具有top_p概率质量的标记的结果。因此0.1意味着只考虑构成前10%概率质量的标记。我们通常建议更改此值或温度，但不要同时更改两者。通常建议更改top_p或temperature来调整生成文本的倾向性，但不要同时更改这两个参数。 max_tokens 用于控制聊天回复的长度和质量。一般来说，较大的max_tokens值可以生成较长和较完整的回复，但也可能增加生成无关或重复内容的风险。较小的max_tokens值可以生成较短和较简洁的回复，但也可能导致生成不完整或不连贯的内容。因此，需要根据不同的场景和需求来选择合适的max_tokens值。最小值：1，最大值：2048，默认值：16。 n 表示对每个问题生成多少条答案。n参数的默认值是1，表示只生成一个答案。如果想要生成多条答案，可以设置n参数为一个大于1的整数，例如n=2。这样，API会返回一个包含2个答案的数组。最小值：1，最大值：2，默认值：1。 presence_penalty 用于控制生成文本中的重复程度。正值会根据它们到目前为止在文本中的现有频率来惩罚新tokens，从而降低模型逐字重复同一行的可能性。 presence_penalty 参数可以用来提高生成文本的多样性和创造性，避免生成单调或重复的内容。最小值：-2，最大值：2。

创建盘古大模型连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“盘古大模型“连接器。 在弹窗中配置连接信息，完成后单击“确定“。 参数 说明 连接名称 填写连接器实例名称。 访问密钥ID 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 秘密访问密钥 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 描述 填写连接器的描述信息，用于识别不同的连接器。

配置参数 表1 语音 内容审核 参数 说明 project_id 项目ID，用于资源隔离。 region_id 区域ID。 data 与url参数二选一。 语音文件Base64编码字符串。要求base64编码后大小不超过4M。语音时长不超过1分钟。 url 与data参数二选一。 语音的URL路径，目前支持对服务授权访问华为云上OBS的URL，华为云上OBS提供的临时授权访问的URL和匿名公开授权的URL。 OBS服务的访问权限设置请参见配置OBS访问权限。 出于安全的考虑，当前服务不支持从公网上任意URL读取数据。 config 语音文件配置信息。 format 支持的语音格式。 pcm16k16bit pcm8k16bit ulaw16k8bit ulaw8k8bit alaw16k8bit alaw8k8bit mp3 aac wav amr amrwb property 所使用的模型特征串。通常是 “语种_采样率_领域”的形式。 采样率需要与音频采样率保持一致。 当前支持如下模型特征串： chinese_8k_common chinese_16k_common。 categories 审核场景。 当前支持的场景有默认场景和用户自定义场景： 默认场景为：politics：涉政；porn：涉黄；ad：广告 ；abuse：辱骂；contraband：违禁品 。 用户自定义场景为：自定义词库。 表2 任务提交 参数 说明 project_id 项目ID，用于资源隔离。 region_id 区域ID。 urls 图片的URL路径，目前支持： 公网HTTP/HTTPS URL 华为云OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详请参见配置OBS访问权限。 图片的URL路径列表最多支持500个URL地址。接口响应时间依赖图片的下载时间，如果图片下载时间过长，会返回接口调用失败。请保证被检测图片所在的存储服务稳定可靠，建议您使用华为云OBS存储。 categories 检测场景。 politics：是否涉及政治人物的检测。 terrorism：是否包含涉政敏感人物、涉政暴恐元素的检测。 porn：是否包含涉黄内容元素的检测。 可通过配置上述场景，来完成对应场景元素的检测。 为空或无此参数时默认检测politics和terrorism(不包含porn)。 moderation_rule 图像审核 规则名称，默认使用default规则。 审核规则的创建和使用请参见配置审核规则。 ad_categories 图文审核检测场景。当categories包含ad时，该参数生效。 当前支持的场景有系统场景和用户自定义场景： 系统场景为： qr_code：二维码 politics：涉政 porn：涉黄 ad：广告 abuse：辱骂 contraband：违禁品 用户自定义场景为：自定义黑名单词库。自定义词库的创建和使用请参见配置自定义词库。 show_ocr_text 是否返回ocr识别的结果。 true ：返回ocr识别的结果。 false：不返回ocr识别的结果。 表3 任务查询列表 参数 说明 project_id 项目ID，用于资源隔离。 region_id 区域ID。 status 图像内容审核任务处理状态如下： created 已创建 running 正在处理 finish 已完成 failed 处理失败 offset 偏移量， 默认为0。 limit 指定每一页返回的最大条目数，默认为符合查询条件的总任务数量。 表4 处理结果查询 参数 说明 project_id 项目ID，用于资源隔离。 region_id 区域ID。 job_id 任务标识。 表5 图像内容审核 参数 说明 project_id 项目ID，用于资源隔离。 region_id 区域ID。 urls 与image参数二选一。 图片的URL路径，目前支持： 公网HTTP/HTTPS URL 华为云OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详请参见配置OBS访问权限。 接口响应时间依赖图片的下载时间，如果图片下载时间过长，会返回接口调用失败。请保证被检测图片所在的存储服务稳定可靠，建议您使用华为云OBS存储。 image 与url参数二选一。 图片文件Base64编码字符串。要求base64编码后大小不超过10M。 政治人物检测人脸部分不小于50*50像素。 支持JPEG/PNG/BMP/WEBP/GIF格式。 moderation_rule 图像审核规则名称，默认使用default规则。 审核规则的创建和使用请参见配置审核规则。 categories 检测场景: politics：是否涉及政治人物的检测。 terrorism：是否包含涉政暴恐元素的检测。 porn：是否包含涉黄内容元素的检测。 ad：是否包含广告的检测（公测特性）。 all：包含politics、terrorism和porn三种场景的检测。 可通过配置上述场景，来完对应场景元素的检测。 为空或无此参数表示politics和terrorism都检测，但不包含porn场景。 每个检测场景的检测次数会分类统计。 ad_categories 图文审核检测场景。当categories包含ad时，该参数生效。 当前支持的场景有系统场景和用户自定义场景： 系统场景为： qr_code：二维码 politics：涉政 porn：涉黄 ad：广告 abuse：辱骂 contraband：违禁品 用户自定义场景为：自定义黑名单词库。自定义词库的创建和使用请参见配置自定义词库。 threshold 结果过滤门限，只有置信度不低于此门限的结果才会呈现在detail的列表中，取值范围 0-1，当未设置此值时各个检测场景会使用各自的默认值。 politics检测场景的默认值为0.95。 terrorism检测场景的默认值为0。 ad检测场景的默认值为0。 无特殊需求直接不传此参数或像示例中一样值设为空字符串即可。 如果检测场景中的最高置信度也未达到threshold，则结果列表为空；反之threshold过小，则会使结果列表中内容过多。 threshold参数不支持porn场景筛选。 threshold参数不会影响响应中的suggestion。 show_ocr_text 是否返回ocr识别的结果，默认为false。 true ：返回ocr识别的结果。 false：不返回ocr识别的结果。 表6 文本内容审核 参数 说明 project_id 项目ID，用于资源隔离。 region_id 区域ID。 categories 检测场景。 当前支持的场景有默认场景和用户自定义场景： 默认场景为： politics：涉政 porn：涉黄 ad：广告 abuse：辱骂 contraband：违禁品 flood：灌水 用户自定义场景为：自定义黑名单词库。自定义词库的创建和使用请参见配置自定义词库。flood场景不支持使用自定义白名单词库。 white_glossaries 启用的白名单列表。当前白名单使用规则为： 不传参数white_glossaries：表示默认使用2022-09-02 16:00:00之前创建的白名单词库 传参数white_glossaries： 参数为空时不使用任何白名单词库。 参数不为空时使用传入的白名单词库。自定义词库的创建和使用请参见配置自定义词库。 items 待检测的文本列表，目前暂时每次只支持传一个item。 text 待检测文本，编码格式为“utf-8”，限定5000个字符以内，文本长度超过5000个字符时，只检测前5000个字符。 type 文本类型，默认为“content”，即正文内容，当前只支持“content”类型，未来会扩大支持类型范围。

创建内容审核连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“内容审核“连接器。 在弹窗中配置连接信息，完成后单击“确定“。 参数 说明 连接名称 填写连接器实例名称。 访问密钥ID 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 秘密访问密钥 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 描述 填写连接器的描述信息，用于识别不同的连接器。

配置参数 表1 获取视频详情 参数 说明 project_id 项目ID，用于资源隔离。 video_id 视频ID。 region_id 区域ID。 表2 删除视频 参数 说明 project_id 项目ID，用于资源隔离。 video_id 视频ID。 region_id 区域ID。 表3 更新视频名 参数 说明 project_id 项目ID，用于资源隔离。 video_id 视频ID。 region_id 区域ID。 name 视频名称。 表4 创建视频 参数 说明 project_id 项目ID，用于资源隔离。 region_id 区域ID。 name 视频名称。 表5 获取视频列表 参数 说明 project_id 项目ID，用于资源隔离。 region_id 区域ID。 limit 范围：大于等于1；默认：10。 name 名称，长度小于63。 offset 范围：大于等于0；默认：0。 表6 关闭会话 参数 说明 project_id 项目ID，用于资源隔离。 qabot_id 机器人标识符。 session_id 会话标识符。 region_id 区域ID。 表7 处理会话 参数 说明 project_id 项目ID，用于资源隔离。 qabot_id 机器人标识符。 session_id 会话标识符。 region_id 区域ID。 extends 扩展参数。 tag_ids 待匹配的答案标签ID列表。 should 必须要包含其中之一的答案标签ID列表。 domain_ids 领域列表，多个领域用分号隔开。如果设置了领域且领域不为空，就从这些领域中匹配答案，否则就从该用户的全部知识库匹配答案。 当前最多支持10个领域。 source 问题来源，支持用户自定义，最终体现在问答日志里。 chat_enable true：使用内部闲聊语料进行兜底 ，默认true。 false：不使用闲聊兜底。 user_id 用户ID，在日志中用于标识不同用户，可以为任意String。 question 用户输入。 表8 开启会话 参数 说明 project_id 项目ID，用于资源隔离。 qabot_id 机器人标识符。 region_id 区域ID。 表9 关键词统计 参数 说明 project_id 项目ID，用于资源隔离。 qabot_id 机器人标识符。 region_id 区域ID。 start_time 查询的起始时间，long，UTC时间，默认值为0。 end_time 查询的结束时间，long，UTC时间，默认值为当前时间的毫秒数。 top 关键词最多显示的个数，默认值为10，取值范围0-50。 表10 问答统计 参数 说明 project_id 项目ID，用于资源隔离。 qabot_id 机器人标识符。 region_id 区域ID。 start_time 查询的起始时间，long，UTC时间，默认值为0。 end_time 查询的结束时间，long，UTC时间，默认值为当前时间的毫秒数。 interval 统计周期，目前支持month、week、day。 time_zone 请求所在时区，例如：中国东八区为"+08:00"；美国西五区为"-05:00"；默认为"UTC"。 domain 所属领域。 表11 访问统计 参数 说明 project_id 项目ID，用于资源隔离。 qabot_id 机器人标识符。 region_id 区域ID。 start_time 查询的起始时间，long，UTC时间，默认值为0。 end_time 查询的结束时间，long，UTC时间，默认值为当前时间的毫秒数。 interval 统计周期，目前支持month、week、day。 time_zone domain 请求所在时区，例如：中国东八区为"+08:00"；美国西五区为"-05:00"；默认为"UTC"。 所属领域。 表12 问答机器人 会话 参数 说明 project_id 项目ID，用于资源隔离。 qabot_id 机器人标识符。 region_id 区域ID。 extends 扩展参数。 tag_ids 待匹配的答案标签ID列表。 should 必须要包含其中之一的答案标签ID列表。 domain_ids 领域列表，多个领域用分号隔开。如果设置了领域且领域不为空，就从这些领域中匹配答案，否则就从该用户的全部知识库匹配答案。 当前最多支持10个领域。 source 问题来源，支持用户自定义，最终体现在问答日志里。 return_all_answers 是否返回所有类型的回答。 true ：返回所有类型的回答。 false：不返回所有类型的回答。 chat_enable 是否使用内部闲聊语料进行兜底。 true ：使用内部闲聊语料进行兜底 ，默认true。 false：不使用闲聊兜底。 user_id 用户ID，在日志中用于标识不同用户，可以为任意String。 question 用户输入。 session_id 会话标识符，UUID格式。如：c04e6f7b-61d7-4a2d-a0c8-f9ecd2f62359。 每次对话开启，机器人创建会话ID，下次请求中传入该ID表示继续该轮对话，每轮会话有效时间为2分钟。 若传入的会话ID已过期或者为空，则机器人会重新创建新的会话ID（重新创建会话id会消耗一定时间）。 query_types 指定发送的机器人类型集合。 0 ：知识库问答。 1 ：技能问答。 2 ：闲聊问答。 3 ：图谱问答。 4 ：文档问答。 5 ：表格问答。 非必填字段。如果不填，会使用默认的机器人融合策略。

创建 智能问答机器人 连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“智能问答机器人“连接器。 在弹窗中配置连接信息，完成后单击“确定“。 参数 说明 连接名称 填写连接器实例名称。 访问密钥ID 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 秘密访问密钥 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 描述 填写连接器的描述信息，用于识别不同的连接器。