oclaw/runtime/skills/aiops-telecom/SKILL.md
oliver 6cfaff06f6 Refactor media payload handling to persist base64 blobs as attachment refs and keep non-turn model paths safe by degrading risky payloads.
This preserves multimodal fidelity for the latest user turn while preventing historical/tool replay bloat, and adds admin UI support for referenced attachment preview/download flows.

Made-with: Cursor
2026-04-28 10:30:27 +08:00

6.1 KiB
Raw Blame History

AIOps-电信数通智能运维技能包

概述

面向电信/数通网络的 AI 智能运维技能包。支持告警日志智能分析、配置错漏检查、故障模式学习与根因推荐。适用于华为、中兴、Cisco、Juniper 等主流数通设备。

能力说明

1. 告警日志智能分析

1.1 输入格式支持

  • Excel/CSV 格式的告警清单(如网管导出的告警报表)
  • 纯文本格式的 syslog/告警日志
  • 设备 CLI 输出的告警信息

1.2 分析维度

维度 说明
告警分级统计 Critical / Major / Warning 级别分布及占比
设备维度聚合 按设备(ME/NE)统计告警数量 Top N
告警类型归类 物理层/链路层/网络层/路由层/安全层分类
时间维度分析 告警爆发时间窗口、频次趋势
关联分析 同设备/同链路的多层告警关联,推测根因
影响评估 评估受影响业务(L3VPN/Tunnel/Ethernet)范围

1.3 告警类型知识库

物理层告警
告警名称 级别 含义 常见根因 推荐操作
Ethernet Physical LOS Critical 光口信号丢失 光纤断/松、光模块故障、对端设备断电 检查光纤链路、光功率、更换光模块
Ethernet Physical Laser Temperature Major 激光器温度越限 光模块老化、设备散热不良、环境温度过高 检查设备风扇/温度、更换光模块
Ethernet Physical Input Optical Power Major 接收光功率越限 光纤衰减过大、接口脏污、对端发光异常 清洁光纤接头、检查光功率预算
Ethernet Physical CRC Error Major CRC 误码越限 光纤质量差、接头污染、电磁干扰 清洁光纤、检查物理链路、更换尾纤
SmartGroup RX CRC Error Major 聚合口 CRC 误码 聚合成员链路质量问题 排查各成员链路、更换问题链路
路由/MPLS层告警
告警名称 级别 含义 常见根因 推荐操作
OSPF Neighbor Down Major OSPF 邻居中断 物理链路故障、Hello 超时、配置不匹配 检查邻居间链路、验证 OSPF 配置参数
RSVP LSP BFD Session Down Major MPLS TE隧道 BFD 检测失败 隧道途经链路故障、节点故障 检查隧道路径、确认中间节点状态
BGP Peer Flap Major BGP 邻居震荡 链路不稳、Keepalive 超时、策略变更 检查 BGP 配置、链路稳定性
安全/控制面告警
告警名称 级别 含义 常见根因 推荐操作
CPSBP 超阈值 Warning 控制面报文速率超阈值 攻击流量、广播风暴、配置过低 分析流量源、调整 CP 保护阈值
ARP IP冲突 Warning 检测到 IP 地址冲突 私接设备、IP 配置错误 定位冲突源、释放/更改 IP 地址

2. 配置错漏检查

2.1 支持检查项

检查类别 典型检查项
接口配置 VLAN 配置一致性、MTU 匹配、描述规范、端口模式(access/trunk)
路由协议 OSPF area 一致性、BGP AS 号核对、Route-map 逻辑、邻居配置完整性
MPLS/TE LSP 配置完整性、隧道保护策略、FRR 配置
安全策略 ACL 规则匹配、控制面保护(CoPP)、端口安全、MAC 漂移检测
高可用 VRRP/HSRP 配置一致性、BFD 联动、链路聚合(LACP)配置
QoS 队列策略、带宽限制、优先级映射

2.2 分析模式

  • 配置比对:新旧配置 diff,快速定位变更点
  • 合规检查:基于标准模板检查配置是否符合规范
  • 逻辑验证:检查配置逻辑矛盾(如 ACL 冗余/冲突、路由黑洞)

3. 故障模式学习 (self-learning)

系统会记录每次分析过程中的:

  • 告警 → 修复措施 对应关系
  • 配置错误 → 正确配置 修正方案
  • 经用户确认的根因分析结论

这些 learnings 会存入 .learnings/ 目录,在后续分析中自动参考,越用越准确。

使用示例

示例1:告警日志分析

用户: "分析这份告警日志"
助手: 按以下格式输出分析报告:

📊 告警概览
- 总告警数:24条
- Critical:2条 (8.3%) ⛔
- Major:9条 (37.5%) ⚠️
- Warning:13条 (54.2%) ⚡

🔴 Critical 告警详情
1. [SMD-LIIR-EN1-Z20HS] ETPI LOS → 物理光口信号丢失
   → 该设备下联 SMD-SBRS-EN1-Z20HS,状态 Unack
   → 建议:立即检查光纤/光模块

🟠 Major 告警详情
1. [BKL-UNB-AN1-ZM3SP] 光功率越限 → 接收光功率过低
2. [MDN-PMKN-EN1-Z20HS] 激光器温度越限
3. [PAD-KBU-AN1-ZM8S] CRC误码越限(物理口+聚合口)
4. RSVP LSP BFD Session Down ×3条
5. OSPF邻居中断 ×2条

🔄 关联分析发现
- PBR-RPKU 与 PBR-PYSK 之间:OSPF邻居中断 + CPSBP告警
  → 推测该链路存在物理层问题
- GRO 站点多条 RSVP LSP BFD Down
  → 可能为 GRO 节点设备问题或出局光缆中断

💡 根因推荐
1. 优先处理 SMD-LIIR-EN1-Z20HS 的 LOS(Critical)
2. 检查 PBR-RPKU ↔ PBR-PYSK 链路光功率和光模块
3. 排查 GRO 站点汇聚设备状态

示例2:配置检查

用户: "帮我检查这两份配置文件"
助手: 
🔍 配置检查报告
1. OSPF 配置检查 ✅
   - Area 一致性:匹配
   - Hello/Dead 间隔:一致
   - 网络类型:一致

2. 接口配置检查 ⚠️
   - [GE0/0/1] MTU 不匹配:本端 1500,对端 9000
   - [GE0/0/2] 描述缺失

3. BGP 配置检查 ❌
   - AS 号不匹配:本端 AS65001,对端 AS65002

数据来源说明

本技能的知识库基于以下标准构建:

  • 华为 NE40E/ME60 系列告警手册
  • 中兴 ZXR10 系列告警与配置规范
  • 3GPP 管理面标准(IRP/Solution)
  • ITU-T 光传输标准
  • RFC 相关协议标准

局限性与注意事项

  • 本技能不直接连接设备执行命令,不做配置变更操作
  • 分析结果基于提供的日志/配置数据,用户需确认数据准确性
  • 推荐操作为参考建议,重大操作需人工复核