SuperAPI AI 工具集

byted-volcengine-topology-analyzer

数据与分析

查看项目

更新于 10-15 17:30

技能介绍

用途:消费已有业务拓扑数据,回答资源影响面、上下游链路、业务归属和变更波及范围问题,例如某安全组放开端口会影响哪些应用、某入口 IP 背后挂了什么资源。

主要能力:定位目标节点(资源 ID、IP、名称);基于结构化拓扑推断直接关联资源、受影响 ECS 和入口链路;根据变更描述生成风险摘要与校验建议;多候选场景先给出排序再确认。

输入前提:默认消费 business_topologies/ 目录下 / 业务的 topology.json 与 topology.md,关系语义含 attached_to、has、contains、belongs_to。未指定 --root 时脚本自动在该目录发现数据。

使用方式:优先用脚本获取结构化结果,例如: python3 <byted-volcengine-topology-analyzer-skill>/scripts/analyze_topology.py --node "<node-id-or-keyword>" --output json 已知业务时加 --business,给出变更描述时加 --change。返回多个匹配时看 match_score 与 match_reasons,id:exact、public_ip:exact 等高置信命中可优先采用,模糊命中需用户确认。必要时补读 topology.md 做口语化解释。

限制:仅基于静态拓扑做推断,不代表运行时状态或健康情况;数据中未必显式存应用名,不得虚构业务系统名、服务名、域名;变更风险为启发式推断;脚本查不到节点时应明确说明无命中,仅定位到基础设施层时不要硬编入口链路。