使用 ChatOps Agent Skill 管理云资源

更新时间:
复制 MD 格式

OOS ChatOps Agent Skill(alibabacloud-oos-chatops-agent)基于阿里云系统运维管理服务(OOS),支持在 AI 智能体平台中通过自然语言查询和管理阿里云资源,执行实例启停、查看监控和账单、以及批量运维操作。

功能概述

ChatOps Agent Skill 基于 OOS 提供以下能力:

  • 查询云资源:查询 ECS、RDS、VPC、SLB、安全组等多种云资源的实例列表、详情和状态。

  • 执行资源操作:对实例执行启动、停止、重启、扩缩容等操作。

  • 查看监控和账单:获取资源的监控指标数据、健康状态和计费信息。

  • 批量运维:通过 OOS 的批量执行能力,以自然语言描述需求即可完成批量运维任务。

适用范围

使用 ChatOps Agent Skill 前,确保满足以下条件:

  • AI 智能体平台:已安装并配置支持 Skill 协议的 AI 智能体平台(如 OpenClaw、Cursor、Claude 等)。

  • 阿里云 CLI 版本:需要阿里云 CLI 3.3.1 及以上版本。运行 aliyun version 查看当前版本,版本过低请升级。

  • 阿里云账号凭证:已配置阿里云凭证。支持环境变量(ALIBABA_CLOUD_ACCESS_KEY_ID / ALIBABA_CLOUD_ACCESS_KEY_SECRET)、配置文件(~/.aliyun/config.json)、STS、RAM Role 或实例元数据等方式。

  • RAM 权限:为凭证对应的 RAM 用户或角色授予 oos:Chat 权限,以及需要管理的云资源对应的只读或操作权限。

添加 Skill

ChatOps Agent Skill 已发布至阿里云 Skill 平台,在终端中执行命令安装,请确保已安装 Node.js (≥18)。根据您使用的 Agent 客户端选择对应命令:

Qoder

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-oos-chatops-agent --agent qoder -y --full-depth

Qwen Code

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-oos-chatops-agent --agent qwen-code -y --full-depth

Claude Code

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-oos-chatops-agent --agent claude-code -y --full-depth

OpenClaw

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-oos-chatops-agent --agent openclaw -y --full-depth

Codex

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-oos-chatops-agent --agent codex -y --full-depth

Cursor

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-oos-chatops-agent --agent cursor -y --full-depth

Gemini CLI

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-oos-chatops-agent --agent gemini-cli -y --full-depth

GitHub Copilot

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-oos-chatops-agent --agent github-copilot -y --full-depth
运行后,重启 Agent 客户端即可使用此 Skill。

配置参数

Skill 支持以下可选配置参数:

变量

是否必填

说明

OOS_CHATOPS_REGION

否

资源查询的目标地域,默认值为 cn-hangzhou。

OOS_CHATOPS_TIMEOUT

否

请求超时时间(秒),默认值为 300。对于批量运维等耗时操作建议设置为 600。

使用场景

Skill 支持以下使用场景。在 AI 智能体平台的对话界面中,使用自然语言描述需求即可触发对应流程。

查询云资源

查询 ECS、RDS、VPC、SLB 等云资源的实例列表和详情。

示例对话:

  • "查看杭州地域的 ECS 实例列表"

  • "列出所有运行中的 RDS 实例"

  • "查询 VPC 和安全组信息"

执行资源操作

对 ECS、RDS 等实例执行启动、停止、重启等操作。

示例对话:

  • "重启 i-bp1xxxxxxxx 这台 ECS 实例"

  • "停止杭州地域所有已过期的实例"

  • "帮我启动 i-bp1xxxxxxxx"

查看监控和账单

获取资源的监控指标、健康状态和计费信息。

示例对话:

  • "查看 i-bp1xxxxxxxx 的 CPU 使用率"

  • "这个月的 ECS 账单是多少"

  • "检查一下实例的健康状态"

批量运维

通过 OOS 的批量执行能力完成多实例运维任务。

示例对话:

  • "批量重启杭州地域所有 ECS 实例"

  • "帮我给所有实例打上 env:production 标签"

  • "批量升级北京地域的实例安全组规则"

常见问题

凭证配置失败如何处理?

确保已通过以下任一方式配置阿里云凭证:

  • 设置环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET。

  • 配置 ~/.aliyun/config.json 文件。

  • 使用实例 RAM Role(ECS 实例内部署时)。

请求超时怎么办?

对于批量操作或复杂查询,将 OOS_CHATOPS_TIMEOUT 设置为更大的值(如 600 秒)。如果仍然超时,可尝试缩小查询范围(如指定地域或资源类型)。

权限不足如何处理?

确保 RAM 用户或角色具有 oos:Chat 权限。如需操作特定资源,还需授予对应资源的操作权限(如 ecs:StopInstance、ecs:StartInstance 等)。

支持哪些云产品?

目前支持查询和管理的云产品包括 ECS、RDS、VPC、SLB、安全组等。支持的操作范围取决于 OOS ChatOps 后端能力,持续扩展中。

如何切换目标地域?

设置环境变量 OOS_CHATOPS_REGION 为目标地域 ID(如 cn-beijing、cn-shanghai)。也可以在对话中直接指定地域,例如"查看北京地域的 ECS 实例"。