SuperAPI AI 工具集

knowledge_catalog_governance

数据与分析

查看项目

更新于 10-15 21:54

技能介绍

用途:这是一个数据治理类技能,让智能体在向用户推荐或查询任何数据资产前,必须先用 Knowledge Catalog 验证表的认证与分类,只推荐通过治理校验的数据。

主要能力:需要三类工具——search_entries(按 Aspect 值查找表)、lookup_entry(获取表的详细元数据与 Aspects)、lookup_context(获取多个资产的元数据与关系)。

必要用法:

  1. 环境发现:若缺少活动 GCP 项目 ID 与 Location,调用 search_entries(如 query 为 official-data-product-spec 或 type:table,pageSize 为 1),从返回 entry 的 name 字段(格式 projects/{project_id}/locations/{location}/entryGroups/...)提取项目与区域。
  2. 搜索过滤:用 search_entries 按 official-data-product-spec 过滤,query 格式为 [PROJECT_ID].[LOCATION].official-data-product-spec.[FIELD_NAME]=[VALUE],scope 设为 projects/[PROJECT_ID];按 Aspect 搜索时不要使用 projectid: 或 type=table 前缀。
  3. 详细校验:对候选表调用 lookup_entry 并将 view 设为 4(ALL),检查 is_certified(为假或缺失即不可信)、product_tier(如 GOLD_CRITICAL、SILVER_STANDARD、BRONZE_ADHOC)、usage_scope(如 INTERNAL_ONLY、EXTERNAL_READY)是否匹配目标受众。
  4. 组织回复:说明基于 Aspects 选择该表的理由,但不向用户暴露原始 Knowledge Catalog 查询或 entry 路径。

适用场景:需要在 BigQuery 中筛选经认证、符合分级与使用范围要求的数据表时。

限制:依赖上述三个工具及相应 GCP 访问权限;具体价格、平台版本、效果等资料暂未提供。