运行时依赖
安装命令
点击复制技能文档
阿里云 Flink 实例管理 操作阿里云 Flink VVP 资源,通过一个包装脚本以严格的创建/查询范围。 范围和入口 始终通过以下方式运行操作: python scripts/instance_ops.py <命令> [选项] 允许的命令: create、create_namespace、describe、describe_regions、describe_zones、describe_namespaces、list_tags 不在范围内: update/delete、Flink SQL/作业运行时操作和非 Flink 服务 触发规则 当提示与 Flink 实例/命名空间生命周期操作相关时使用此技能。 正面意图示例: “在 cn-beijing 创建 Flink 实例” “列出 Flink 实例和状态” “描述实例 f-cn-xxx 的命名空间” “查询 Flink 实例标签” “Flink 可用区有哪些” 负面意图示例: ECS/Kafka/OSS/DataWorks 操作 通用问题(天气、翻译等) Flink SQL / Flink 作业编写或运行时优化 模糊提示: 询问一个澄清问题:实例/命名空间管理 vs SQL/作业操作。 意图到命令映射 用户意图 命令 查询某个区域的所有实例 describe --region_id 创建实例 create ... --confirm 查询实例下的命名空间 describe_namespaces --region_id --instance_id 创建命名空间 create_namespace ... --confirm 查询支持的区域/可用区 describe_regions / describe_zones --region_id 查询标签 list_tags --region_id --resource_type [--resource_ids ...] 操作规则 创建命令的确认是必需的 create 和 create_namespace 必须包含 --confirm。 创建结果的验证 不要仅凭创建响应来确定成功。 重试策略是严格的 对于同一命令,最大 2 次尝试(初始 + 一次更正重试)。 不自动切换操作 如果操作失败,不要在没有用户批准的情况下切换到不同的操作。 生命周期目标锁 在 create -> create_namespace 流中,命名空间必须针对同一个新创建的 InstanceId,除非用户批准回退。 命名空间预检查是必需的 在 create_namespace 之前,检查实例状态/资源和现有的命名空间分配。 不暴露密钥 不要输出或请求明文 AK/SK。 使用默认凭证链指导。 不要编造参数 永远不要编造 VPC/VSwitch/实例 ID。 保持可审计的确认证据 生命周期输出必须包含 SafetyCheckRequired 或显式 --confirm 证据。 不为生命周期流程声明部分完成 对于需要创建和 create_namespace 的流程,只有当两个创建操作都成功时,才能将整体状态标记为完成。 不自动扩容 如果 create_namespace 因资源不足而失败,清晰地报告并要求用户在此技能范围之外手动扩容资源。 执行协议 步骤 1:分类请求 针对 Flink 实例/命名空间/标签/区域/可用区的创建/查询请求 -> 继续。 不在范围内或非 Flink -> 拒绝或路由并解释。 步骤 2:验证参数 应用 references/parameter-validation.md。 如果缺少必需参数,询问用户或返回清晰的补救措施。 步骤 3:执行命令 查询命令:运行一次,除非发生暂时性查询错误。 创建命令:构造最终命令字符串并在执行前验证 --confirm 是否存在。 步骤 4:验证创建结果 对于创建:使用 describe --region_id 进行验证。 对于 create_namespace:使用 describe_namespaces --region_id --instance_id 进行验证。 使用最多 3 次读取检查和短暂的回退,直到确定创建尚未反映。 对于链式 create -> create_namespace:每 30 秒轮询 describe --region_id ,最长等待 10 分钟,如果仍然没有运行,停止并提供下一步操作(等待/稍后重试),不要在没有用户明确批准的情况下切换到另一个实例,如果命名空间创建失败,标记生命周期链为失败/未准备好,而不是完成,资源不足时,要求用户手动扩容实例并稍后重试 关键参考 开始:references/README.md references/quick-start.md references/trigger-recognition-guide.md references/core-execution-flow.md references/command-templates.md 文档目的 references/parameter-validation.md 预执行验证检查清单 references/e2e-playbooks.md 完整的执行序列 references/common-failures.md 典型错误和修复 references/required-confirmation-model.md 确认门控规则 references/instance-state-management.md 实例状态和就绪检查 references/output-handling.md 输出解析和重试策略 references/verification-method.md 创建/查询后的验证模式 references/acceptance-criteria.md 正常操作的完成检查清单 references/python-environment-setup.md Python 依赖和身份验证设置 references/cli-installation-guide.md Aliyun CLI 诊断设置 references/ram-policies.md 所需的 RAM 权限 references/related-apis.md API 和命令映射 输出格式 所有命令返回