华为云用户手册

str_split 通过指定分隔符对字符串进行分割。 函数格式 str_split(value, sep=None, maxsplit=-1) 参数说明 参数名称 参数类型 是否必填 说明 value 任意（自动转为String） 是 需要被分割的原字符串。 sep Number 否 分隔符，None表示空格。 maxsplit Number 否 最大分裂数。-1表示不限制。 返回结果 处理后的字符串。 函数示例 测试数据 { "content": "lts,a,log,service" } 加工规则 e_set("str_split", str_split(v("content"), ",")) 加工结果 content: lts,a,log,service str_split: ["lts","a","log","service"]

str_count 统计字符串里某个字符出现的次数。 函数格式 str_count(value, sub, start, end) 参数说明 参数名称 参数类型 是否必填 说明 value 任意（自动转为String） 是 被统计的原字符串。 sub 任意（自动转为String） 是 需要统计个数的字符。 start Number 否 字符串开始搜索的位置。 0（默认值）：第一个字符。 -1：最后一个字符。 end Number 否 字符串中结束搜索的位置。 0：第一个字符。 -1（默认值）：最后一个字符。 返回结果 返回指定字符出现的次数。 函数示例 测试数据 { "name": "lts is a log service" } 加工规则 e_set("str_count", str_count(v("name"), "l")) 加工结果 name: lts is a log service str_count: 2

后续指引 完成TPC-H样例模板开发并提交Spark SQL作业操作后，如果您想了解更多关于Spark SQL作业相关操作，建议您参考以下指引阅读。 分类 文档 说明 界面操作 SQL编辑器 提供执行Spark SQL语句操作的界面指导，包含SQL编辑器界面基本功能介绍、快捷键以及使用技巧等说明。 Spark SQL作业管理 提供Spark SQL作业管理界面功能介绍。 Spark SQL模板管理 DLI 支持定制模板或将正在使用的SQL语句保存为模板，便捷快速的执行SQL操作。 开发指导 Spark SQL语法参考 提供Spark SQL数据库、表、分区、导入及导出数据、自定义函数、内置函数等语法说明和样例指导。 使用Spark作业访问DLI元数据 提供Spark SQL作业开发的操作指引和样例代码参考。 Spark SQL 相关API 提供Spark SQL相关API的使用说明。

如果您是开发工程师 如果您拥有一定的开发经验，想要基于DLI现有能力进行更复杂的数据分析和开发，建议您学习和掌握以下功能模块。 模块 说明 开发指南 提供样例代码参考，您可以基于Flink、Spark的API进行二次开发，构建自己的应用Jar包，提交到DLI队列运行。 SDK参考 SDK是对DLI提供的REST API进行封装，便于您可以直接调用DLI SDK提供的接口函数实现使用DLI业务能力的目的。 API参考 您可以调用DLI提供的API接口完成数据分析等业务操作。

如果您是数据分析师 如果您是数据分析师，建议您先熟悉以下模块，掌握DLI支持的Spark、Flink等常用SQL语法，帮助你查询分析业务数据。 组件 模块 说明 Spark相关 数据库相关 在Spark场景下的创建数据库、删除数据库以及查看数据库等数据库操作语法。 表相关 在Spark场景下的创建表、修改表，删除表等语法。 跨源连接相关 跨源连接访问HBase、OpenTSDB、DWS、RDS、 CSS 、D CS 及DDS场景的下的语法。 自定义函数 Spark支持通过创建自定义函数来满足更多的计算需求。 内置函数 支持数学函数、日期函数、字符串函数、聚合函数、分析窗口函数等内置函数进行数据分析。 Flink OpenSource SQL相关 数据定义语句DDL 创建Kafka、DIS、JDBC、DWS、Redis、HBase、userDefined等source流获取数据，作为作业的输入数据。 创建ClickHouse、Kafka、DIS、DWS、Redis、 SMN 、HBase、Elasticsearch及userDefined结果表，用于将Flink作业输出数据写入到该表中。 创建JDBC、DWS、HBase的维表用于与Flink的输入流进行连接。 数据操作语句DML 支持查询、集合操作、窗口函数、JOIN等相关语法操作进行数据分析。 自定义函数 DLI支持的UDF自定义函数、UDTF自定义表值函数、UDAF自定义聚合函数的语法介绍和操作说明。 内置函数 DLI支持的数学运算函数、字符串函数、时间函数、条件函数、类型转换函数、集合函数、值构建函数、属性访问函数、Hash函数、聚合函数、表值函数语法介绍和使用示例。 Flink SQL相关 创建输入流 创建source流从CloudTable、DIS、DMS、EdgeHub、Kafka、OBS中获取数据，作为作业的输入数据。 创建输出流 DLI提供将作业的输出数据写入到CloudTable、OpenTSDB、Elasticsearch、DCS、DDS、DIS、DMS、DWS、HBase、RDS、Kafka中的语法操作。 创建中间流 中间流用来简化SQL逻辑，若SQL逻辑比较复杂，可以写多个SQL语句，用中间流进行串接。 创建维表 创建Redis、RDS的维表和Flink的输入流进行连接。

