SuperAPI AI 工具集

history-retrieve

办公与效率

查看项目

更新于 11-03 11:02

技能介绍

用途 该技能在故障受理之后、故障模式排序之前运行,为故障载荷补充有依据的历史与文档信息,回答“该资产以前是否出现过类似故障”“调取工单历史”“查找手册章节”等问题。

主要能力

  • 按 asset_id 过滤工单历史,将每条既往工单提取为 {failure_mode, days_ago, action} 写入 history.prior_work_orders[]。
  • 设置 history.window_days 为覆盖的时间跨度,并统计重复性症状维修次数。
  • 定位与所报症状匹配的 OEM 手册或故障排查指南章节,并将其引用随结果传递,成为后续排序原因的引用来源。
  • 将补充后的 history{} 数据块写回契约载荷。

输入

  • fault-intake.json(来自 fault-intake 的契约输入)。
  • 工单历史导出(CSV):日期、资产、故障模式、处理动作、停机时间。
  • OEM 手册摘录(PDF)与故障排查指南(Markdown)。
  • 可选:历史采样数据(CSV),如振动或温度趋势。历史输入为可选项,仅有文档时也可运行。

使用方式 作为故障受理后的固定环节,在每次分诊运行中执行;按上述步骤过滤、提取、定位并写回,输出带 history{} 对象和手册或指南引用的契约载荷,作为 failure-mode-rank 的输入。

依据要求 每条既往工单需引用其 CMMS 记录 ID;每条手册引用需注明手册章节(例如“OEM Pump Manual CP-200 §6.3”)。

适用场景 适用于需要结合资产维修历史和 OEM 文档进行故障分诊的维护场景。

限制

  • 仅做检索,不在此处进行诊断或排序(引擎与大模型职责分离)。
  • 不得为记录中未陈述故障模式的既往工单推断故障模式。
  • 历史采样数据仅为可选上下文,不是必需输入。
  • 若历史不可用,则仅依据文档继续运行,并在 escalations[] 中注明,不阻塞流程。