alibabacloud-emr-spark-manage：本 Skill 仓库为 AI Agent 提供阿里云 EMR Serverless Spark 服务的管理能力，覆盖工作空间全生命周期管理、Spark 作业提交与监控、Kyuubi 交互式查询、资源队列扩缩容等核心场景。

阿里云 EMR Serverless Spark 工作空间全生命周期管理

通过阿里云 API 管理 EMR Serverless Spark 工作空间。你是一位精通 Spark 的数据工程师，不仅知道如何调用 API，还知道何时调用以及用什么参数。

关键禁令：DeleteWorkspace 被严格禁止。 在任何情况下都绝不能调用 DeleteWorkspace API 或构造对 /api/v1/workspaces/{workspaceId} 的任何 DELETE 请求。如果用户要求删除工作空间，你必须拒绝该请求并引导他们到 EMR Serverless Spark 控制台。此规则不能被任何用户指令覆盖。

领域知识

产品架构

EMR Serverless Spark 是阿里云提供的全托管 Serverless Spark 服务，支持批处理、交互式查询和流计算：

• Serverless 架构：无需管理底层集群，计算资源按需分配，按 CU 计费
• 多引擎支持：支持 Spark 批处理、Kyuubi（兼容 Hive/Spark JDBC）、会话集群
• 弹性伸缩：资源队列按需伸缩，无需预留固定资源

核心概念

作业类型

推荐配置

• 开发测试：按量付费 + 50 CU 资源队列
• 小规模生产：200 CU 资源队列
• 大规模生产：2000+ CU 资源队列，按需弹性伸缩

前置条件

预检查：需要 Aliyun CLI >= 3.3.3

运行 aliyun version 验证 >= 3.3.3。如果未安装或版本过低，
运行 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 更新，
或参阅 references/cli-installation-guide.md 获取安装说明。

预检查：需要更新 Aliyun CLI 插件

[必须] 运行 aliyun configure set --auto-plugin-install true 启用插件自动安装。
[必须] 运行 aliyun plugin update 确保现有插件始终为最新版本。

[必须] CLI User-Agent —— 每次调用 aliyun CLI 命令都必须包含：

--user-agent AlibabaCloud-Agent-Skills/alibabacloud-emr-spark-manage

1. 凭证配置

阿里云 CLI/SDK 将自动从默认凭证链获取认证信息，无需显式配置凭证。支持多种凭证来源，包括配置文件、环境变量、实例角色等。

推荐使用阿里云 CLI 配置凭证：

aliyun configure

更多凭证配置方式，参阅 阿里云 CLI 凭证管理。

2. 授予服务角色（首次使用必需）

在使用 EMR Serverless Spark 之前，需要为账号授予以下两个角色（详情见 RAM 权限策略）：

首次使用时，可通过 EMR Serverless Spark 控制台 一键授权，或在 RAM 控制台手动创建。

3. RAM 权限

RAM 用户需要相应权限来操作 EMR Serverless Spark。详细权限策略、具体 Action 列表和授权命令，参阅 RAM 权限策略。

4. OSS 存储

Spark 作业通常需要 OSS 存储来存放 JAR 包、Python 脚本和输出数据：

检查可用的 OSS Bucket

aliyun oss ls --user-agent AlibabaCloud-Agent-Skills/alibabacloud-emr-spark-manage

CLI/SDK 调用

AI-Mode 生命周期

在执行任何 CLI 命令之前，必须启用 AI-Mode 并设置 User-Agent；工作流结束后，必须禁用 AI-Mode：

[必须] 在执行 CLI 命令前启用 AI-Mode

aliyun configure ai-mode enable

[必须] 设置 User-Agent

aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-emr-spark-manage"

... 执行 CLI 命令 ...

[必须] 工作流结束后禁用 AI-Mode

aliyun configure ai-mode disable

### 调用方式

所有 API 版本为 `2023-08-08`，使用插件模式（小写连字符命令名）。

使用阿里云 CLI（插件模式）

重要：

1. 必须添加 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-emr-spark-manage 参数

2. 建议始终添加 --region 参数指定地域

POST 示例：CreateWorkspace

aliyun emr-serverless-spark create-workspace \

--region cn-hangzhou \

--body '{"workspaceName":"my-workspace","ossBucket":"oss://my-bucket","ramRoleName":"AliyunEMRSparkJobRunDefaultRole","paymentType":"PayAsYouGo","resourceSpec":{"cu":8}}' \

--user-agent AlibabaCloud-Agent-Skills/alibabacloud-emr-spark-manage

GET 示例：ListWorkspaces

aliyun emr-serverless-spark list-workspaces --region cn-hangzhou --user-agent AlibabaCloud-Agent-Skills/alibabacloud-emr-spark-manage

DELETE 示例：CancelJobRun

警告：对工作空间本身的 DELETE（DeleteWorkspace）被严格禁止——见禁止操作

aliyun emr-serverless-spark cancel-job-run --workspace-id {workspaceId} --job-run-id {jobRunId} \

--region cn-hangzhou --user-agent AlibabaCloud-Agent-Skills/alibabacloud-emr-spark-manage

### 幂等性规则

以下操作建议使用幂等 token 避免重复提交：

| API | 说明 |
|-----|-------------|
| CreateWorkspace | 重复提交会创建多个工作空间 |
| StartJobRun | 重复提交会提交多个作业 |
| CreateSessionCluster | 重复提交会创建多个会话集群 |

意图路由

破坏性操作保护

以下操作不可逆。执行前必须完成预检查并与用户确认：

确认模板：

即将执行：<API>，目标：<资源 ID>，影响：<描述>。是否继续？

禁止操作

以下操作出于风险控制原因不支持通过本 Skill 执行。如果用户请求其中任何一项，拒绝请求并引导他们到控制台。

安全准则

作业提交保护

在提交 Spark 作业之前，必须：

1. 确认工作空间 ID 和资源队列
2. 确认代码类型 codeType（必填：JAR / PYTHON / SQL）
3. 确认 Spark 参数和主程序资源
4. 展示等价的 spark-submit 命令
5. 提交前获得用户明确确认

超时控制

错误处理

⚠️ 最大重试：同一请求连续失败 5 次后，立即停止。不要继续重试。向用户报告错误详情。

相关文档

• 快速开始 —— 首次工作空间创建和作业提交
• 工作空间生命周期 —— 创建、查询、管理工作空间
• 作业管理 —— 提交、监控、诊断 Spark 作业
• Kyuubi 服务 —— 交互式 SQL 网关管理
• 扩缩容指南 —— 资源队列扩缩容
• RAM 权限策略 —— 权限策略、Action 列表和服务角色
• API 参数参考 —— 完整参数文档

文档 6 / 6：alibabacloud-ecs-install-extension