操作前准备 工具包 DLI的JDBC驱动：dli-jdbc-2.1.1.jar DBeaver客户端安装包： DBeaver官网提供了针对不同操作系统的客户端安装包，单击下载DBeaver访问DBeaver官网下载系统对应的DBeaver客户端安装包并完成安装 。推荐使用24.0.3版本的DBeaver。 连接信息： 类别 说明 获取方式 DLI AKSK AK/SK认证就是使用AK/SK对请求进行签名，从而通过身份认证。 获取AK/SK DLI Endpoint地址 地区与终端节点，即云服务在不同Region有不同的访问 域名 。 获取EndPoint DLI所在的项目ID 项目编号，用于资源隔离。 获取项目ID DLI区域信息 DLI所属区域信息 地区和终端节点

响应示例 状态码： 200 OK { "meta_info" : { "current_time" : "2023-12-13T09:55:45Z" }, "payload" : { "list" : [ { "id" : "ef4fd3d6-fa4e-49ea-989a-3216c36164d7", "cluster_id" : "3c151f54-e5df-4b6c-8690-b955df98a97f", "match_nodes" : 1, "usage" : "TRAINING_TRAIN", "cpu" : 5, "memory" : 20, "build_in" : false, "project_id" : "54d37c8f25af4277a1ff4ee9772687bf" }, { "id" : "38aa2057-4217-41d0-b5ba-94f8832e909e", "cluster_id" : "3c151f54-e5df-4b6c-8690-b955df98a97f", "match_nodes" : 1, "usage" : "TRAINING_TRAIN", "gpu_type" : "Pnt1", "gpu" : 1, "cpu" : 5, "memory" : 20, "build_in" : false, "project_id" : "54d37c8f25af4277a1ff4ee9772687bf" }, { "id" : "2ac937fa-d17a-4991-8e56-f1951b878af8", "cluster_id" : "3c151f54-e5df-4b6c-8690-b955df98a97f", "match_nodes" : 1, "usage" : "TRAINING_TRAIN", "gpu_type" : "Pnt1", "gpu" : 1, "cpu" : 4, "memory" : 20, "build_in" : false, "project_id" : "54d37c8f25af4277a1ff4ee9772687bf" }, { "id" : "7676f33e-cf22-4227-aac1-ac3865ceddb2", "cluster_id" : "3c151f54-e5df-4b6c-8690-b955df98a97f", "match_nodes" : 1, "usage" : "TRAINING_TRAIN", "gpu_type" : "Pnt1", "gpu" : 1, "cpu" : 4, "memory" : 32, "build_in" : false, "project_id" : "54d37c8f25af4277a1ff4ee9772687bf" } ], "page_info" : { "offset" : 0, "limit" : 4, "total" : 4 } } }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 payload ResourceSpecs object 实际返回的资源规格信息 meta_info RespMetaInfo object 元数据 表5 ResourceSpecs 参数 参数类型 描述 list Array of ResourceSpecsVo objects 资源规格列表 page_info PageInfo object 返回列表分页信息 表6 ResourceSpecsVo 参数 参数类型 描述 id String id cluster_id String 集群ID usage String 资源规格用途 枚举值： SIM_COMPILE(仿真编译) SIM_DOCKER(仿真异步镜像) DATA_PRO CES S(数据处理) DATA_CONVERSION(数据转换) DATA_RESIM(回放仿真) DATA_DESENSITIZATION(数据脱敏) TRAINING_TRAIN(训练任务) TRAINING_EVALUATE(模型评测) TRAINING_COMPILE(模型编译) ANNOTATION_MANUAL(人工标注) ANNOTATION_AI(预标注) ANNOTATION_SEGMENTATION(交互式分割) COMMON_DATASET(数据集) gpu_type String GPU类型(资源规格不包含GPU，此字段不会返回); 枚举值： Tnt004 Vnt1 Mnt06 Pnt1 Pnt004 gpu Integer GPU数量,整数(资源规格不包含GPU，此字段不会返回)； cpu Double CPU数量，单位Core,支持一位小数； memory Double 内存大小，单位GiB,支持一位小数； build_in Boolean 是否内置资源规格，true代表内置资源规格，false代表用户自定义资源规格。 project_id String 项目id match_nodes Integer 资源规格可用节点的数量 表7 PageInfo 参数 参数类型 描述 offset Integer 查询偏移量 limit Integer 返回个数上限 total Integer 资源总数 表8 RespMetaInfo 参数 参数类型 描述 current_time String 请求时间，UTC时间格式，时间为UTC标准时间。

