Volcengine RDS PostgreSQL

Skill 概览#

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

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

工作模式:

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

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

bash

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

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

标准使用流程#

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

   • 示例（以下命令可使用 uv run 或 python 运行）: bash

     # 查询实例列表
     uv run ./scripts/call_rds_postgresql.py list-instances
     # 或
     python ./scripts/call_rds_postgresql.py list-instances
     
     # 查询指定实例详情
     uv run ./scripts/call_rds_postgresql.py describe-instance --instance-id postgres-xxx
     # 或
     python ./scripts/call_rds_postgresql.py describe-instance --instance-id postgres-xxx
     
     # 查询实例的数据库列表
     uv run ./scripts/call_rds_postgresql.py list-databases --instance-id postgres-xxx
     # 或
     python ./scripts/call_rds_postgresql.py list-databases --instance-id postgres-xxx
     
     # 查询实例的账号列表
     uv run ./scripts/call_rds_postgresql.py list-accounts --instance-id postgres-xxx
     # 或
     python ./scripts/call_rds_postgresql.py list-accounts --instance-id postgres-xxx
     
     # 查询实例参数
     uv run ./scripts/call_rds_postgresql.py list-parameters --instance-id postgres-xxx
     # 或
     python ./scripts/call_rds_postgresql.py list-parameters --instance-id postgres-xxx
     
     # 查询 VPC 列表（用于创建实例）
     uv run ./scripts/call_rds_postgresql.py list-vpcs
     # 或
     python ./scripts/call_rds_postgresql.py list-vpcs
     
     # 查询子网列表
     uv run ./scripts/call_rds_postgresql.py list-subnets --vpc-id vpc-xxx --zone-id cn-beijing-a
     # 或
     python ./scripts/call_rds_postgresql.py list-subnets --vpc-id vpc-xxx --zone-id cn-beijing-a
     
     

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

工具脚本使用说明#

支持的操作(Actions)#

操作说明必需参数list-instances查询 RDS PostgreSQL 实例列表无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火山引擎地域 IDcn-beijing``--instance-id / -i实例 ID无--page-number分页页码1``--page-size每页记录数10``--output / -o输出格式(json/table)json

注意： --region、 --page-number、 --page-size 等全局参数必须放在子命令 之前，例如：

bash

uv run ./scripts/call_rds_postgresql.py --region cn-shanghai list-instances

放在子命令之后会被忽略（argparse 解析限制）。

输出格式#

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

text

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

常见使用场景#

1. 查看所有实例#

bash

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

2. 查看实例详情#

bash

uv run ./scripts/call_rds_postgresql.py describe-instance --instance-id postgres-xxx

3. 查看实例的数据库#

bash

uv run ./scripts/call_rds_postgresql.py list-databases --instance-id postgres-xxx

4. 查看实例的账号#

bash

uv run ./scripts/call_rds_postgresql.py list-accounts --instance-id postgres-xxx

5. 查看实例参数配置#

bash

uv run ./scripts/call_rds_postgresql.py list-parameters --instance-id postgres-xxx

6. 按版本过滤实例#

bash

uv run ./scripts/call_rds_postgresql.py list-instances --db-engine-version PostgreSQL_14

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

bash

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

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

环境变量配置#

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

2. 配置以下环境变量:

bash

export VOLCENGINE_ACCESS_KEY="your-access-key"
export VOLCENGINE_SECRET_KEY="your-secret-key"
export VOLCENGINE_REGION="cn-beijing"  # 可选，默认 cn-beijing

权限说明： list-vpcs 和 list-subnets 调用的是 VPC 服务接口，AK/SK 需要同时授予 RDS PostgreSQL 和 VPC（ vpc:DescribeVpcs、 vpc:DescribeSubnets）两个服务的权限， 否则会返回 AccessDenied 403 错误。