核心用法
本Skill提供对阿里云AIRec（智能推荐引擎）的完整OpenAPI管理能力，采用RPC风格API与官方SDK交互。核心工作流程遵循"确认环境→发现API→执行调用→验证结果"四步法：首先通过环境变量ALICLOUD_ACCESS_KEY_ID/ALICLOUD_ACCESS_KEY_SECRET完成认证，优先级高于共享配置文件；随后使用scripts/list_openapi_meta_apis.py脚本进行元数据发现，获取API清单与参数模式；最终按高频模式执行操作——List/Describe类用于资源盘点，Create/Update/Modify类用于配置变更，Get/Query/DescribeStatus类用于诊断排查。
显著优点
- 官方SDK保障：基于阿里云官方OpenAPI与SDK，接口稳定性与长期兼容性可靠
- 元数据驱动：内置API发现脚本，自动获取产品代码
Airec及版本2020-11-26的最新接口定义 - 安全优先：强制遵循AccessKey环境变量优先级，降低凭证泄露风险
- 输出规范化：所有产物统一写入
output/alicloud-ai-recommend-airec/，便于审计与追溯
潜在局限
- 区域依赖：
ALICLOUD_REGION_ID为可选配置，未设置时需手动推断或询问用户，增加交互成本 - 产品聚焦：仅覆盖AIRec单一产品，跨产品编排需额外开发
- SDK依赖：需预装阿里云Python SDK，环境准备成本较高
适合人群
- 阿里云AIRec运维工程师、SRE团队
- 需要自动化推荐引擎配置的DevOps开发者
- 云上AI服务资源治理的合规审计人员
常规风险
- 凭证管理：AccessKey若硬编码于脚本存在泄露风险，务必使用环境变量或凭证文件
- 误操作影响：Update/Modify类API可能直接影响线上推荐服务，建议先在非生产环境验证
- API版本漂移：默认锁定
2020-11-26版本，需关注官方弃用公告及时升级