SuperAPI AI 工具集

using-datahub

数据与分析

查看项目

更新于 10-15 10:10

技能介绍

用途

using-datahub 是 DataHub 技能集合中的路由引导技能。它在会话开始时被注入,用于将用户的请求映射到正确的 DataHub 交互技能。该技能本身不直接执行目录操作,而是提供一份技能路由表与消歧规则,帮助确定应使用哪个技能及其命令。

主要能力

该技能提供以下路由能力:

  • 技能路由表:将用户意图对应到具体技能与命令。
  • 消歧规则:在意图不明确时给出判断依据。
  • CLI 归因说明:运行 datahub CLI 命令时传递技能名以便归因。
  • 关键规则:约束技能选择行为。

技能路由表

根据资料,路由表包含以下映射:

  • 查找或发现实体(搜索、浏览、过滤、列表):Search,命令 /datahub-search。
  • 回答关于目录的问题(“谁拥有 X?”、“有多少 X?”):Search,命令 /datahub-search。
  • 更新元数据(描述、标签、术语表术语、所有权、弃用):Enrich,命令 /datahub-enrich。
  • 探索血缘(上游、下游、影响、根因、依赖):Lineage,命令 /datahub-lineage。
  • 数据质量(断言、事件、健康检查):Quality,命令 /datahub-quality。
  • 通知(订阅断言失败、事件):Quality,命令 /datahub-quality。
  • 安装 CLI、认证、验证连接:Setup,命令 /datahub-setup。
  • 配置默认作用域和配置文件:Setup,命令 /datahub-setup。

消歧规则

当意图不明确时,使用以下规则:

“标签”请求:所有标签操作(PII、敏感、重要、已审查、team-x)归入 Enrich(通用元数据)。

“域”请求:将搜索过滤到某个域归入 Search(限定范围的搜索);配置默认域归入 Setup(配置文件配置)。

“质量”或“健康”请求:失败的断言、活动事件、健康状态归入 Quality;创建断言、运行质量检查、提出事件归入 Quality;订阅断言失败或事件归入 Quality;元数据质量/文档/所有权覆盖率则使用 Search 收集数据并综合答案。

血缘与搜索:

  • “什么输入到 X”/“什么依赖 X”/“更改 X 的影响”归入 Lineage。
  • “哪些仪表板使用表 X”归入 Lineage(关系遍历)。
  • “谁拥有 X”/“X 是什么”归入 Search(元数据查找)。

Setup 与其他技能:

  • “设置”/“安装”/“认证”/“验证连接”归入 Setup。
  • “配置默认值”/“设置默认平台”/“创建配置文件”归入 Setup。
  • “检查 DataHub 是否正常工作”归入 Setup(连接验证)。

使用方式

该技能在会话开始时注入,用于路由用户请求。运行 datahub CLI 命令时,在根命令上传递 -C skill=<name>,以便对使用情况进行归因。示例:

datahub -C skill=datahub-search search "revenue" datahub -C skill=datahub-enrich graphql --query '...' datahub -C skill=datahub-lineage lineage --urn "..."

使用 YAML frontmatter 中的技能名。如果 -C 不被识别,则省略它——命令在没有它的情况下工作方式相同。

关键规则

  • 永远不要猜测技能。如果意图确实不明确,请让用户澄清。
  • 除非用户明确要求多个操作,否则每个请求只使用一个技能。
  • Lineage 仅用于血缘——不用于一般的“这个实体是什么?”问题(那属于 Search)。
  • Search 处理临时性问题。“谁拥有 X?”和“X 有哪些列?”是 Search 问题,不是 Lineage。
  • Enrich 处理所有元数据写入——描述、标签、术语表术语、所有权、弃用。
  • Quality 处理数据质量——断言、事件、健康检查、订阅。
  • Setup 处理环境和配置——CLI 安装、认证、连接、默认作用域。

适用场景

该技能适用于需要与 DataHub 目录交互的会话,帮助将用户请求正确路由到 Search、Enrich、Lineage、Quality 或 Setup 技能。

限制

资料未提供该技能的具体实现细节、依赖条件、版本要求或收费信息。