关于 aliyun-aicontent-generate
用于通过 Alibaba Cloud OpenAPI 管理 AIContent 资源的技能,面向执行资源查询、配置和状态排查的用户。它先发现 API 元数据,再调用接口并验证结果。
主要功能
- 01发现 API 列表与参数
- 02查询和盘点资源
- 03创建或修改资源
- 04检查状态并验证结果
- 05保存输出与操作证据
适用场景
- 01查看 AIContent 资源清单
- 02调整资源配置
- 03排查资源状态
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill aliyun-aicontent-generate安装后在 Claude Code 中输入/aliyun-aicontent-generate确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/sources.mdscripts/list_openapi_meta_apis.py详细介绍
Category: service
AIContent
使用 Alibaba Cloud OpenAPI(RPC)和官方 SDK 或 OpenAPI Explorer 管理 AIContent 资源。
工作流
- 确认地域、资源标识符和所需操作。
- 查找 API 列表及必需参数(参见参考资料)。
- 使用 SDK 或 OpenAPI Explorer 调用 API。
- 使用 describe/list API 验证结果。
AccessKey 优先级(必须遵循)
- 环境变量:
ALIBABACLOUD_ACCESS_KEY_ID/ALIBABACLOUD_ACCESS_KEY_SECRET/ALIBABACLOUD_REGION_ID地域策略:ALIBABACLOUD_REGION_ID是可选的默认值。如果未设置,请为任务选择最合理的地域;如果无法确定,请询问用户。 - 共享配置文件:
~/.alibabacloud/credentials
API 发现
- 产品代码:
AiContent - 默认 API 版本:
20240611 - 使用 OpenAPI 元数据端点列出 API 并获取架构(参见参考资料)。
高频操作模式
- 盘点/列表:优先使用
List*/Describe*API 获取当前资源。 - 更改/配置:优先使用
Create*/Update*/Modify*/Set*API 进行变更。 - 状态/故障排查:优先使用
Get*/Query*/Describe*StatusAPI 进行诊断。
最小可执行快速入门
调用业务 API 前,先通过元数据发现 API:
python scripts/list_openapi_meta_apis.py
可选的覆盖项:
python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>
该脚本会将 API 清单文件写入技能输出目录。
输出策略
如果需要保存响应或生成的文件,请将其写入:
output/aliyun-aicontent-generate/
验证
mkdir -p output/aliyun-aicontent-generate
for f in skills/ai/content/aliyun-aicontent-generate/scripts/*.py; do
python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-aicontent-generate/validate.txt
通过标准:命令以 0 退出,且已生成 output/aliyun-aicontent-generate/validate.txt。
输出与证据
- 将文件、命令输出和 API 响应摘要保存在
output/aliyun-aicontent-generate/下。 - 在证据文件中注明关键参数(地域/资源 ID/时间范围),以便复现。
前提条件
- 执行前配置遵循最小权限原则的 Alibaba Cloud 凭证。
- 优先使用环境变量:
ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET,以及可选的ALIBABACLOUD_REGION_ID。 - 如果无法确定地域,请在执行变更操作前询问用户。
参考资料
- 来源:
references/sources.md
评论
支持 Markdown