类别：service

PAI AIWorkspace

使用阿里云 OpenAPI（RPC）配合官方 SDK 或 OpenAPI Explorer，管理人工智能平台 PAI 的 AIWorkspace 资源。

工作流程

1. 确认地域（Region）、资源标识符（Resource Identifiers）及期望执行的操作。
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 发现

• 产品代码（Product Code）：AIWorkSpace
• 默认 API 版本：2021-02-04
• 使用 OpenAPI 元数据端点（metadata endpoints）列出 API 并获取其 Schema（参见参考资料）。

高频操作模式

1. 资产盘点 / 列举（Inventory/List）：优先使用 List* / Describe* 类 API 获取当前资源状态。
2. 变更 / 配置（Change/Configure）：优先使用 Create* / Update* / Modify* / Set* 类 API 执行资源变更。
3. 状态查询 / 故障排查（Status/Troubleshoot）：优先使用 Get* / Query* / Describe*Status 类 API 进行诊断。

最小可执行快速入门

调用业务 API 前，请先基于元数据进行 API 发现：

python scripts/list_openapi_meta_apis.py

可选参数覆盖：

python scripts/list_openapi_meta_apis.py --product-code  --version 

该脚本将 API 清单产物（artifacts）写入技能输出目录（skill output directory）。

输出策略

如需保存响应内容或生成的产物，请将其写入以下路径：
output/alicloud-ai-pai-aiworkspace/

验证

mkdir -p output/alicloud-ai-pai-aiworkspace
for f in skills/ai/platform/alicloud-ai-pai-aiworkspace/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-ai-pai-aiworkspace/validate.txt

通过标准：命令退出码为 0，且成功生成 output/alicloud-ai-pai-aiworkspace/validate.txt 文件。

输出与证据

• 将产物（artifacts）、命令输出及 API 响应摘要保存至 output/alicloud-ai-pai-aiworkspace/ 目录下。
• 在证据文件中包含关键参数（如地域、资源 ID、时间范围等），以确保可复现性（reproducibility）。

前提条件

• 执行前，请预先配置具备最小权限的阿里云凭据（Alibaba Cloud credentials）。
• 优先使用环境变量方式配置：ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET，以及可选的 ALICLOUD_REGION_ID。
• 若地域不明确，在执行变更类（mutating）操作前，须向用户确认。

参考资料

• 来源文档：references/sources.md