# Alibabacloud Rds Copilot

> 使用阿里云 RDS Copilot API,帮助用户完成 RDS 相关的智能问答、SQL 优化、实例运维和故障排查, 可直接调用 uv run ./scripts/call_rds_ai.py 脚本获取实时结果。 Use when this capability is needed.

- Skill: `tomevault-io/alibabacloud-rds-copilot` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/alibabacloud-rds-copilot`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/alibabacloud-rds-copilot/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/alibabacloud-rds-copilot

---


## Skill 概览

本 Skill 用于在对话中充当 **阿里云 RDS Copilot 的智能代理**:

- **理解用户的自然语言需求**(中文或英文),识别是否与 RDS Copilot 相关;
- **直接调用内置脚本** `scripts/call_rds_ai.py` 实时查询 RDS Copilot 并获取结果;
- 当获取到结果或用户粘贴错误信息时,**进一步解释、诊断并给出后续建议**。

**工作模式**:
- 使用 `scripts/call_rds_ai.py` 脚本直接获取 RDS Copilot 的实时响应

## 标准使用流程
1. **确认任务类型与参数**
    - 判断用户意图:SQL 编写/优化、SQL 诊断、实例参数调优、故障排查、性能分析、查询实例列表等。
    - 收集必要参数(如未指定则使用默认值):
        - `--region`:地域 ID(默认 `cn-hangzhou`)
        - `--language`:语言(默认 `zh-CN`)
        - `--timezone`:时区(默认 `Asia/Shanghai`)
        - `--custom-agent-id`:专属 Agent ID(可选)
        - `--conversation-id`:会话 ID,用于多轮对话(可选)

2. **构造查询并调用脚本**
     ```
   - 示例:
     ```bash
     # 基础查询
     uv run ./scripts/call_rds_ai.py "查询杭州地域的 RDS MySQL 实例列表"
     
     # 指定地域
     uv run  ./scripts/call_rds_ai.py "优化这条SQL" --region cn-beijing
     
     # 多轮对话
     uv run ./scripts/call_rds_ai.py "继续分析" --conversation-id "<上次返回的会话ID>"
     ```

3. **解析结果并后续处理**
    - 将 RDS Copilot 的响应用自然语言解释给用户;
    - 如返回包含 SQL 或操作步骤,评估风险并提醒:
        - 避免在生产环境直接执行高风险语句(如大表 `DELETE` / `UPDATE` / 结构变更);
        - 建议在测试环境验证或加上备份/条件限制。
    - 如需继续对话,记录 `conversation_id` 用于下一轮查询。

## 工具脚本使用说明
### 命令行参数

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `query` | 查询内容(必需),使用 `-` 从标准输入读取 | - |
| `--region` / `--region-id` | 阿里云地域 ID | `cn-hangzhou` |
| `--language` / `--lang` | 语言 | `zh-CN` |
| `--timezone` / `--tz` | 时区 | `Asia/Shanghai` |
| `--custom-agent-id` | 专属 Agent ID | 无 |
| `--conversation-id` / `--conv-id` | 会话 ID(多轮对话) | 无 |
| `--endpoint` | API 端点 | `rdsai.aliyuncs.com` |
| `--no-stream` | 禁用流式输出 | False(默认启用流式) |


### 输出格式

脚本会将查询信息输出到 `stderr`,将 RDS Copilot 的回答输出到 `stdout`,便于分离日志和结果:

```
[查询] 查询杭州地域实例列表
[地域] cn-hangzhou | [语言] zh-CN
============================================================
[RDS Copilot 回答]
<实际回答内容>

[会话ID] conv-xxxx-xxxx-xxxx
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/aliyun) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->