Skills
skills/skills.volces.com/volcengine-rds-mysql

volcengine-rds-mysql

SKILL.md

Skill 概览

本 Skill 用于在对话中充当 火山引擎 RDS MySQL 的智能运维代理:

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

工作模式:

  • 使用 scripts/call_rds_mysql.py 脚本直接获取 RDS MySQL 的实时响应

运行方式: 脚本支持两种运行方式:

# 方式 1: 使用 uv (推荐，自动管理依赖)
uv run ./scripts/call_rds_mysql.py [action] [options]

# 方式 2: 使用 python (需要预先安装依赖)
python ./scripts/call_rds_mysql.py [action] [options]

标准使用流程

  1. 确认任务类型与参数

    • 判断用户意图:查询实例列表、查看实例详情、管理数据库、管理账号、查看参数配置、创建实例等。
    • 收集必要参数(如未指定则使用默认值):
      • --region:地域 ID(默认 cn-beijing)
      • --action:操作类型(如 list-instances、describe-instance、list-databases 等)
      • --instance-id:实例 ID(部分操作必需)

  2. 构造查询并调用脚本

    • 示例（以下命令可使用 uv run 或 python 运行）: 
      # 查询实例列表
uv run ./scripts/call_rds_mysql.py list-instances
# 或
python ./scripts/call_rds_mysql.py list-instances

# 查询指定实例详情
uv run ./scripts/call_rds_mysql.py describe-instance --instance-id mysql-xxx
# 或
python ./scripts/call_rds_mysql.py describe-instance --instance-id mysql-xxx

# 查询实例的数据库列表
uv run ./scripts/call_rds_mysql.py list-databases --instance-id mysql-xxx
# 或
python ./scripts/call_rds_mysql.py list-databases --instance-id mysql-xxx

# 查询实例的账号列表
uv run ./scripts/call_rds_mysql.py list-accounts --instance-id mysql-xxx
# 或
python ./scripts/call_rds_mysql.py list-accounts --instance-id mysql-xxx

# 查询实例参数
uv run ./scripts/call_rds_mysql.py list-parameters --instance-id mysql-xxx
# 或
python ./scripts/call_rds_mysql.py list-parameters --instance-id mysql-xxx

# 查询 VPC 列表（用于创建实例）
uv run ./scripts/call_rds_mysql.py list-vpcs
# 或
python ./scripts/call_rds_mysql.py list-vpcs

# 查询子网列表
uv run ./scripts/call_rds_mysql.py list-subnets --vpc-id vpc-xxx --zone-id cn-beijing-a
# 或
python ./scripts/call_rds_mysql.py list-subnets --vpc-id vpc-xxx --zone-id cn-beijing-a

  3. 解析结果并后续处理

    • 将 RDS MySQL 的响应用自然语言解释给用户;
    • 如返回包含敏感操作,评估风险并提醒:
      • 避免在生产环境直接执行高风险操作(如删除实例、删除数据库等);
      • 建议在测试环境验证或做好备份。

工具脚本使用说明

支持的操作(Actions)

操作 说明 必需参数
list-instances 查询 RDS MySQL 实例列表 无
describe-instance 查询指定实例详情 --instance-id
list-databases 查询实例的数据库列表 --instance-id
list-accounts 查询实例的账号列表 --instance-id
list-parameters 查询实例的参数配置 --instance-id
list-parameter-templates 查询参数模板列表 无
describe-parameter-template 查询参数模板详情 --template-id
list-vpcs 查询 VPC 列表 无
list-subnets 查询子网列表 --vpc-id
get-price 查询实例价格 多个配置参数

命令行参数

参数 说明 默认值
action 操作类型(必需) -
--region / -r 火山引擎地域 ID cn-beijing
--instance-id / -i 实例 ID 无
--page-number 分页页码 1
--page-size 每页记录数 10
--output / -o 输出格式(json/table) json

输出格式

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

[操作] list-instances
[地域] cn-beijing
============================================================
[查询结果]
<实际结果内容>

常见使用场景

1. 查看所有实例

uv run ./scripts/call_rds_mysql.py list-instances

2. 查看实例详情

uv run ./scripts/call_rds_mysql.py describe-instance --instance-id mysql-xxx

3. 查看实例的数据库

uv run ./scripts/call_rds_mysql.py list-databases --instance-id mysql-xxx

4. 查看实例的账号

uv run ./scripts/call_rds_mysql.py list-accounts --instance-id mysql-xxx

5. 查看实例参数配置

uv run ./scripts/call_rds_mysql.py list-parameters --instance-id mysql-xxx

6. 创建实例前查询网络信息

# 先查询 VPC
uv run ./scripts/call_rds_mysql.py list-vpcs

# 再查询子网
uv run ./scripts/call_rds_mysql.py list-subnets --vpc-id vpc-xxx --zone-id cn-beijing-a

环境变量配置

  1. 获取火山引擎访问凭证：参考 用户指南 获取 AK/SK

  2. 配置以下环境变量:

export VOLCENGINE_ACCESS_KEY="your-access-key"
export VOLCENGINE_SECRET_KEY="your-secret-key"
export VOLCENGINE_REGION="cn-beijing"  # 可选，默认 cn-beijing
Weekly Installs
9
Source
skills.volces.c…-samples
First Seen
3 days ago
Installed on
openclaw9
amp1
cline1
opencode1
cursor1
kimi-cli1