mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-16 03:10:47 +08:00
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
This commit is contained in:
parent
3d27a01879
commit
6cfaff06f6
20 changed files with 1626 additions and 101 deletions
144
runtime/skills/aiops-telecom/SKILL.md
Normal file
144
runtime/skills/aiops-telecom/SKILL.md
Normal file
|
|
@ -0,0 +1,144 @@
|
|||
# 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 相关协议标准
|
||||
|
||||
## 局限性与注意事项
|
||||
- 本技能不直接连接设备执行命令,不做配置变更操作
|
||||
- 分析结果基于提供的日志/配置数据,用户需确认数据准确性
|
||||
- 推荐操作为参考建议,重大操作需人工复核
|
||||
Loading…
Add table
Add a link
Reference in a new issue