| 项目 | 内容 |
|---|---|
| 英文全称 | Competency Questions(本体工程标准术语;文档中亦写作 Capability Questions) |
| 中文名称 | 能力问题 |
| 一句话 | 智能体在这个场景里必须能回答的问题,用来验收本体是否够用。 |
| 举例 | CQ-01:给定告警 ID,它挂在哪个 CI 上? CQ-04:过去 24h 该服务链路上有哪些变更? |
| 谁定 | 客户业务方 + SRE 在工作坊签字确认(教辅-02) |
| 和评测的关系 | 每条必要 CQ → 至少 1 条评测 case;考不过 = 本体/映射/协议有缺口 |
出处:docs/teaching-kit/教辅-02-工作坊模板与能力问题.md · 华东金融云样例 CQ-01~CQ-10。
flowchart TB SCENE[先定场景
如:故障根因 / 资产问数] CQ[列出能力问题 CQ
智能体必须能答什么] STORY[画一条真实故事
ALERT-991 证据链] NEED[反推需要什么] CLASS[类 · 关系 · 属性] RULE[办事规程] PACK[写入 Pack 本体构建] SCENE --> CQ --> STORY --> NEED NEED --> CLASS NEED --> RULE CLASS --> PACK RULE --> PACK
以 docs/planning/产品编码启动计划-2026-06-23.md §四 与 consulting-kit/00-咨询交付包总导航.md 为准:
| 编号 | 场景 | 用户典型问法 | 智能体 | 咨询样例 |
|---|---|---|---|---|
| S1 | 告警详情查询 | 「ALERT-991 什么情况?」 | 告警查询 | 场景 A 入口 |
| S2 | 故障根因分析 | 「是不是跟昨晚变更有关?」 | 支付网关根因分析 | 场景 A 主路径 |
| S3 | 配置项/业务影响面 | 「pay-gw-03 影响哪些业务?」 | 影响面查询 | 场景 A 扩展 / CQ-06 |
| 场景 B | 资产与依赖问数 | 「支付网关用了哪些资源?拓扑?」 | 资产与依赖查询 | 场景 B(与 S2/S3 共用本体) |
| 编号 | 场景 | 用户典型问法 | 备注 |
|---|---|---|---|
| S4 | 指标查询 | 「支付成功率 P99 最近 1 小时」 | 需 Prometheus;映射 Elastic 未完成会卡评测 |
| S5 | 日志查询 | 「网关过去 15 分钟错误日志」 | 需 Elastic/Loki;本体主要用 Event + 现场查 |
| S6 | 按业务查关联全景 | 「在线支付关联哪些 CI 和近期告警」 | 图谱多跳;复用现有类 |
S7 定时巡检 · S8 变更评审 · S9 告警自动分诊 · S10 受控处置
| 语义四层 | 类(22 类代表) | S1 告警 | S2 根因 | S3 影响面 | 场景 B 问数 | P1 指标/日志 |
|---|---|---|---|---|---|---|
| 结构层 资源/部署物 | Pod, Node, LB, DB, NetworkDevice, ConfigurationItem | ● | ● | ● | ●● | ○ |
| 结构层 | Location, Team | ○ | ○ | ○ | ○ | ○ |
| 功能层 服务怎么看 | TechnicalService, BusinessService | ● | ●● | ●● | ●● | ○ |
| 功能层 | Application | ○ | ○ | ○ | ○ | ○ |
| 动态层 发生了什么 | Alert | ●● | ●● | ○ | ○ | ○ |
| 动态层 | Metric | ○ | ● | ○ | ○ | ●● S4 |
| 动态层 | Event, Incident, Problem | ○ | ○ | ○ | ○ | ● S5 |
| 规程层 怎么合法地做 | ChangeRequest | ○ | ●● | ○ | ○ | ○ |
| 规程层 | RemediationAction, MaintenanceWindow, Runbook | ○ | ● | ○ | ○ | ○ |
| 规程层 | 办事规程 R01~R05 | ○ | ●● | ○ | ○ | ○ |
图例:● 主用 · ●● 核心 · ○ 可选/后期
Incident、Problem 等类为工单扩展预留,P0 可不灌实例;Team 可合并为属性。
| 步 | 叫什么 | 干什么 | 存哪 |
|---|---|---|---|
| ① | 本体模型 TBox | 类、属性、关系、办事规程(咨询工作坊产出) | Pack 配置 |
| ② | 映射与归一 | 字段映射 + 归一词典 + 连接器规则(接哪些系统、怎么取字段) | Pack 配置 + 管理端「业务系统连接」 |
| ③ | 图谱实例 ABox | 运行结果:ETL/Webhook 把真实对象写入 Neo4j(非手工在本体里逐条录入) | Neo4j |
| ③½ | AI 接口适配助手 | 可选:无完整 OpenAPI 时对话生成工具草稿 | 辅助写入④ |
| ④ | 可调用工具 | 声明 tool_id、参数 schema、关联连接器(办事动作清单) | Pack tools |
| ⑤ | 智能体编排 + 评测发布 | 每步从④绑定可调用工具;评测通过后值班员可用 | Pack protocols + 运行时 |
③ 不是「又做一遍对接」。对接配置在②(规则)+ 管理端连接器(地址密钥);③ 是同步跑完以后在「图谱实例」页验收:pay-gw-03、ALERT-991 是否已入图。
flowchart LR S1[① 本体模型 TBox] S2[② 映射与归一] S3[③ 图谱实例 ABox] S35[③½ AI适配助手
可选] S4[④ 可调用工具] S5[⑤ 编排+评测] S6[连接器持续同步] S1 --> S2 --> S3 S2 --> S6 --> S3 S3 --> S35 --> S4 --> S5 style S3 fill:#e3f2fd style S35 fill:#f3e5f5 style S4 fill:#e8f5e9 style S5 fill:#fff3e0
| 阶段 | 完成了什么 | 还没完成什么 |
|---|---|---|
| ① 本体 | 类/属性/关系/规程定义 | — |
| ② 映射+归一 | 数据源、字段规则、身份对照、连接器配置 | 映射 100%、新源持续维护 |
| ③ 图谱实例 | 场景子图写入 Neo4j(如 15 节点) | 全公司 CI 不会一次入图;需持续 ETL |
| ④ 可调用工具 | — | 声明 get_alert、trace_ci 等;关联连接器 handler |
| ⑤ 编排+评测 | — | 诊断步骤绑定可调用工具、评测通过、发布 |
所以:③ 是「数据能支撑场景查询」的里程碑,不是 Pack 交付终点。咨询验收通常按「场景 A/B 智能体考过 + 图谱可查」一起签。
| CMDB 常见做法 | EASH 本体类梳理 | |
|---|---|---|
| 分类视角 | 按物理/组织世界分:基础设施 → 网络设备 → 交换机 → 路由器… | 按智能体场景证据链分:告警要能追到谁、服务、变更、规程 |
| 起点 | 「公司有哪些资产类型?」 | 「这个场景要回答哪些能力问题 CQ?」 |
| 树有多深 | 常 3~5 层 CI 类型树 | 四层语义 + 结构层仅 1 层父类(ConfigurationItem),不建深树 |
| 验收 | 台账覆盖率、字段完整率 | 每条必要 CQ 在图上有路径;评测 case 通过 |
flowchart TB
subgraph CMDB["CMDB · 按管理对象 / 物理世界"]
direction TB
R[根]
R --> I[基础设施]
R --> A[应用软件]
R --> B[业务系统]
I --> N[网络设备]
N --> SW[交换机]
N --> RT[路由器]
end
subgraph EASH["EASH 本体 · 按场景证据链 + 四层"]
direction LR
CQ[能力问题 CQ
告警根因? 影响面?]
CQ --> ST[结构层
Pod Node LB…]
CQ --> FN[功能层
技术服务 业务服务]
CQ --> DY[动态层
Alert 变更单]
CQ --> RG[规程层
办事规程 Runbook]
ST --- FN --- DY --- RG
end
| 四层 | 回答的问题 | 和你说的「办成事」的对应 | 典型类 |
|---|---|---|---|
| 结构层 | 有哪些资源/部署物? | 办事链路上涉及的「东西」 | Pod, Node, LB, DB, 交换机 |
| 功能层 | 业务/运维怎么看服务? | 影响面、支撑关系落在哪 | 技术服务, 业务服务 |
| 动态层 | 发生了什么? | 告警、指标、工单等时序信号 | Alert, Metric, Incident |
| 规程层 | 怎么合法地做? | 智能体建议能不能执行、变更是否合规 | ChangeRequest, Runbook, R01~R05 |
所以:四层不是 CMDB 的「基础设施/应用/人员」分类,而是智能体办事时需要的四类语义——既有「资源」(结构层),也有「发生了什么」(动态层)和「怎么做才合法」(规程层)。
出处:docs/teaching-kit/教辅-04 类清单「层级」列 · docs/marketing/agentic-aiops-benti-zhishitupu-luodi.md · ops-pack 模板 packs/ops/
ConfigurationItem 收拢 Pod/Node/LB…(相当于 CMDB 的「配置项」抽象)。不做「网络设备 → 交换机 → 核心交换机」这种深树。| 层级类型 | 例子 | 深度 |
|---|---|---|
| 语义四层 | 结构 / 功能 / 动态 / 规程 | 固定 4 层(横向分类) |
| 父类继承 | ConfigurationItem ← Pod, Node, LB… | 通常 1 层父类 |
| CMDB 式深树 | 基础设施→网络→交换机→型号 | 不采用;型号等放属性 |
路由器 vs 交换机:在本体是同一个类 NetworkDevice,用属性 device_role 区分,而不是再建 RouterClass / SwitchClass 两级子类——除非场景 CQ 明确要区分且智能体要分别遍历。
flowchart LR
CQ[能力问题 CQ] --> STORY[故障故事白板]
STORY --> CLASS[类便签 15-22个]
STORY --> REL[关系便签 20+]
CLASS --> LAYER[标四层]
CLASS --> MAP[映射草稿]
REL --> MAP
LAYER --> PACK[导入 Pack / 本体构建]
MAP --> PACK
产出物对齐:teaching-kit/教辅-02 工作坊 · 教辅-04 22 类清单 · consulting-kit 华东金融云样例。
| 块 | 问什么 | 产出 |
|---|---|---|
| ① 对象(类) | 告警挂在什么上?影响业务落到哪层对象? | Pod、Alert、TechnicalService… |
| ② 链接(关系) | Pod 和 Node?服务与业务?变更动了谁? | runs_on、supports、targets… |
| ③ 属性 | 做根因必须有哪几个字段? | severity、is_critical、status… |
| ④ 逻辑(规程) | 什么条件必须 CAB?能否建议重启? | R01~R05 |
| ⑤ 动作 | 智能体允许哪些只读工具? | get_alert、trace_ci… |
| ⑥ 事件 | 告警和工单怎么关联? | Incident、related_to… |