用途
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 技能。
限制
资料未提供该技能的具体实现细节、依赖条件、版本要求或收费信息。