请求示例 查询模板报表。模板ID为"600000001"，查询时间范围从"2022-06-01 07:20:50" 到 "2022-07-01 07:20:50"。 https://koomessage.myhuaweicloud.cn/v1/aim/template-reports/query { "tpl_ids" : [ "600000001" ], "begin_time" : "2022-06-01T07:20:50.522Z", "end_time" : "2022-07-01T07:20:50.522Z", "offset" : 0, "limit" : 10 }

响应示例 状态码： 200 返回信息。 { "template_reports" : [ { "tpl_id" : "600000001", "start_time" : "2022-06-30T00:00:00Z", "resolving_times" : 0, "end_time" : "2022-07-18T17:56:08Z", "expose_uv" : 3, "expose_pv" : 33, "click_uv" : 3, "click_pv" : 6 } ], "page_info" : { "offset" : 0, "limit" : 10, "total" : 1 } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 template_reports Array of AIMTemplateReport objects 查询模板报表结果集。 page_info Page object 分页信息。 表4 AIMTemplateReport 参数 参数类型 描述 tpl_id String 智能信息模板ID。 start_time String 统计开始时间。样例为：1970-01-01T00:00:00Z。 resolving_times Integer 实际已解析数。 end_time String 统计结束时间。样例为：1970-01-01T00:00:00Z。 expose_uv Long 消息曝光数。 expose_pv Long 消息曝光次数。 click_uv Long 消息点击数。 click_pv Long 消息点击次数。 表5 Page 参数 参数类型 描述 offset Integer 偏移量，表示从此偏移量开始查询，offset大于等于0。 limit Integer 每页显示的条目数量。 total Integer 总条数。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 error_msg String 结果详情。 error_message Object 结果详情。 说明： 该字段在以后可能会废弃，建议使用error_msg字段对接。 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 error_msg String 结果详情。 error_message Object 结果详情。 说明： 该字段在以后可能会废弃，建议使用error_msg字段对接。

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Content-Type 是 String 请求体参数类型，该字段必须设置为：application/json。 表2 请求Body参数 参数 是否必选 参数类型 描述 tpl_ids 是 Array of strings 智能信息模板ID列表，一次最多请求100个。 数组长度：1 - 100 begin_time 是 String 模板报表查询开始时间。样例：2019-10-12T07:20:50.522Z。 说明： 开始时间和结束时间最多间隔90天，超出时间限制返回为空。 最小长度：1 最大长度：30 end_time 是 String 模板报表查询结束时间。样例：2019-10-12T07:20:50.522Z。 说明： 开始时间和结束时间最多间隔90天，超出时间限制返回为空。 最小长度：1 最大长度：30 offset 否 Integer 偏移量，表示从此偏移量开始查询，offset大于等于0。 最小值：0 最大值：2147483647 缺省值：0 limit 否 Integer 每页显示的条目数量。 最小值：1 最大值：100 缺省值：20 factory_type 否 Array of strings 厂商类型。不填时默认全厂商。列举值："huawei", "vivo", "oppo", "xiaomi", "meizu", "samsung"。

请求示例 生成解析任务-个性化。模板ID为"600000001"，短链最大解析次数为1次，过期时间为7天。 https://koomessage.myhuaweicloud.cn/v1/aim/resolve-tasks { "tpl_id" : "600000001", "sms_signs" : [ "华为云 KooMessage " ], "aim_code_type" : "individual", "resolving_times" : 1, "domain" : null, "expiration_time" : 7, "params" : [ { "cust_flag" : "131****0000", "dync_params" : { "param1" : "参数1", "param2" : "参数2", "param3" : "参数3", "param4" : "参数4" }, "custom_url" : "https://www.example.com" }, { "cust_flag" : "131****0001", "dync_params" : { "param1" : "参数1", "param2" : "参数2", "param3" : "参数3", "param4" : "参数4" }, "custom_url" : "https://www.example.com" } ] } 生成解析任务-群发。模板ID为"600000002"，短链最大解析次数为5次，过期时间为7天，域名为"km2g.cn"。 https://koomessage.myhuaweicloud.cn/v1/aim/resolve-tasks { "tpl_id" : "600000002", "sms_signs" : [ "华为云KooMessage" ], "aim_code_type" : "group", "resolving_times" : 5, "domain" : "km2g.cn", "expiration_time" : 7, "params" : [ { "cust_flag" : "131****0000", "custom_url" : "https://www.example.com" } ] } 生成解析任务-自定义短码。模板ID为"600000002"，短链最大解析次数为5次，过期时间为7天，自定义短码为"abc123"。 https://koomessage.myhuaweicloud.cn/v1/aim/resolve-tasks { "tpl_id" : "600000002", "sms_signs" : [ "华为云KooMessage" ], "aim_code_type" : "group", "resolving_times" : 5, "domain" : "km3g.cn", "expiration_time" : 7, "generation_type" : "2", "params" : [ { "cust_flag" : "131****0000", "custom_short_code" : "abc123" } ] }

响应示例 状态码： 200 返回信息。 { "task_id" : "80959fd0-dc23-42e3-9595-59a49ee6cccc", "tpl_id" : "600000002", "sms_signs" : [ "华为云KooMessage" ], "resolving_times" : 5, "aim_code_type" : "group", "domain" : "km2g.cn", "expiration_time" : 7, "params" : [ { "cust_flag" : "131****0000", "cust_id" : "231724915a62455ca356e10a085c9a23", "dync_params" : null, "custom_url" : "https://www.example.com", "aim_url" : "km2g.cn/PDARc6", "aim_code" : "PDARc6", "result_code" : "0", "error_message" : null, "generate_date" : "2022-07-18T21:02:44Z", "expire_date" : "2022-07-25T21:02:44Z", "custom_short_code" : null } ] }

响应示例 状态码： 200 返回200状态码仅代表接口请求成功，任务提交结果由task_state字段来区分，此结果仅代表任务提交结果，并非智能信息发送结果。用户手机接收智能信息结果请以收到的回执结果为准，也可通过查询智能信息发送明细API获取或登录KooMessage控制台查看。 { "task_name" : "智能信息发送", "sms_channel" : { "channel_number" : "8822053111111", "sms_tpl_id" : 15010661, "sms_sign" : "华为云KooMessage", "sms_app_name" : "KooMessage" }, "resolve_task" : { "tpl_id" : "600000001", "resolve_times" : 1, "aim_code_type" : "individual", "domain" : null, "expiration_time" : 7, "generation_type" : "1", "params" : [ { "cust_flag" : "131****0000", "dync_params" : null, "custom_url" : "https://www.example.com", "custom_short_code" : null, "sms_params" : [ ] } ] }, "task_id" : "c3d7659d-06b0-4fa0-9eed-9225389ecccc", "task_state" : "Success", "creation_time" : "2022-07-19T14:37:34.00Z", "submission_count" : 1, "send_count" : 1, "resolve_count" : 0, "failed_short_chains" : [ ] }

请求示例 发送智能信息。模板ID为"600000001"，短链最大解析次数为1次，过期时间为7天，发送手机号码如"131****0000"；通道号为"8822053111111"，短信模板ID为"15010661"。 https://koomessage.myhuaweicloud.cn/v1/aim/send-tasks { "task_name" : "智能信息发送", "sms_channel" : { "channel_number" : "8822053111111", "sms_tpl_id" : 15010661, "sms_sign" : "华为云KooMessage", "sms_app_name" : "KooMessage" }, "resolve_task" : { "tpl_id" : "600000001", "resolve_times" : 1, "aim_code_type" : "individual", "domain" : null, "expiration_time" : 7, "params" : [ { "cust_flag" : "131****0000", "custom_url" : "https://www.example.com" } ] } } 发送智能信息-动态参数。模板ID为"600000002"，短链最大解析次数为1次，过期时间为7天，发送手机号码如"131****0000"，分别设置动态参数；通道号为"8822053111111"，短信模板ID为"15010661"。 https://koomessage.myhuaweicloud.cn/v1/aim/send-tasks { "task_name" : "智能信息发送-动态参数", "sms_channel" : { "channel_number" : "8822053111111", "sms_tpl_id" : 15010661, "sms_sign" : "华为云KooMessage", "sms_app_name" : "KooMessage" }, "resolve_task" : { "tpl_id" : "600000002", "resolve_times" : 1, "aim_code_type" : "individual", "domain" : null, "expiration_time" : 7, "params" : [ { "cust_flag" : "131****0000", "dync_params" : { "param1" : "参数1", "param2" : "参数2", "param3" : "参数3", "param4" : "参数4" }, "custom_url" : "https://www.example.com", "sms_params" : [ "参数1", "参数2" ] }, { "cust_flag" : "131****0001", "dync_params" : { "param1" : "参数1", "param2" : "参数2", "param3" : "参数3", "param4" : "参数4" }, "custom_url" : "https://www.example.com", "sms_params" : [ "参数1", "参数2" ] } ] } }

Step2 权重格式转换 AutoAWQ量化完成后，使用int32对int4的权重进行打包。昇腾上使用int8对权重进行打包，需要进行权重转换。 进入vllm代码目录下执行以下脚本： python vllm/model_executor/layers/quantization/convert_awq_to_npu.py --model /home/ma-user/Qwen1.5-72B-Chat-AWQ --version 2 参数说明: model：模型路径。 version：权重格式，传2。 执行时间预计10分钟。

资源规格要求 计算规格：对于Llama2-7B和Llama2-13B单机训练需要使用单机8卡，多机训练需要使用2机16卡。对于Llama2-70B至少需要4机32卡才能训练，建议使用8机64卡执行训练相关任务。 硬盘空间：至少200GB。 Ascend资源规格： Ascend: 1*ascend-snt9b表示Ascend单卡。 Ascend: 8*ascend-snt9b表示Ascend 8卡。

使用SmoothQuant量化工具转换权重 当前对Llama/Llama2/Llama3系列、Qwen系列、Qwen1.5系列模型支持AWQ(W4A16)和SmootQuant(W8A8)两种量化方案。 AWQ(W4A16)量化方案能显著降低模型显存以及需要部署的卡数。降低小batch下的增量推理时延。 SmootQuant(W8A8)量化方案能降低模型显存以及需要部署的卡数。也能同时降低首token时延和增量推理时延。 本章节介绍如何使用SmoothQuant量化工具如何进行权重转换。 SmoothQuant量化工具使用到的脚本存放在代码包AscendCloud-3rdLLM-x.x.x.zip的llm_tools目录下。 代码目录如下: AutoSmoothQuant #量化工具 ├── ascend_autosmoothquant_adapter # 昇腾量化使用的算子模块 ├── autosmoothquant # 量化代码 ├── requirements.txt # 第三方依赖 ├── setup.py # 安装量化模块的脚本 ... 量化方法：当前只支持激活值per-token，权重per-channel，动态量化。 具体操作如下： 配置环境。 cd llm_tools/AutoSmoothQuant/ pip install -r requirements.txt pip install -e . 配置需要使用的NPU卡，例如：实际使用的是第1张和第2张卡，此处填写为“0,1”，以此类推。 export ASCEND_RT_VISIBLE_DEVICES=0,1 NPU卡编号可以通过命令npu-smi info查询。 执行权重转换。 cd autosmoothquant/examples/ python smoothquant_model.py --model-path /home/ma-user/llama-2-7b/ --quantize-model --generate-scale --dataset-path /data/nfs/user/val.jsonl --scale-output scales/llama2-7b.pt --model-output quantized_model/llama2-7b --per-token --per-channel 参数说明: --model-path：原始模型权重路径。 --quantize-model：是否生成量化模型权重，需指定。 --generate-scale：是否生成量化系数，如不指定--scale-input参数，则需要指定。 --dataset-path：数据集路径，推荐使用：https://huggingface.co/datasets/mit-han-lab/pile-val-backup/resolve/main/val.jsonl.zst。 --scale-output：量化系数保存路径。 --scale-input：量化系数输入路径，若之前已生成过量化系数，则可指定该参数，跳过生成scale的过程。 --model-output：量化模型权重保存路径。 --smooth-strength：平滑系数，推荐先指定为0.5，后续可以根据推理效果进行调整。 --per-token：激活值量化方法，若指定则为per-token粒度量化，否则为per-tensor粒度量化，当前必须指定。 --per-channel：权重量化方法，若指定则为per-channel粒度量化，否则为per-tensor粒度量化，当前必须指定。 转换Qwen系模型可能比较耗时，72b权重大致需要3-5h。 启动smoothQuant量化服务。 参考Step6 启动推理服务，启动推理服务时添加如下命令。 --q smoothquant 或者 --quantization smoothquant 父主题： 推理模型量化

启动、停止和重启服务 在集群详情页，单击“组件管理”。 在指定服务所在行，单击“启动”、“停止”和“重启”执行启动、停止和重启操作。 服务之间存在依赖关系。对某服务执行启动、停止和重启操作时，与该服务存在依赖关系的服务将受到影响。 具体影响如下： 启动某服务，该服务依赖的下层服务需先启动，服务功能才可生效。 停止某服务，依赖该服务的上层服务将无法提供功能。 重启某服务，依赖该服务且启动的上层服务需重启后才可生效。

删除服务 MRS 3.1.2-LTS.3及之后版本支持添加和删除服务。 在集群详情页，单击“组件管理”。 在指定服务所在行，单击“删除”操作。 如果需要删除的服务存在上层依赖，则不可删除，每次只能删除一个服务。 不支持删除Hadoop（HDFS、Yarn、MapReduce）、Ranger、DBService、KrbServer、LdapServer和meta服务，其他已安装服务可删除。 如果确认删除，在弹出的“删除服务”窗口中输入“DELETE ”，单击“确定”，删除该服务。 在Console上删除服务会自动同步到Manager页面。 删除服务前，请先备份该服务的数据，避免数据丢失。

前提条件 需要在IAM 用户所属的用户组中，设置用户组的权限。 由于在集群上添加服务和删除服务属于高危操作，因此需要给该用户组绑定MRS FullAccess、MRS Administrator、Server Administrator 、Tenant Guest和MRS Administrator或Tenant Administrator任意一个策略才可以执行。具体权限说明请参见IAM用户同步MRS说明。 已完成IAM用户同步（在集群详情页的“概览”页签，单击“IAM用户同步”右侧的“同步”进行IAM用户同步）。 图1 IAM用户同步

节点池管理 在资源池详情页，单击“节点池管理”页签，您可以创建、更新和删除节点池。 图1 节点池管理 创建节点池 当您需要更多节点池时，可单击“创建节点池”新增节点池，相关参数请参见k8s Cluster资源购买。 查看节点列表 当您想查看某一节点池下的节点相关信息，可单击操作列的“节点列表”，可查询节点的名称、规格及可用区。 更新节点池 当您想更新节点池配置时，可单击操作列的“更新”，相关参数介绍请参见k8s Cluster资源购买。 需注意，更新节点池配置时，不同参数的作用范围不同，例如K8S标签节点、污点的修改，会同步更新节点池下的存量节点。容器引擎空间大小、节点子网等参数，仅对新增的节点（扩容或重置生效），存量节点配置保持不变。 图2 更新节点池 删除节点池 当有多个节点池时，支持删除节点池，此时在操作列会显示“删除”按钮，单击“删除”后输入“DELETE”并单击“确定”即可。 每个资源池至少需要有一个节点池，当只有一个节点池时不支持删除。 父主题： k8s Cluster资源使用

集成步骤 轻量级WEB聊天控件可以快速高效的集成到您的页面，请您根据图1进行集成开发。 图1 集成开发步骤 完成开发前资源准备，获取登录信息，配置在线客服功能，请参见开发前准备。 开发token生成机制与token认证接口，提供给云客服。云客服在鉴权通过后，会将Token发回给第三方系统，由第三方系统确认是否为本系统发的请求，请参见开发token生成机制与认证验证接口。 华为方使用HTTPS传输协议确保信息传输通道安全，请第三方确保开发的鉴权功能具备“口令复杂度校验”、“防暴力破解”、“防DOS攻击”等安全防护能力。 引入相关依赖框架，构造请求参数请求thirdPartyClient.js和newThirdPartyClient.js ，将Token信息、租户ID、企业侧的用户ID、用户名称等信息返回云客服，请求鉴权，鉴权通过后可实现云客服网页聊天能力的轻量级接入，请参见开发集成页面。 测试与验证WEB聊天控件功能，通过客户端窗口发起在线聊天检查与座席聊天功能，请参见测试与验证。 父主题： 集成轻量级WEB聊天控件（引入Token认证方式）

解决方法 跨域问题，是因为集成方的网站做了安全限制，不允许请求非本域提供的资源造成的。可通过使用负载均衡应用（如Nginx）的反向代理来解决。 图1 地址在负载均衡应用上的映射原理 即第三方页面使用JS调用时，调用本地域名下的一个服务，该服务放通到云客服的域名地址手上。 由于云客服只有识别到service-cloud，才会识别该请求，因此第三方页面的请求地址必须包含service-cloud。 以Nginx为例，整体配置要点如下： 在nginx.conf文件中添加首层服务地址，如下所示。 location /demo/ { proxy_set_header Host $host; set $Real $proxy_add_x_forwarded_for; if ($Real ~ (\d+)\.(\d+)\.(\d+)\.(\d+)\,(.*)){ set $Real $1.$2.$3.$4; } proxy_set_header X-Real-IP $Real; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass https://servicestage.besclouds.com/; } demo为样例，集成方可根据需要自行定义。 servicestage.besclouds.com请以云客服提供的地址为准。 location /service-cloud/ { proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_request_buffering off; proxy_pass https://servicestage.besclouds.com/service-cloud; } 在开发集成页面中采用如下地址进行JS请求，其中location.protocol请使用集成方的域名+上一步配置的服务名（例如demo）。 const $ContextPath = location.protocol + "/service-cloud" let serviceUrl = $ContextPath+ "/webclient/chat_client/js/thirdPartyClient.js?"+"&t=" + timestamp; let thirdUserData = {}; ......

解决方法 跨域问题，是因为集成方的网站做了安全限制，不允许请求非本域提供的资源造成的。可通过使用负载均衡应用（如Nginx）的反向代理来解决。 图1 地址在负载均衡应用上的映射原理 即第三方页面使用JS调用时，调用本地域名下的一个服务，该服务放通到云客服的域名地址手上。 由于云客服只有识别到service-cloud，才会识别该请求，因此第三方页面的请求地址必须包含service-cloud。 以Nginx为例，整体配置要点如下： 在nginx.conf文件中添加首层服务地址，如下所示。 location /demo/ { proxy_set_header Host $host; set $Real $proxy_add_x_forwarded_for; if ($Real ~ (\d+)\.(\d+)\.(\d+)\.(\d+)\,(.*)){ set $Real $1.$2.$3.$4; } proxy_set_header X-Real-IP $Real; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass https://servicestage.besclouds.com/; } demo为样例，集成方可根据需要自行定义。 servicestage.besclouds.com请以云客服提供的地址为准。 location /service-cloud/ { proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_request_buffering off; proxy_pass https://servicestage.besclouds.com/service-cloud; } 在开发集成页面中采用如下地址进行JS请求，其中location.protocol请使用集成方的域名+上一步配置的服务名（例如demo）。 const $ContextPath = location.protocol + "/service-cloud" let serviceUrl = $ContextPath+ "/webclient/chat_client/js/thirdPartyClient.js?"+"&t=" + timestamp; let thirdUserData = {}; ......

集成开发 此章节主要描述如何在您的系统的完成我们接续控件的集成。 登录前鉴权 同步企业系统与云客服的账号信息 您可以通过调用queryAgentInfo接口，获取可同步的座席信息，包括注册服务器信息、座席账户密码、云客服登录账号等信息，调用后将云客服登录账号与您原业务系统中的座席登录账号进行关联同步，使得在企业页面请求接续条时，能自动获取匹配的账户验证信息。 开发token生成机制与认证验证接口 开发集成页面 常见问题

概述 云客服提供可被直接集成的轻量级接续条，您可以轻松的将人工座席的语音处理能力集成在员工的常用操作界面上，来填补原有客户服务系统中人工语音/视频服务渠道的缺失，无需考虑排队机、计算机电信集成平台等基础设施的构建和维护成本。 轻量级接续条提供主要的语音/视频呼叫处理和座席状态控制的功能，具有如下特点： 轻量级，容易集成到不同的平台中，不占用门户和工作台的主要页面。 易于操作，客服人员签入平台、接听来话、转移呼叫、静音、状态切换或求助等操作均可通过一次点击完成。 您可通过本手册将云客服的核心功能嵌入到第三方系统中，通过iframe的方式集成座席签入签出、接续控制的界面（即轻量级接续条），如图1和图2所示。 轻量级集成不支持同一个座席多地登录、多浏览器与多环境签入，会造成事件丢失或者异常返回。若因此出现页面异常，需要退出或关闭多地登录、多浏览器与多环境签入，再刷新页面即可恢复正常。 图1 音频通话界面 图2 视频通话界面

操作步骤 调用座席软电话信息查询接口（queryAgentInfo）获取可用于同步的信息。 按以下格式要求获取URL，选择GET方式。 HTTPS方法：GET URL：http(s)://Domain Address/apiaccess/CC-Mangemant/v1/queryAgentInfo Domain Address请根据云客服实际的地址或域名进行替换。 例如，在华为公有云生产环境，请将Domain Address替换为service.besclouds.com，则调用URL为https://service.besclouds.com/apigovernance/api/oauth/tokenByAkSk HTTP协议是不安全协议，可能会对系统带来风险，不推荐使用。建议使用安全的HTTPS协议。 将x-app-key和Authorization的值按调用样例的格式输入到Header，获取所需输出参数，如图1所示。您可以通过表1和表2了解请求参数属性和返回参数属性的要求。 图1 queryAgentInfo调用 表1 RequestHeader说明 参数名 参数类型 参数位置 是否必填 说明 x-app-key string header True app标识。即您的app_key Authorization string header True 鉴权信息。为"Bearer "+鉴权接口获得的AccessToken Example { "x-app-key":XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX "Authorization":Bearer XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX } 表2 ResponseBody说明 参数名 参数类型 参数位置 是否必填 说明 sipServiceIp string body False 软电话注册地址，IPV4格式。 sipServicePort int body False 软电话注册端口，值为1~65535。 agents list body True 座席集合。 workNo int agents True 座席工号。 sipAccount string agents False 软电话号码。 sipPwd string agents False 软电话密码。 accountCode string agents False 云客服登录账号。 Example { "sipServiceIp":"10.100.10.10", "sipServicePort":1000, "agents": [ { "workNo": 1001, "accountCode": "11", "sipAccount": "1001", "sipPwd": "cti-1234" } ] } 同步到座席相关信息后，您可能还需要在您的系统中完成如下事项： （可选）将您业务系统中的账户与云客服座席对象做关联，在开发集成页面步骤请求云客服时需要用到关联好的账户。如果您期望企业业务系统的用户每次登录时自行选择云客服账号登录云客服，可以跳过该步骤。 （可选）为座席提供软电话号码、软电话密码以及软电话注册地址/端口号，座席需要使用这些信息登录OpenEye客户端，进行呼入呼出操作。如果您使用OpenEye以外的SIP软电话工具进行呼叫操作可以跳过该步骤。

监听事件的注册和事件处理程序的执行验证 完成页面集成之后，您需要测试与验证注册监听事件、移除监听事件、回调函数和一键外呼是否能正常使用。以下以Chrome浏览器为例。在验证过程中，您可以使用Nginx服务器来模拟第三方调用基础页面，您也可以使用其他您熟悉的访问方式进行。 本地开启Nginx服务器（Nginx版本可参考nginx/Windows-1.22.0），将集成页面放到nginx目录下的html中。您也可以在nginx.conf文件中配置集成页面的路径； 打开AICC页面，将您在步骤1配好的集成页面访问地址添加到地址白名单并配置弹屏； 打开音视频工作台，在您的集成页面注册事件（这里演示的页面在打开时自动注册了相应事件，所以打开时就执行了Init事件处理程序）； AICC Support Demo Page Init日志是1.3.1注册监听事件的事件处理程序输出的。 座席签入并注册监听响铃事件后，通过OpenEye客户端软件(参考OpenEye软电话安装指导)拨打配好的被叫号码； 座席来电，集成页面执行响铃事件处理程序并返回信息； AICC Support Demo Page Ringing日志是1.3.1注册监听事件的事件处理程序输出的。 父主题： 测试和验证