资产详情综合查询SKILL

更新时间:
复制 MD 格式

您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,批量查询资产的自定义属性值,并查询单个资产的目录挂载层级链与专题、目录描述。本文为您介绍该能力的功能、使用前提、使用示例与执行结果,并在附录中提供输入信息清单供参考。

功能介绍

资产详情综合查询能力支持您通过自然语言指令,只读地拼出一个资产的完整画像,覆盖两类信息:一是按一批资产GUID批量读取自定义属性的当前取值,可选只取关心的属性;二是查询单个资产挂载的专题与目录,并返回从根到叶子的完整目录层级链。该能力常用于资产盘点、画像展示以及属性写入后的回读校验,全部为只读查询,不会对资产做任何修改。

适用场景:

  • 一次性获取一批资产的自定义属性当前取值。

  • 查询某资产挂在哪个专题或目录下,以及从根到叶子的完整目录层级路径。

  • 属性写入后回读校验,确认属性值已按预期生效。

说明

能力限制:批量查询属性值时单次资产GUID上限为50,超限需分片查询;查询不存在的GUID不会报错,只是结果中不含该资产,需核对结果判断GUID有效性;本能力为纯只读查询,属性值的写入需使用资产自定义属性管理能力。

使用前提

  • 当前账号具备资产查询相关的权限。

  • 已获取要查询的资产GUID。若只知道表名或字段名,可先将其解析为GUID。

使用示例

您可以直接用自然语言向Agent描述需求,以下为可直接复制的指令示例:

  • 查一下这批表资产的自定义属性值。

  • 这个资产挂在哪个专题和目录下,把完整的目录层级路径给我。

  • 只查这批资产的治理状态和上架描述两个属性。

交互步骤:

  1. 您发出查询指令后,Agent会与您确认要查询的资产GUID及关心的属性范围。

  2. 若资产数量较多,Agent通常会按每批不超过50个GUID分片查询。

  3. Agent执行查询后,会整理并返回资产的属性值或目录层级信息。

  4. 若某个GUID未在结果中返回,Agent通常会提示该资产可能不存在,需您核对。

执行结果

操作完成后,您可以获得以下结果:

  • 返回内容:属性查询返回每个资产的自定义属性编码与取值;目录查询返回资产挂载的专题、目录及从根到叶子的完整层级链。

  • 完成状态:命令返回成功即完成查询;不存在的GUID不会报错,但也不会出现在结果中。

  • 查看与验证:您可以核对返回结果中是否包含目标资产GUID及其属性值或目录信息。

说明

本能力为只读查询,不会对资产做任何修改;查询结果以命令返回的实际数据为准。

附录:输入信息

以下为综合查询资产详情时可能涉及的信息项,仅供参考。实际使用时,Agent会根据您的指令自动识别所需信息,缺失时再向您询问;标注为无需提供的信息项由系统自动生成,您无需准备。

信息项

是否必填

说明

示例

租户ID

是

目标Dataphin租户的ID,为19位数字。

1234567890123456789

资产GUID列表

条件必填

查询属性值时提供的资产GUID数组,单次上限50。

odps.租户.项目.表名

属性编码列表

否

只查询关心的属性编码;不填时返回该资产的全部自定义属性。

治理状态、上架描述

资产GUID

条件必填

查询目录层级时提供的单个资产GUID。

odps.租户.项目.表名

是否含字段信息

否

查询目录时是否一并返回字段级信息,默认为否。

否

是否含明细属性

否

查询目录时是否一并返回明细属性,默认为否。

否