一、概述
资产盘点是数据治理的起点，帮助你快速了解数据资产的元数据质量和使用状态。本功能覆盖以下场景：
·元数据完整性扫描：识别缺失表描述、缺失字段描述、缺失 Owner 的资产，并按治理缺口严重度排序。
·元数据自动补全：基于字段名称与上下文语义，AI 自动生成表描述与字段描述建议。用户可在弹窗中查看批量写入结果，一键确认后保存。
·自然语言找数：用户用自然语言描述数据需求，AI 基于 Catalog 元数据（表名、字段名、表描述、标签等）进行语义匹配，返回最相关的表列表。找数结果附带「使用频率」与「最近活跃度」信息，数据来源为查询日志与 Catalog 统计。
Buddy 自动扫描目标范围内的资产，生成盘点报告，并在关键操作节点等待你确认后落地。单次盘点扫描无表数量上限限制，Schema 下表数量较大时系统将自动处理。
二、前提条件
·工作空间已开通 Buddy。
·当前账号拥有 Buddy 开发模式权限。
·对需要盘点的 Catalog / Schema 拥有查看权限。
·如需执行元数据写入（补全描述、设置 Owner），需要对应 Catalog 的元数据编辑权限。
三、你必须提供的信息
Buddy 在执行资产盘点前会要求你提供以下最小信息集，其余由 AI 自动分析：
| 信息项 | 说明 |
| 盘点范围 | 目标 Catalog、Schema 或具体表名 |
| 盘点目的 | 检查元数据完整性 / 补全描述 / 找数（可通过自然语言隐含表达） |
如果你的输入不完整，Buddy 会通过「Ask User 卡片」反问缺失信息后再继续；输入完整时会直接执行并展示结果。
四、AI 可智能生成的内容
| 内容项 | AI 生成方式 |
| 元数据缺口报告 | 扫描所有表与字段的描述、Owner、标签，按缺失严重度排序 |
| 表描述建议 | 基于表名、字段名推断业务含义，生成中英文描述 |
| 字段描述建议 | 分析字段名称模式（如 create_time、user_id）与数据类型，生成语义描述 |
| Owner 推荐 | 基于表的创建者、最近修改者、使用频率推荐 Owner 人选 |
| 语义找数结果 | 基于自然语言描述在 Catalog 元数据中做语义匹配，结合使用频率与活跃度排序 |
五、步骤 1：表达盘点需求
在 Buddy 输入框用自然语言描述需求，Buddy 会自动识别盘点类型与目标范围。
示例输入：
帮我看看 ods_catalog.dw_order 这个 Schema 下哪些表缺少描述
给 dwd_order_detail 表的所有字段自动补全描述
有没有记录用户浏览商品行为的表？最好是最近有人在用的
帮我找一下存储订单退款信息的表
这个 Schema 下有哪些表没有 Owner？
六、步骤 2：补充缺失信息
如果输入不完整，Buddy 会通过 Ask User 卡片反问你：
·未指定 Catalog / Schema 时，Buddy 会列出当前 Workspace 下可用的 Catalog 供选择。
·补全范围不明确时（单表、全 Schema），会要求你确认。
回答后 Buddy 继续执行。
七、步骤 3：审阅 AI 生成的结果
根据不同场景，Buddy 会展示不同形式的结果：
元数据盘点场景：以表格展示扫描结果，包含：
·表名、缺失项类型（表描述、字段描述 / Owner）、缺失数量、严重度评级
·总体缺失率统计与排序
元数据补全场景：以弹窗展示 AI 生成的描述建议，包含：
·表、字段原始名称
·AI 建议的描述文本
·置信度标识
自然语言找数场景：以列表展示匹配结果，包含：
·表名与所属 Catalog / Schema 路径
·表描述与核心字段概要
·语义匹配度评分
·最近使用频率与活跃度信息（数据来源为查询日志与 Catalog 统计）
注意：说明：
注意：你可以在补全建议中修改 AI 生成的描述后再确认写入。
八、步骤 4：确认并落地
元数据补全：在弹窗中查看批量写入结果，一键确认后 Buddy 调用 DataBuddy 接口批量写入描述，并展示写入结果（成功条数、失败条数）。
Owner 设置：确认 Owner 人选后，Buddy 批量更新表的 Owner 信息。
找数结果：你可以直接对找到的表继续操作，例如「帮我给这张表配质量规则」「查看这张表的字段详情」。
九、关键节点确认
| 确认项 | 确认时机 | 说明 |
| 盘点范围 | 扫描前 | 确认要扫描的 Catalog / Schema / 表 |
| 补全内容 | 写入前 | AI 生成的描述建议，可逐条修改 |
| Owner 人选 | 设置前 | AI 推荐的 Owner，可替换 |
| 批量操作 | 批量写入前 | 弹窗展示批量补全结果，一键确认后写入 |
十、Q：元数据补全会覆盖已有的描述吗？
A：不会。Buddy 默认只补全缺失的描述字段，已有描述不会被覆盖。如果你需要重新生成已有描述，可以明确指示「重新生成 xx 表的描述」。
十一、Q：自然语言找数的匹配范围是什么？
A：Buddy 会在当前 Workspace 下你有权限访问的所有 Catalog 中进行语义搜索。搜索基于 Catalog 元数据（表名、字段名、表描述、标签等）进行语义匹配，并结合使用频率与活跃度（来源为查询日志与 Catalog 统计）进行综合排序。
十二、Q：AI 生成的字段描述准确率如何？
A：AI 主要基于字段名称模式（如 create_time → 「创建时间」）和上下文语义推断，对规范命名的字段准确率较高。对于业务特定缩写或自定义命名，建议你审阅后按需修改。
十三、Q：批量补全时如何确认？
A：Buddy 会在弹窗中展示所有待写入的描述建议，你可以逐条查看和修改，然后一键确认批量写入。
十四、相关文档
·数据治理 Agent
·智能分类与打标
·数据目录概述