用途
本技能引导智能体完成阿里云 NIS（网络智能服务）的网络可达性分析，用于诊断云上资源之间、以及云上与云下环境之间的网络路径连通性。适用于排查源端到目的端是否可达、定位阻断原因等网络诊断场景。
主要能力
- 正向与反向路径分析：先对源端到目的端执行正向分析，再交换源端与目的端执行反向分析，以确认双向连通性。
- 阻断点定位：当路径不可达时，从返回结果中分析 errorCode（根因错误码）、securityGroupData（安全组拦截规则）、routeData（路由表丢包条目）。
- 拓扑可视化：基于主动发起任务返回的 topologyData.positive，从 nodeList 提取节点、从 linkList 构建有向边，生成 Mermaid 拓扑图。
- 途经资源监控诊断：对拓扑中匹配特定前缀的资源 ID 查询最近 1 小时云监控数据，包括 ecs-（acs_ecs_dashboard）、eip-（acs_vpc_eip）、nat-（acs_nat_gateway）、clb-（acs_slb_dashboard）、vbr-（acs_physical_connection）等命名空间下的相关指标。
使用方式
- 环境准备：需阿里云 CLI 3.3.1 及以上版本，运行
aliyun version校验；随后执行aliyun configure set --auto-plugin-install true启用插件自动安装。 - 凭证配置：使用
aliyun configure list --user-agent AlibabaCloud-Agent-Skills检查凭证状态，需存在有效 profile（AK、STS 或 OAuth 身份）。凭证须在本会话之外配置，技能禁止读取、回显或打印 AK/SK，禁止在会话或命令行中直接输入凭证，禁止使用字面量凭证值执行配置命令。 - RAM 权限：需要 nis:CreateAndAnalyzeNetworkPath、nis:GetNetworkReachableAnalysis、cms:DescribeMetricData 等操作权限。
- 参数收集：执行前须与用户确认所有可自定义参数，包括 RegionId、源端与目的端类型及 ID、协议、端口、云下私网 IP 等，不得未经确认使用默认值。源端类型支持 ecs、vsw、internetIp、vpn、vbr；目的端类型另支持 clb。internetIp 直接填写公网 IP 作为 ID；vpn/vbr 场景须提供云下私网 IP。
- 执行分析：调用
aliyun nis create-and-analyze-network-path发起分析，记录返回的 NetworkReachableAnalysisId，并通过aliyun nis get-network-reachable-analysis轮询直至状态为 finish。 - 结果解读：始终使用主动发起任务返回的 topologyData.positive，忽略响应中的 topologyData.reverse。
反向路径的端口处理规则：反向 --source-port 取正向的 TargetPort（服务端监听端口），反向 --target-port 取 49152~65535 范围内的随机临时端口，以模拟真实回程流量。若协议为 icmp，则省略 --target-port；若源/目的类型不是 vpn 或 vbr，可省略 --source-ip-address / --target-ip-address。
适用场景
- 云上 ECS、交换机、CLB 等资源之间的连通性排查。
- 公网 IP 路径分析。
- 通过 VPN 或 VBR 连接云下环境的混合云路径诊断。
- 路径不可达时结合安全组、路由表与监控数据综合定位问题。
限制
- 仅支持 IPv4，不支持 IPv6 路径分析。
- 单向分析：每次分析为单向，反向路径需另建任务并交换源/目的参数。
- 只读操作：仅允许分析任务创建与查询、监控数据查询及 Describe* 类查询 API；禁止 Create*（除 CreateAndAnalyzeNetworkPath 外）、Modify*、Delete*、Start*、Stop*、Run* 等 API。
- CMS 配额：DescribeMetricData 与其他 CMS 查询 API 共享每月 1,000,000 次免费调用额度。
- CMS 频控：每账号（含 RAM 用户）每秒 10 次调用。
- 无清理需求：由于为只读操作，不创建或修改云资源，无需清理。
参考文件
技能包含以下参考文件：references/ram-policies.md（所需 RAM 权限策略）、references/verification-method.md（逐步验证命令）、references/acceptance-criteria.md（正确/错误 CLI 模式对照）、references/cli-installation-guide.md（阿里云 CLI 安装指南）。
本技能支持中英文双语响应，按用户使用的语言选择对应提示词。