Agent Skills
返回列表
公贝资产巡检管理

公贝资产巡检管理

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8e8409b9/gb-asset-api。

技能介绍

要解决的问题

巡检和点检计划的创建在公贝资产里是一件"前置依赖链"很长的事:计划要绑定点位、巡检项目、执行班组、超时/异常提醒人,而这些实体在系统中大多只以名称或编码存在,真正写入计划时需要的是 pointId、sourceId、executorTeamId、userId。手工在页面逐个翻找、复制、粘贴极易出错,批量导入更难维护。

技能如何工作

  • 意图路由:先识别用户意图(创建/导入计划、查询、新建班组/项目、查询资产),直接跳转对应流程,不做无谓引导。
  • 鉴权:用 appKey / appSecret 换取 appToken,有效期 2 小时;所有接口均为 POST + JSON。
  • 实体解析:人名/工号解析为 userId;设备编码/点位名解析为 pointId(智能三级查找:巡检点位 → 资产清单 → 自动建点);巡检项目名解析为 formSourceId;班组名解析为 executorTeamId。解析不到时主动引导创建,而非报错终止。
  • 计划组装:13 个必填字段缺一不可,默认值(进行中、随机顺序、实时报警等)自动填充;提交前强制输出确认摘要表。
  • 批量导入:解析 Excel 逐行建计划,同名计划自动合并点位。
  • 容错:token 过期自动重取并续跑;计划重名、dto is empty 等错误按规则处理。

适用边界

  • 资产变更操作不在 API 范围:报修、报废、领用、退库、借用、转交、盘点无法通过接口完成,技能会先查询资产、生成 codeUrl 二维码,引导用户走移动端操作。
  • 查询筛选在本地完成:资产查询不支持按使用人、状态服务端过滤,需全量拉取后本地过滤。
  • 鉴权失败不重试:appKey 无效或应用被禁用时直接停止并说明原因。
  • 计划名称唯一:重名需用户更换名称后重试。

使用场景

  • 设备主管要为车间关键设备建立每日巡检计划,需绑定点位、巡检项目和执行班组
  • 巡检计划数量多且字段固定,运维人员希望用Excel批量导入而不是逐条手工创建
  • 计划引用的班组或巡检项目不存在,需要先创建班组或配置检查项再创建计划
  • 资产需要报修或领用,API无法直接变更状态,需生成二维码引导移动端操作

适合人员

  • 设备巡检主管:定期编排全厂巡检计划,需要批量创建计划并维护点位与班组配置
  • 资产管理员:维护资产台账,需要按使用人或状态筛选查询资产,并跟进报修领用等异常
  • 内部系统集成工程师:在自建系统或对话机器人中调用公贝资产开放API,关注鉴权续期与错误恢复
  • 现场运维班组长:负责巡检任务落地,需要确认执行班组、提醒人员和任务重复规则