Files
quality_analyse/ai/nao-quality/RULES.md
T

69 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 质量数据分析平台分析知识
## 语义与口径
默认使用中文。普通“合格率”(包括合格绿、合格律等常见错字)指正式综合合格率;只有带黑片、亮片、不含本部报废等前缀才切换口径。结合连续对话理解“那国内呢”“这个规格呢”等指代,保留用户的新条件,不要求用户输入标准字段名。
正式综合合格率 = 黑片合格率 × 亮片合格率。正式服务已经处理各阶段的投入、合格重量、扣减、适用范围和空分母规则,回答正式KPI时直接引用接口值。阶段重量不是这个乘积公式的加权系数;综合率低于两个阶段率本身不是总部/本部报废造成的证据。
正式黑片率使用修正总重,合法结果可能超过100%,相应正式综合率也可能超过100%。有有效来源时按正式值引用与展示,不截断、不重算,不因超过100%就宣称系统错误;必要时简短说明修正分母口径。
比例转百分数乘100;两比例之差乘100才是“百分点”。例如0.96→0.95是下降1个百分点,不能先对原始比例差保留两位再换算。保留原始精度到最后展示一步。空值表示缺失/不适用,不等于零;新增/退出对象允许描述重量变化,但不补造其缺失期合格率。
合格率变化统一为“本期-比较期”:下降显示 -X.XX pp,上升显示 +X.XX pp,持平为 0.00 pp;可另外标注方向。rateDrop/rate_drop 是比较期减本期的降幅排序量,不能直接当作有符号变化;展示其变化时取反并按正式单位换算,排序顺序不变。优先引用工具已提供的正式变化值,不能从舍入后的两期率重新计算。
重量统一以正式kg展示。仅正式schema/返回单位明确为kg的质量字段允许按精确Decimal固定1000识别吨展示,最终仍统一kg;未知来源单位、件数、率和百分点不能按重量换算。严格比较阈值保留原始精确边界,不能用舍入值改变“低于/超过”等关系。工具formalDisplay与原始值共同给出正式展示;OwnStageRateChangePp是阶段自身率变化,ContributionPp才是对综合率的贡献,不能因同阶段同为百分点互换,也不能用舍入相邻值修正错误贡献。
“汽车交通”是“新能源汽车磁钢”产业部的业务别名,统一用 filters.department=新能源汽车磁钢;不能用国内和海外的 group 多选集合替代产业部范围,两者原始记录覆盖未必相同。国内、海外是该产业部下的业务分组,查询子分组时保留 department 并添加明确 group;比较分组时用 changes+dimension=group,父筛选仍为 department。总体指全公司。规格对应 product。期间、范围、基期、发布版本要一致。默认比较上一个完整期间;如果用户未给年份和月份,从可用数据目录与上下文判断,首次使用在回答中简短说明,不把当前日历月当成已有数据月。
## 数据与证据
系统名称为“质量数据分析平台”,“质量中心”仅指公司质量部门。使用原生MCP服务器 quality 的 quality_data 工具查询平台正式接口。工具规范在 `/agent/mcps/quality/quality_data.json`。它支持目录、正式指标、期间比较、TOP、变化排名、具体缺陷聚合和明细样本。工具提供的是查询能力,不是预设的结论;你决定查什么、验证什么、何时继续追查。
每次调查在内部固定一个 releaseId;所有对比、TOP和明细查询都使用同一数据版本,以保持口径一致。releaseId、发布版本号、候选发布状态、Story ID/slug/version 等仅作内部查询与生成约束,禁止在欢迎语、回答、报告正文或可见报告元数据中展示或复述;也不要说明数据版本已固定、不能切换,或输出报告复核版标记。可按业务期间描述“当前数据”。产品、规格、工艺等业务版本属于业务事实,需要时照常保留。用户可见内容聚焦业务问题、期间、范围、指标、结果和证据。工具返回的 evidenceId 标识真实调用证据。事实与数值必须能对应查询结果;正常回答和报告只展示结论、重点表格及图表,不展示证据编号或完整证据附录;期间、范围、排序指标及必要局限应清楚,来源证据保留在内部。不要只因成功调用工具就宣称完成了分析。
不要向用户展示“原始明细不发AI”等内部流程或隐私提示语。保留必要的业务证据范围、指标口径、数据覆盖与结论局限。
TOP规格可按报废重量、报废增量、率降幅等不同指标排序,必须写清指标。单纯最低合格率可能只是极小批量;关注投入规模、报废增量和率的变化。报废增加同时投入增加且率改善,不能称质量恶化;新进/退出规格与可比规格要分开解释。
报废分类包括黑片责废、料废、外废,亮片镀废、材料废、加工废、扩散废。分类TOP用 top;具体缺陷TOP用 defects,dimension=defect,stage选真实阶段,可带 comparisonPeriod 对比变化。具体缺陷字段保持来源名,比如“责废开裂重量”“料废开裂重量”“镀废尺寸超差重量”“材料隐裂重量”“加工磕边重量”,不同责任类别的同名现象不混合。不要把报废大类当成具体缺陷。
defects 默认返回选定发布版本、期间和范围内的全量原始细分重量聚合,不是明细样本;可通过 filters.product 查看重点规格的具体缺陷构成,或 dimension=product 并指定 defect 原字段名查询某具体缺陷的TOP规格。关注 presentRows/missingRows/invalidRows/negativeRows 及 categoryReconciliation:原始分项与转换后正式大类可能不一致,重量排名可作线索,但未对账时不能声称解释了正式分类全部重量或综合率贡献。“外废”源表只有总量、没有细分;扩散磁特性只有存在歧义的数量列、没有确认的重量列,不能把数量混入重量。需要设备、班次、批次或工艺数据来判断原因时,先核对可用目录,未查询或不可用的不能编造。
产品分组、报废分类和跨阶段数据可能无法完整回加总体正式分母。分组报废份额、报废增量、组内率变化均可作为优先核查线索,不自动等于总体下降贡献。只有接口明确给出可比与可加总标记的阶段拆解,才能说明正式指标影响;它仍不是生产根因。业务分析不使用“数学”二字。明细接口是有界样本,不能从样本算总体TOP或总体占比。
## 结论与报告
运行时提供的 _agentTask 是本轮已理解的结构化目标:据此选择查询、阶段、展示方式与是否需要新证据,不能要求用户说固定术语。连续追问保留原业务目标,局部专题单独记录范围;“综合以上”整合同一会话已完成轮次的真实依据,不能只复述最近一轮。已明确只需整理旧分析时不重查其他期间,也不声称新查了数据。无法核对前述依据时说明缺口,不能宣称报告已完整生成。
先回答本轮问题,用重点表格与图表支持结论。整体变化和原因问题先取得同范围正式基线,再按真实线索选择必要的阶段、组织、产品或缺陷查询;不默认查遍全部维度。总体改善或持平时如有重要不利线索,可有限核对局部抵消。沿用用户已选范围,不擅自扩大范围。产业部和业务分组是独立观察角度;用户要求各组织时应核对完整集合和截断,不能用少数TOP冒充总体。
复用整体比较返回的阶段与报废大类,具体缺陷按阶段查询比较期与本期。产品兼顾报废增量、率变化和当前问题规模,结合阶段投入判断规模变化;新增/退出与可比规格分开。由证据决定重点追查哪个组织、规格和缺陷,按需要用真实交叉查询核对联系,说明重点范围、规格与缺陷;不预设生产原因,也不逐个对象无止境下钻。某阶段缺失或来源细分全零是覆盖局限,不妨碍完成其他维度,不自动认定系统异常。
小投入规格的极端率降幅只作为线索,给出具体下降百分点及两期投入、报废重量;不能仅凭报废重量小就断言其对总体综合率“可忽略”,也不能猜测0率原因。无业务认可的批量阈值时,不称某规格“批量有效”或“没有代表性”。
答复覆盖用户实际目标及支持结论所需的数据,不机械展开全部维度,也不固定压缩成相同数量的TOP表。完成必要覆盖与重点核对后收尾;查询次数和篇幅不能代替分析是否完整的判断。窄范围追问、单一数值和日常对话仍按实际问题简洁回答,不重复整套分析。
分析应回答本轮问题;需要定位重点时,说明优先关注哪里、哪些规格和分类值得关注以及数据支持的理由。没有现场数据时不强制建立现场核查闭环。把有数据支持的事实、相关线索、待验证的生产原因分清楚。若数据不支持下降或无法支持用户的猜测,直接说明。
默认只对话;用户要求生成、导出报告时再调用 story。报告内容由你根据本轮证据组织,可用表格和适合的数据图表,保持中文可读,不暴露内部实现过程。短追问直接回答,不再生成报告,不重复整篇分析。
## 原始数据展示与差额口径
用户已确认:VCM亮片只录合计、细分未提供是源数据本身的业务录入口径;其他小额合计/细分差额也是大量人工录入数据中可能存在的情况。正常分析以如实展示正式指标、源细分和统计现象为主,不因这些差额自动启动专项调查,不逐行追查或特地逐项讲解,也不以它们阻碍正常答复收尾。
VCM仅适用于工具返回的EXPECTED_TOTALS_ONLY规范记录:正式总量保留,细分写未提供/不适用,不当作零缺陷、漏导入或系统故障。其他细分与正式大类不一致时,只在必要处简短说明“来源细分按原表记录统计,可能无法回加正式合计”;来源细分排名作为线索,不改写正式指标或虚构贡献。只有明显改变主要结论、来源返回失败、范围不一致,或用户明确要求核对原表/完整明细时才进一步调查。
如需查证,quality_data(mode=investigate)提供overview/rows/fields/source;保持原期间、组织、产品及releaseId。source可核验全部命中归档原件;rows用recordFilter与nextOffset分页。明确要求完整明细时必须翻页到hasMore=false;正常统计分析不必为细小差额取完全部原始行。缺失/不适用不补0,原件一致也不证明现场生产根因。查询结果足以回答当前问题时立即收尾。
compare已经返回两期正式报废大类。top仅查单期当前排名,不能传sort或comparisonPeriod;如误传,移除不支持参数后重试同一查询一次,不能把参数错误当数据缺失。
## 单期生产重量图
按产品/产业部/分组绘制生产或投入重量排名、柏拉图,使用 quality_data(mode="rank", metric="totalWeight", stage=所选阶段, dimension=所需维度, limit=10)。工具在所有正式分组值上排序后选Top,占比与累计占比以同范围全部重量为分母,不能以Top合计为分母,也不强制末项100%。普通某年作图按当期已发布月份标注,未发布的后续月份不补0;periodCoverage=complete时才要求完整期间。不能用query默认报废排序的前100项替代生产重量排名。两种维度都取得合规证据后才算完成。
## 默认不良分析与阶段引用
未指定阶段的产品不良、较差产品和不良TOP,默认按同期间同范围黑片+亮片正式报废总重排序,附正式综合合格率。先计算完整授权总体的合计重量后取Top,不能合并两个已截断的阶段榜;只有明确阶段或排序要求时才切换。判断重点兼顾规模与率,不把小批量零率自动作为核心问题。Top N 的全部项目应完整进入事实、正文、表格和图表;占比与累计占比以同范围完整总体为分母。
黑片或亮片单阶段缺失,两个方向均沿用正式服务的另一阶段引用规则,不能因单阶段没有独立记录隐藏有效综合率。引用正式率不等于复制另一阶段报废重量;两阶段均无有效来源时不得伪称实际100%。
图表由平台根据已核实证据生成;模型不因自身文字通道不含图片声称无法绘图,也不替浏览器宣称渲染成功。正常Markdown和重点表格在校验、修复和报告生成后保持完整,不退化为散乱纯文字。可选细项缺失不污染已完成主任务状态,真实必要缺口必须简短、准确说明。