阿里云 RDS Copilot 智能运维助手技能用于在对话中调用阿里云 RDS Copilot，帮助用户完成 RDS 相关的智能问答、SQL 优化、实例操作与故障排查。
用途 该技能面向 RDS 相关的日常运维与诊断场景，可理解用户的中文或英文自然语言请求，判断是否与 RDS Copilot 相关，并直接调用阿里云 CLI 执行 aliyun rdsai chat-messages 命令进行实时查询。当收到返回结果或用户粘贴的错误信息时，技能会进一步解释、诊断并给出建议。
架构与主要能力 架构为阿里云 CLI 加 RdsAi OpenAPI。主要能力包括：理解自然语言请求并识别 RDS Copilot 相关意图；通过阿里云 CLI 调用 RdsAi OpenAPI 实时查询；对结果或错误信息进行解释、诊断与建议。
环境准备与安装 技能要求阿里云 CLI 版本不低于 3.3.3。低于 3.3.0 的 CLI 不支持 aliyun plugin 命令，需先升级。安装方式包括：macOS 可用 Homebrew（brew install aliyun-cli）、PKG 包或一键脚本；Linux 可用一键脚本或下载 TGZ 包手动安装。安装后需运行 command -v aliyun 与 aliyun version 验证。
插件与凭证 需运行 aliyun configure set --auto-plugin-install true 启用插件自动安装，并通过 aliyun plugin list、aliyun plugin search rdsai 或 aliyun rdsai --help 验证 rdsai 插件能力；未安装时运行 aliyun plugin install --names rdsai，已安装时运行 aliyun plugin update --name rdsai。凭证配置推荐交互式 aliyun configure --mode AK --profile rdsai，也可非交互式设置 profile、mode、access-key-id、access-key-secret 与 region。凭证未就绪（无 profile、Credential 为空、Valid 为 Invalid 或出现认证错误）时，应在调用 chat-messages 前停止并引导用户配置。
使用方式 基本命令结构为 aliyun rdsai chat-messages，配合 --query、--inputs（RegionId、Language、Timezone、CustomAgentId、EnableThinking、ThinkEffort、ModelId）、--event-mode separate、--endpoint rdsai.aliyuncs.com、--user-agent 以及可选的 --conversation-id。业务 API 命令必须携带格式为 AlibabaCloud-Agent-Skills/alibabacloud-rds-copilot/{session-id} 的 --user-agent；系统命令（如 aliyun configure、aliyun plugin、aliyun version）不添加该参数。未指定地域时默认 cn-hangzhou，语言默认 zh-CN，时区默认 Asia/Shanghai。多轮对话可复用上一次响应中的 ConversationId。
模型与思考深度 当用户明确指定 ModelId、询问可用模型或要求深度思考/特定思考深度时，必须先调用辅助命令 aliyun rdsai get-chat-model 校验，确认模型 ID 出现在 Data[].ModelId 中，并从 ThinkingLevels 读取该模型支持的 ThinkEffort 取值；不得依赖记忆或硬编码的模型列表。未指定 ModelId 时无需查询，服务会使用 Default=true 的模型。
权限 该技能需要 RAM 权限 rdsai:ChatMessages（调用 RDS AI 助手对话 API）与 rdsai:GetChatModel（在显式设置 ModelId 时查询可用模型）。
适用场景与限制 适用于 RDS 智能问答、SQL 编写与优化、SQL 诊断、实例参数调优、故障排查、性能分析、查询实例列表等。限制包括：必须完成 CLI 版本、插件与凭证三项预检后才能调用 chat-messages；凭证配置应通过 aliyun configure 保存在 CLI 凭证存储中，不应将密钥导出为环境变量；安装或升级若需网络、sudo 或工具审批，需先请求批准。