用途:这是一个 Azure OpenAI 容量发现技能,用于回答“gpt-4o 可以在哪里部署”“哪个区域有足够容量”等问题。它扫描用户可访问的所有区域与项目,找出满足容量目标的部署位置,并输出排序后的区域/项目表格。适用于指定容量目标、比较区域可用性、遇到配额错误需寻找替代位置、以及挑选部署模型的最佳区域和项目等场景。
主要能力:覆盖所有可访问区域与项目;基于模型、版本与最小容量目标进行发现;输出按“是否达标→项目数量→可用容量”排序的表格;结合订阅配额校验哪些区域真正可部署。该技能为只读分析,不会执行部署,发现完成后转交 preset(快速部署)或 customize(自定义部署)。
使用方式:需通过 Azure CLI 认证(az login)。先用 az account show --query "{Subscription:name, SubscriptionId:id}" --output table 校验前置条件;从提示中提取模型名,版本未知时用 scripts/query_capacity.ps1 -ModelName <model-name> 或 ./scripts/query_capacity.sh <model-name> 查询可用版本(默认用最新版);再运行完整发现脚本,PowerShell 为 .\scripts\discover_and_rank.ps1 -ModelName <model-name> -ModelVersion <version> -MinCapacity <target>,Bash 为 ./scripts/discover_and_rank.sh <model-name> <version> <min-capacity>。脚本自动查询所有区域容量并与已有项目交叉比对。随后用 az cognitiveservices usage list --location <region> --subscription $SUBSCRIPTION_ID -o json 校验订阅配额,配额名形如 OpenAI.<SKU>.<model-name>,可用量为 limit 减去 currentValue,配额为 0 的区域标记不可用。
限制与错误处理:模型不可用或全部达配额时报“No capacity found”,应转交 quota 技能申请提升;脚本认证失败需重新 az login;版本列表为空说明该区域目录无此模型,可换区域重试;无项目时转向 project/create 技能或 Azure Portal。部署前须与用户确认目标项目。容量数据反映平台支持能力,实际能否部署受订阅配额限制。详情以官方资料为准。