技能(Skill)
在DataArts Studio平台进行数据开发或治理时,您通常需要在LakeAgent会话任务中调用各类功能模块以提升作业效率。例如:
- 当您需要对销售数据进行智能分析时,可调用官方预置的dataartsstudio-ask-and-analysis技能快速生成分析报告。
- 当您负责数据资产管理时,可使用dataartsstudio-dataassets-search技能快速检索数据资产。
- 当您的业务涉及特殊的数据处理逻辑时,可安装个人技能实现自动化处理。
然而,面对平台内众多的技能,您可能难以快速区分官方预置技能、企业技能与个人安装的技能,导致在查找、启用或禁用特定技能时操作繁琐。
为此,DataArts Studio提供了技能分类管理功能:
- 官方技能:平台提供的通用能力,开箱即用。
- 个人技能:您根据业务需求自行安装的自定义技能。
- 企业技能:企业提供的通用能力,需要添加和安装后才能使用。
通过分类管理,您可以在会话任务中快速定位并调用所需技能,提升作业效率。
基本概念
在使用技能管理功能前,建议您了解以下概念:
什么是技能(Skill)
技能是LakeAgent可调用的功能模块,封装了特定的数据处理或分析能力。您可以将其理解为手机应用中的App,每个技能专注于完成特定任务,如数据分析、资产检索、代码生成等。
技能分类如下:
| 类型 | 说明 | 来源 |
|---|---|---|
| 官方技能 | 由平台预置,覆盖常用场景,无需安装即可启用。 | 平台预置。 |
| 个人技能 | 由用户上传和安装,满足个性化业务需求。 | 用户上传和安装。 |
| 企业技能 | 企业提供的通用能力,需要企业添加、用户安装后才能使用。 | 企业上传、用户安装。 |
什么是会话任务
会话任务是您在LakeAgent中创建的对话任务。您可以用自然语言描述需求,系统会根据您的输入自动匹配并调用已启用的技能来完成任务。
例如,当您输入“帮我分析上月销售数据”时,系统会自动调用数据分析类技能来处理您的请求。
技能如何被触发
- 自然语言自动触发(推荐):系统会根据您输入的内容智能匹配技能。当您的描述与某技能的功能匹配时,系统会自动调用该技能处理请求。因此,确保相关技能处于“开启”状态非常重要。
- 快捷指令手动触发:如果您明确知道要使用哪个技能,可以在对话任务中,直接使用技能快捷指令,即在对话输入框中输入“/”触发技能选择,直接从已安装的技能列表中选择所需的能力。
约束与限制
| 限制项 | 说明 |
|---|---|
| 技能包大小 |
|
| 支持格式 | 支持“.zip”、“.rar”和“.tar.gz”格式文件,根目录必须包含SKILL.md。 |
| 技能命名规范 | 只能包含英文字母、数字和下划线。 |
| 文件扩展名 | 支持以下格式的文件(不区分大小写): “.md” “.txt” “.py” “.js” “.ts” “.sh” “.sql” “.cfg” “.ini” “.toml” “.yaml” “.yml” “.csv” “.json” “.jsonl” “.tsv” “.xml” “.css” “.htm” “.html” |
官方技能
LakeAgent预置了常用官方技能,无需安装,开启后即可在会话任务中调用。在技能页面切换至“官方”页签,即可查看可用的内置技能,并按需开启或关闭。
| 技能名称 | 功能说明 | 典型使用场景 |
|---|---|---|
| dataartsstudio-dataassets-search | 当用户需要按自然语言或表名搜索、查找数据地图中的数据表时使用。返回排序后的表信息,包括表名、表说明、数据源类型、数据库、数据Owner和工作空间。 |
|
| dataartsstudio-failed-job-inspection | 失败作业自动化原因诊断。输入作业名,定位其最近一次运行失败的实例,汇聚失败节点信息(节点类型、errorMessage、日志路径)。
|
|
| dataartsstudio-feature-query | 当用户咨询数据治理中心产品功能、支持的数据源、数据连接配置方式、SDK/CLI/API用法、版本差异、数据治理方法论、最佳实践或常见问题解答时使用。基于本地离线Markdown知识库(覆盖10个文档域),返回结果附带文档名、页面标题及URL出处,无需联网即可查询。 |
|
| dataartsstudio-job-dependency-check | 作业间依赖配置的完备性与准确性检查。输入作业名,基于数据血缘关系(即本作业读取的表由哪些上游作业产出)校验已声明的依赖作业是否存在遗漏(完备性)或误配与冗余(准确性),并输出缺失项、错误项清单及对应的血缘依据。 |
|
| dataartsstudio-job-modify-impact-analysis | 用于评估作业节点脚本或结构变更的下游影响范围。分析维度包括作业内受影响的节点(基于节点拓扑),以及跨作业的下游依赖。 |
|
| dataartsstudio-lineage-analysis | 用于全面解析数据表的血缘关系(含上游来源与下游去向),并评估数据变更的影响范围。 支持表级与字段级双粒度分析,精准返回上下游依赖链路及相关处理节点信息。 |
|
| dataartsstudio-management-center | 用于查询管理中心的各项资源配置信息,涵盖实例、工作空间、数据连接、空间用户与角色,以及数据源下的库、表、字段等核心管理对象。 |
|
| dataartsstudio-permission-check | 用于全面管控数据开发作业中的表级访问权限。该技能可自动识别作业所依赖的底层数据表,并通过调用数据安全接口精准校验当前用户的访问权限;若发现权限缺失,系统支持一键发起权限申请流程。 |
|
| dataartsstudio-pre-job-inspection | 用于作业的事前综合健康检查。支持输入指定的未提交调度作业名(若不指定则默认扫描当前空间内所有未提交作业),通过智能编排调用作业依赖检查、底表权限检查和底表SQL语法检查三项核心技能,自动生成包含“总体结论及三项明细”的综合评估报告。本功能仅作为纯编排层运行,全程执行只读操作,不会自动触发权限申请流程。 |
|
| dataartsstudio-sql-assistant | 用于对SQL代码进行智能解析、自动注释及逻辑续写。系统通过API获取数据源元数据(含表结构、字段类型及字段注释),并基于真实的Schema提供精准的SQL理解与生成能力。本功能不适用于SQL质量检测或违规审查场景。 |
|
| dataartsstudio-sql-quality-checker | 检测SQL代码中的语法错误、无效表名、缺少关联条件和分区过滤缺失等问题,支持直接粘贴SQL文本、输入脚本名称或作业名称三种方式快速分析,帮助您在运行前发现并修复潜在问题。 |
|
| dataartsstudio-table-usage-check | 自动分析数据表的访问热度,追踪数据上下游依赖关系,识别长期未使用的冗余表和可下线的作业,帮助优化存储成本和简化管理。支持大规模血缘分析的并发处理、速率控制和断点续跑,专注于数据治理场景的资源优化。 |
|
| dataartsstudio-upstream-analysis | 自动追踪数据开发作业的上游依赖链路,深度剖析任务延迟原因,精准定位等待与阻塞瓶颈,并智能预测任务完成时间,一键生成结构化分析报告,助您快速排查异常、掌控运行进度。 |
|
| dataartsstudio-ask-and-analysis | 支持自然语言问答式数据查询:输入问题 → 自动匹配数据源 → 智能生成查询 → 返回结果与分析,让数据获取更简单。 |
|
| dataartsstudio-data-development | 提供完整的数据开发能力,包括作业全流程管理(创建、测试、调度、监控)、脚本管理与安全校验、数据资产快速检索、数据连接配置等核心功能。内置丰富的标准化操作组件,支持灵活组合构建复杂业务流程。 |
|
| dws-cpu-diagnosis | 针对DWS集群CPU使用率过高、负载异常或触发告警等场景,自动采集运行指标并深度剖析根本原因(精准区分业务查询瓶颈与系统底层故障),一键生成标准化诊断报告,助您快速定位问题并恢复集群健康。 |
|
| dws-dynamic-memory-diagnosis | 针对DWS集群内存使用率过高、触发告警或出现OOM等场景,自动采集内存运行指标并深度剖析根本原因(精准区分业务查询瓶颈与系统底层故障),一键生成标准化诊断报告,助您快速定位问题并恢复集群健康。 |
|
| dws-io-diagnosis | 针对DWS集群I/O使用率过高、触发告警或磁盘负载异常等场景,自动采集关键运行指标并深度剖析根本原因(精准区分业务查询瓶颈与系统底层故障),一键生成标准化诊断报告,助您快速定位问题并恢复集群健康。 |
|
| dws-knowledge-qa | 当用户咨询华为云数据仓库服务DWS(GaussDB(DWS))的功能、集群操作、SQL语法、错误码、计费、性能调优、最佳实践或故障处理等问题时使用,基于本地离线官方文档库,采用脚本分层检索 + 只读命中chunk的方式回答,检索阶段零LLM token消耗,附带文档页面标题及官方URL出处,纯离线运行,无需联网。 |
|
| mrs-knowledge-qa | 当用户咨询华为云MapReduce服务MRS(FusionInsight Manager)的产品功能、集群操作、组件开发(HBase/HDFS/Hive/Spark/Flink/Kafka/ClickHouse/Doris/HetuEngine等)、Kerberos认证、ALM告警、最佳实践、故障处理、API或计费等问题时使用,基于本地离线官方文档库,采用脚本分层检索 + 只读命中chunk的方式回答,检索阶段零LLM token消耗,附带文档页面标题及官方URL出处,纯离线运行,无需联网。 |
|
实际可用技能以产品界面展示为准,平台会持续更新官方技能库。
安装个人技能
在使用LakeAgent进行智能分析或自动化任务处理时,用户依赖平台提供的官方内置技能来满足常规需求。然而,随着业务场景的不断细分和个性化需求的增加,官方内置技能往往无法完全覆盖所有特定的数据处理或分析任务。LakeAgent除了支持官方内置技能,还支持用户按需安装技能,您可以根据实际业务需要灵活安装自定义技能,从而快速构建贴合自身需求的智能分析工作流。
前提条件
您已获取到符合规范的技能压缩包。
操作步骤
- 登录DataArts Studio管理控制台。
详情请参考访问DataArts Studio实例控制台。
- 在DataArts Studio控制台首页,选择“LakeAgent”模块,进入LakeAgent页面。
- 方法一:
在左侧导航栏单击“技能”,再单击技能页面右上角的“添加”。
图1 添加
方法二:
在左侧导航栏单击“技能”,再单击技能页面右上角的“我安装的”。
图2 我安装的
在我安装的页面,单击“添加”。
图3 添加技能
- 在弹出框中,在“压缩包”区域,单击上传框选择文件上传技能压缩包,或直接拖动文件到框内上传技能压缩包。
- 文件上传完成后,单击“上传”,完成技能添加。
- 上传成功后,技能将出现在个人技能列表中。
- 如需取消操作,可单击“取消”关闭对话框。
- 技能添加成功后,您可以在我安装的页面的“个人技能”页签中查看、启用该技能。 图4 个人技能
企业技能
LakeAgent提供丰富的官方内置技能以满足常规的智能分析与自动化处理需求。为应对细分业务场景与个性化诉求,LakeAgent支持企业自定义技能。
通过引入企业自定义技能,您可以:
- 弥补官方能力盲区:针对特定的数据处理或分析任务,补充官方技能未覆盖的专属能力。
- 灵活按需安装:根据实际业务需求,从企业技能库中选择并安装所需技能。
- 构建专属工作流:快速组合官方与企业技能,打造高度贴合自身业务的智能分析流程。
- 登录DataArts Studio管理控制台。
详情请参考访问DataArts Studio实例控制台。
- 在DataArts Studio控制台首页,选择“LakeAgent”模块,进入LakeAgent页面。
- 在左侧导航栏单击“设置”。
- 在设置页面,单击左侧导航栏“企业技能”,再单击企业技能页面右上角的“添加”。 图5 添加技能
- 在弹出框中,在"压缩包"区域,单击上传框或拖动文件到框内上传技能压缩包。
- 文件上传完成后,单击"上传",完成技能添加。
- 上传成功后,技能将出现在企业技能列表中。
- 如需取消操作,可单击"取消"关闭对话框。
- 技能添加成功后,您可以在企业技能页面查看该技能。
后续步骤
添加企业技能后,您还需要安装企业技能后才能使用。
删除企业技能
约束限制
仅拥有DAYU Administrator或者Tenant Administrator权限的账号支持删除企业技能的操作。
操作步骤
删除操作不可恢复。删除后,该企业技能将从企业技能库中彻底移除,所有用户将无法继续使用该技能。如果该技能已被其他用户添加到个人任务中,相关任务也将受到影响。
- 登录DataArts Studio管理控制台。
详情请参考访问DataArts Studio实例控制台。
- 在DataArts Studio控制台首页,选择“LakeAgent”模块,进入LakeAgent页面。
- 在左侧导航栏单击“设置”。
- 在设置页面,单击左侧导航栏“企业技能”,在企业技能页面找到目标技能后,单击对应操作列的“删除”。 图6 删除企业技能
- 在弹出框中,确认删除操作,删除后该技能将从列表中移除且不可恢复。
编辑企业技能
随着业务发展,某个企业技能需要升级更新。此时您可以更新该技能的压缩包,而无需删除旧技能再新建。
约束限制
仅拥有DAYU Administrator或者Tenant Administrator权限的账号支持编辑企业技能的操作。
操作步骤
- 登录DataArts Studio管理控制台。
详情请参考访问DataArts Studio实例控制台。
- 在DataArts Studio控制台首页,选择“LakeAgent”模块,进入LakeAgent页面。
- 在左侧导航栏单击“设置”。
- 在设置页面,单击左侧导航栏“企业技能”,在企业技能页面找到目标技能后,单击对应操作列的“编辑”。 图7 编辑企业技能
- 在弹出框中,在"压缩包"区域,单击上传框或拖动文件到框内上传技能压缩包。
- 文件上传完成后,单击"上传",完成技能添加。
- 上传成功后,技能将出现在企业技能列表中。
- 如需取消操作,可单击"取消"关闭对话框。
- 技能上传成功后,完成更新。
安装企业技能
前提条件
已经添加企业技能。
操作步骤
- 登录DataArts Studio管理控制台。
详情请参考访问DataArts Studio实例控制台。
- 在DataArts Studio控制台首页,选择“LakeAgent”模块,进入LakeAgent页面。
- 在左侧导航栏单击“技能”。
- 在技能列表中找到目标企业技能。
可通过页面右上角的“搜索技能”输入框按名称筛选,或在企业技能列表中浏览查找。
- 找到目标技能卡片后,单击卡片右上角的“+”按钮,即可将该技能添加到当前任务中。 图8 安装企业技能
- 添加成功后,在企业技能列表中可查看该技能。
技能管理
- 登录DataArts Studio管理控制台。
详情请参考访问DataArts Studio实例控制台。
- 在DataArts Studio控制台首页,选择“LakeAgent”模块,进入LakeAgent页面。
- 在左侧导航栏单击“技能”,在技能页面单击“我安装的”。 图9 我安装的
- 在管理页面,显示企业技能和个人技能,在目标技能卡片的右上角,单击···(更多操作)图标,弹出操作菜单。
菜单提供以下操作选项:
表2 操作选项 操作
企业技能
个人技能
说明
使用
√
√
直接跳转到会话任务页面,调用该技能执行任务。
编辑
x
√
修改技能的名称、描述或配置信息。
下载
x
√
将技能包(.zip文件)下载到本地。
卸载
√
√
从平台中移除该技能。
说明:卸载操作不可恢复。卸载后,所有用户将无法继续使用该技能。如果该技能已被添加到自动化任务中,相关任务将无法正常运行。
- 单击所需操作项,按提示完成相应操作。
开启或关闭技能
- 登录DataArts Studio管理控制台。
详情请参考访问DataArts Studio实例控制台。
- 在DataArts Studio控制台首页,选择“LakeAgent”模块,进入LakeAgent页面。
- 在左侧导航栏单击“技能”。
- 企业技能和个人技能:
在技能页面单击“我安装的”。
找到目标技能卡片后,单击技能卡片右侧的开关按钮开启或关闭技能。
官方技能:
在技能页面找到目标技能卡片后,单击技能卡片,在弹出框中单击开关按钮开启或关闭技能。
表3 技能状态 状态
显示效果
说明
开启
开关显示为蓝色。
技能已启用,可在会话中自动触发。
关闭
开关显示为灰色。
技能已禁用,不会在会话中触发。
- 开启技能后,建议进行简单测试:
- 进入会话任务页面。
- 输入与该技能功能相关的自然语言指令。
- 确认系统是否正确调用了该技能。
常见问题
问:技能安装失败怎么办?
答:请检查以下几点:
- 技能包格式是否为.zip / .rar / .tar.gz格式文件,根目录必须包含SKILL.md。
- 文件大小是否超过50MB。
- 技能名称是否符合命名规范(仅允许英文字母、数字和下划线)。
问:技能启用后在会话中不生效如何排查?
答:请按以下步骤排查:
- 确认技能开关已开启(显示为蓝色)。
- 刷新页面后重试。
- 检查技能描述是否与您的输入意图匹配。
- 如问题持续,请联系技术支持。
问:如何删除已安装的技能?
答:在“我安装的”页签中,找到目标技能,单击技能卡片上的“删除”按钮。删除后该技能将无法在会话中使用。
问:官方技能可以禁用吗?
答:可以。如果您不需要某些官方技能,可以将其关闭。关闭后该技能不会在会话中被触发,但您可以随时重新开启。