用途:在阿里云上管理 AIRec(推荐引擎)资源,适用于需要执行推荐引擎资源操作、查询或配置变更的场景。
主要能力:通过阿里云 OpenAPI(RPC)配合官方 SDK 或 OpenAPI Explorer 调用接口。产品代码为 Airec,默认 API 版本 2020-11-26。常见操作模式包括:查询/列举资源优先使用 List* / Describe* 接口;变更配置优先使用 Create* / Update* / Modify* / Set* 接口;状态诊断优先使用 Get* / Query* / Describe*Status 接口。
使用方式:先确认地域、资源标识与目标操作,再通过 OpenAPI 元数据接口发现 API 列表与所需参数,随后用 SDK 或 OpenAPI Explorer 调用,最后用 describe/list 接口验证结果。凭证优先级:环境变量 ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID,其次为共享配置文件 ~/.alibabacloud/credentials。ALICLOUD_REGION_ID 为可选默认值,未设置时需判断合理地域,不明确时应询问用户。
快速开始:先做元数据发现再调用业务 API,可运行 python scripts/list_openapi_meta_apis.py,支持 --product-code 与 --version 覆盖参数,脚本将 API 清单写入技能输出目录。
输出与验证:产物、命令输出与 API 响应摘要保存到 output/alicloud-ai-recommend-airec/,证据文件需包含地域、资源 ID、时间范围等关键参数。验证命令为 mkdir -p output/alicloud-ai-recommend-airec 后对 scripts/*.py 执行 python3 -m py_compile,通过标准为退出码 0 且生成 validate.txt。
限制:执行前须配置最小权限的阿里云凭证;地域不明确时,执行变更类操作前应先询问用户。具体接口清单与参数以 references/sources.md 为准。