mcpField
A
alicloud-ai-translation-anytrans

alicloud-ai-translation-anytrans

github.com/cinience其他396289 次安装11 周前更新
代码仓库

关于 alicloud-ai-translation-anytrans

通过 OpenAPI 使用官方 SDK 或 OpenAPI Explorer 操作 Alibaba Cloud TongyiTranslate 的技能。它强调调用前发现 API、处理凭据与区域设置,并保存可复现的执行证据。

主要功能

  1. 01从元数据发现 API 和模式
  2. 02使用 SDK 或 OpenAPI Explorer
  3. 03列出、更改和检查资源
  4. 04保存输出与验证证据

适用场景

  1. 01查找 TongyiTranslate API 操作
  2. 02检查或修改资源
  3. 03验证操作状态
  4. 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.yaml
references/
sources.md
scripts/
list_openapi_meta_apis.py

详细介绍

Category: 服务

通义翻译

使用 Alibaba Cloud OpenAPI(RPC)以及官方 SDK 或 OpenAPI Explorer 管理通义翻译资源。

工作流

  1. 确认地域、资源标识符和所需操作。
  2. 查找 API 列表和必需参数(参见参考资料)。
  3. 使用 SDK 或 OpenAPI Explorer 调用 API。
  4. 使用 describe/list API 验证结果。

AccessKey 优先级(必须遵循)

  1. 环境变量:ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID 地域策略:ALICLOUD_REGION_ID 是可选的默认值。如果未设置,请为任务选择最合适的地域;如果无法确定,请询问用户。
  2. 共享配置文件:~/.alibabacloud/credentials

API 发现

  • 产品代码:AnyTrans
  • 默认 API 版本:2025-07-07
  • 使用 OpenAPI 元数据端点列出 API 并获取架构(参见参考资料)。

高频操作模式

  1. 清点/列表:优先使用 List* / Describe* API 获取当前资源。
  2. 更改/配置:优先使用 Create* / Update* / Modify* / Set* API 执行变更。
  3. 状态/故障排查:优先使用 Get* / Query* / Describe*Status API 进行诊断。

最简可执行快速入门

调用业务 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