资产
模板
适用于企业 IT 资产导入 Mopheus 的 Excel 与表格化台账模板规范，支持 AI 智能体自动解析生成声明式资产清单 YAML。
在企业初始化导入或批量同步 IT 资产时，可以向客户或运维团队提供标准的 Excel / CSV 台账表格。Mopheus 的 AI 智能体在阅读该表格后，能够自动完成字段映射、模式校验，并生成带有完整技术属性、治理标签与拓扑边的声明式资产清单 YAML（AssetManifest）。
为了契合人类运维与资产管理员的实际填报习惯，台账将技术属性（attributes）与治理标签（labels）中的核心必填/高频项全部拆解为独立列，彻底避免手工拼装键值字符串。
一、 资产台账主表（Assets Sheet 规范）
1. 字段定义表
| 分类分组 | 字段名称（中/英） | 必填 | 映射目标 | 格式要求与填写说明 |
|---|---|---|---|---|
| 基础标识 | 资产ID (Asset ID)* | 是 | asset.id | 工作区内全局唯一标识。推荐带概念前缀（如 svc:order-gateway、db:settle-oracle-rac、host:db-node-01）。必须匹配 ^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$，斜杠及其他破坏 URL 的特殊字符会被拒绝。 |
| 概念类型 (Concept)* | 是 | asset.concept_name | 对应 17 种标准本体概念之一（如 Application, Service, Host, Database, VirtualIP 等）。 | |
| 资产名称 (Name)* | 是 | asset.name | 人类易读的标准名称（如 订单处理微服务、结算核心 Oracle 19c RAC）。 | |
| 别名列表 (Aliases) | 否 | asset.aliases | 英文逗号分隔的别名、简称或历史代码，供模糊匹配消解（如 order-gw, order-api）。 | |
| 部署环境 (Environment)* | 是 | asset.environment | 环境标识：prod（生产）、staging（预发）、test（测试）、dev（开发）。 | |
| 生命周期状态 (Status)* | 是 | asset.status | 状态值：active（在役）、inactive（停用）、decommissioned（下线）、maintenance（维护中）。 | |
| 关键技术属性(自动拼入 attributes) | IP地址 (IP Address) | 否 | attributes.ip 或 management_ip | 物理管理 IP、虚 IP 或实例服务 IP（如 10.10.1.11）。 |
| 服务端口 (Port) | 否 | attributes.port | 监听端口（如 1521, 3306, 8080）。 | |
| 技术引擎/类型 (Engine/Type) | 否 | attributes.engine / lb_type / mq_type | 软件或中间件类型（如 oracle, tidb, spring-boot, kafka, f5, linux）。 | |
| 架构模式/角色 (Architecture/Role) | 否 | attributes.db_mode / role | 架构模式或节点角色（如 cluster, distributed, single, primary_standby, rac, worker, gateway）。 | |
| 版本号 (Version) | 否 | attributes.version | 软件或系统版本（如 19.21.0.0, 7.5.0, 2.4.0）。 | |
| 机房/可用区/机架 (Zone/Rack) | 否 | attributes.zone, rack | 物理位置标识（如 zone-a, rack-02）。 | |
| 管理治理标签(自动拼入 labels) | 责任人/团队 (Owner Team)* | 是 | labels.owner_team | 负责该组件的运维、DBA 或研发团队名称（如 order-dev, billing-dba, infra-ops）。 |
| 保障等级 (Tier)* | 是 | labels.tier | 业务重要程度评级（P0, P1, P2, P3）。 | |
| 值班/Oncall人员 (Oncall) | 否 | labels.oncall | 紧急应急联系人或值班账号（如 order-lead, dba-lead）。 | |
| 业务线/部门 (Department) | 否 | labels.department | 组织架构归属（如 电商核心研发部, 金融数据部）。 | |
| 拓扑与依赖关联(自动生成 Relations) | 归属应用系统 (Belongs To App) | 否 | contains 边 | 所属顶层业务应用 ID（如 app:mall-core），智能体自动建立包含关系。 |
| 运行宿主节点 (Runs On Host/Pod) | 否 | runs_on 边 | 承载该实例运行的主机或集群 ID（如 host:k8s-worker-01）。 | |
| 直接依赖组件 (Depends On) | 否 | depends_on 边 | 下游强依赖的服务或数据库 ID，多个逗号分隔（如 db:settle-oracle-rac, mq:event-kafka）。 | |
| 补充扩展 | 补充扩展属性 (Other Attributes) | 否 | attributes 补充 | 选填，仅用于冷门专属字段，支持 key=value 格式（如 credential_ref=swissql://order-pg-primary?server=svc:order-swissql 或 vault://db/oracle-rac）。 |
2. 完整示例数据行
客户只需在表格中按列清晰填入常规值：
| 资产ID* | 概念类型* | 资产名称* | 别名列表 | 环境* | 状态* | IP地址 | 端口 | 技术引擎/类型 | 架构模式/角色 | 版本号 | 机房/可用区 | 责任团队* | 保障等级* | Oncall人员 | 业务线/部门 | 归属应用 | 运行宿主 | 依赖组件 | 补充扩展属性 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
svc:order-gateway | Service | 订单微服务网关 | order-gw, order-api | prod | active | 10.10.1.11 | 8080 | spring-boot | gateway | 2.4.0 | zone-a | order-dev | P0 | order-lead | 电商核心研发部 | app:mall-core | host:k8s-worker-01 | db:settle-oracle-rac, mq:event-kafka | codebase_repo=git@github.com:mall/order-gateway.git |
db:settle-oracle-rac | Database | 结算核心 Oracle 19c RAC | settle-db, orcl-rac | prod | active | 10.10.2.100 | 1521 | oracle | rac | 19.21.0.0 | zone-a | billing-dba | P0 | dba-lead | 金融数据部 | app:mall-core | credential_ref=vault://db/oracle-rac | ||
host:db-node-01 | Host | rac-db-server-01 | rac-node-1, 10.10.2.11 | prod | active | 10.10.2.11 | linux | worker | RHEL 8.8 | zone-a / rack-02 | infra-ops | P0 | sre-lead | 基础架构运维部 | net_dev:tor-switch-a | model=Dell-PowerEdge-R750 |
二、 拓扑关系表（Relations Sheet - 可选扩展）
当需要描述复杂网络分发（routes_to）、主从数据复制（replicates_to）或控制面管理（manages）等多跳精细图拓扑时，可在该表中增加有向边：
| 源资产ID (Subject ID)* | 关系谓词 (Predicate)* | 目标资产ID (Object ID)* | 关系说明 (Description) |
|---|---|---|---|
dns:mall.company.com | routes_to | vip:f5-wan-vip | 系统公网主域名解析到外网 F5 VIP |
vip:f5-wan-vip | routes_to | lb:f5-hardware-slb | 外网浮动 VIP 终结在硬件负载均衡器 |
lb:f5-hardware-slb | routes_to | svc:order-gateway | 负载均衡反向代理流量分发到后端微服务网关 |
vip:scan-ip | routes_to | db_instance:rac-node1 | Oracle SCAN VIP 接入路由至节点 1 实例 |
db_instance:rac-node1 | replicates_to | db_instance:rac-node2 | 双机私网高速 Cache Fusion 内存块同步镜像 |
三、 数据导入与使用方式
填写完成的标准 Excel / CSV 台账表格，可通过以下途径导入至 Mopheus 知识图谱：
- AI 智能体直接对话解析（推荐）：
在工单或任务聊天中直接发送台账文件或复制表格内容，智能体（内置
mopheus-assets技能）将自动完成表头映射、概念消解、严格模式校验，并生成带有完整技术属性、治理标签与拓扑边的声明式清单执行入库。 - 声明式清单导入（CLI）：
技术人员可使用
mop asset apply -f <manifest.yaml>批量应用资产清单。SSH 账号应放在权限为0600的独立凭据文件中，通过--credentials-file传入；不要将 SSH 密钥或密码放进资产属性。有关详细 Schema 定义，请参阅 本体规范与 Schema 参考。
四、 智能体自动编译效果（Manifest YAML）
智能体阅读上述平铺表格后，自动识别分类并组装为符合强类型规范的 AssetManifest YAML：
version: v1
kind: AssetManifest
metadata:
workspace: ecommerce-prod
environment: prod
assets:
- id: svc:order-gateway
concept: Service
name: 订单微服务网关
aliases:
- order-gw
- order-api
status: active
environment: prod
attributes:
ip: 10.10.1.11
port: 8080
engine: spring-boot
role: gateway
version: 2.4.0
zone: zone-a
codebase_repo: git@github.com:mall/order-gateway.git
labels:
owner_team: order-dev
tier: P0
oncall: order-lead
department: 电商核心研发部
- id: db:settle-oracle-rac
concept: Database
name: 结算核心 Oracle 19c RAC
aliases:
- settle-db
- orcl-rac
status: active
environment: prod
attributes:
ip: 10.10.2.100
port: 1521
engine: oracle
db_mode: rac
version: 19.21.0.0
zone: zone-a
credential_ref: vault://db/oracle-rac
labels:
owner_team: billing-dba
tier: P0
oncall: dba-lead
department: 金融数据部
relations:
- subject: app:mall-core
predicate: contains
object: svc:order-gateway
- subject: svc:order-gateway
predicate: runs_on
object: host:k8s-worker-01
- subject: svc:order-gateway
predicate: depends_on
object: db:settle-oracle-rac
- subject: svc:order-gateway
predicate: depends_on
object: mq:event-kafka