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