本技能允许用户通过自然语言或结构化输入查询腾讯云 CVM(云服务器)、CDB MySQL(云数据库)、Redis(分布式缓存数据库)、Lighthouse(轻量应用服务器)、SQL Server、COS(对象存储)、CDN(内容分发网络)、IM(即时通信)、Push(消息推送)、TRTC(实时音视频)价格。普通命令行也可以通过调用 scripts/ 里的 Python 脚本使用。
数量能力:全产品支持解析 几台/几套/数量n/数量:n,并按数量返回总价。
outputs/ JSON 价格文件,不是网页实时抓取。TRTC、实时音视频IM、即时通信Push、消息推送CDN、内容分发COS、对象存储CVM、云服务器MySQL、CDBRedisSQL Server轻量应用服务器、Lighthousescripts/parse_input.py + scripts/query_cvm_price.pyscripts/parse_cdb_input.py + scripts/query_cdb_price.pyscripts/parse_redis_input.py + scripts/query_redis_price.pyscripts/parse_lighthouse_input.py + scripts/query_lighthouse_price.pyscripts/parse_sqlserver_input.py + scripts/query_sqlserver_price.pyscripts/parse_cos_input.py + scripts/query_cos_price.pyscripts/parse_cdn_input.py + scripts/query_cdn_price.pyscripts/parse_im_input.py + scripts/query_im_price.pyscripts/parse_trtc_input.py + scripts/query_trtc_price.pyscripts/generate_quote.py本技能支持基于查询结果生成报价单(Excel)。报价单样式由 scripts/generate_quote.py 内置生成,发布包无需携带 Excel 模板文件。
C4:客户公司全称(用户手动提供或留空)C6:客户经理名称(用户手动提供或留空)0.80元/GB1.00元/GB0.50元/GB架构:集群架构分片数量:N片是否需要生成报价单?报价单:xxx产品xxx规格xxx时长,直接生成报价单。核心功能:
credentials.example.json 为 credentials.json 后填入腾讯云密钥即可进入技能目录后,调用 scripts/parse_input.py 解析用户输入,提取参数。
macOS / Linux:
cd /path/to/tencent-cloud-cvm-pricing
python3 scripts/parse_input.py "用户输入文本"
Windows PowerShell:
cd C:\path\to\tencent-cloud-cvm-pricing
python scripts\parse_input.py "用户输入文本"
解析参数:
region - 地域(如 "ap-nanjing")region_cn - 地域中文名(如 "南京")cpu - CPU核数(如 4)memory - 内存大小GB(如 8)instance_type - 实例类型(如 "SA5.2XLARGE8")disk_size - 硬盘大小GB(如 50)disk_type - 硬盘类型(如 "CLOUD_PREMIUM")bandwidth - 带宽Mbps(如 1)bandwidth_charge_type - 带宽计费类型(如 "BANDWIDTH_PREPAID")period - 购买时长(月,如 12)charge_type - 计费类型(如 "PREPAID")如果解析后发现缺失必要参数,向用户询问:
调用 scripts/query_cvm_price.py 查询价格。
macOS / Linux:
python3 scripts/query_cvm_price.py '{"region":"ap-nanjing","instance_type":"SA3.LARGE8","disk_size":50,"disk_type":"CLOUD_BSSD","bandwidth":1,"period":12,"charge_type":"PREPAID"}'
Windows PowerShell:
python scripts\query_cvm_price.py "{""region"":""ap-nanjing"",""instance_type"":""SA3.LARGE8"",""disk_size"":50,""disk_type"":""CLOUD_BSSD"",""bandwidth"":1,""period"":12,""charge_type"":""PREPAID""}"
或使用Python直接调用:
import sys
import os
# 添加scripts目录到Python路径
scripts_dir = os.path.join(os.path.dirname(__file__), 'scripts')
sys.path.insert(0, scripts_dir)
# 导入模块
from parse_input import parse_input
from query_cvm_price import query_price, format_price
# 解析输入
user_input = "南京,SA5,4核8g,50g通用型ssd云盘,1M包年包月带宽,时长为1年"
params = parse_input(user_input)
# 查询价格
price_data = query_price(params)
# 格式化输出
if price_data:
print(format_price(price_data))
输出格式示例:
💰 价格查询结果:
📦 实例价格:
原价: ¥1234.56 元
折扣价: ¥987.65 元
节省: ¥246.91 元 (20.0%)
🌐 带宽价格:
原价: ¥111.11 元
折扣价: ¥88.89 元
节省: ¥22.22 元 (20.0%)
📊 总费用:
实例: ¥987.65 元
带宽: ¥88.89 元
合计: ¥1076.54 元
支持的中文地域名:
对应的Region ID:
ap-beijing, ap-shanghai, ap-nanjing, ap-guangzhou, ap-shenzhenap-chengdu, ap-chongqing, ap-hangzhou, ap-hongkongap-singapore, ap-tokyo, ap-seouleu-frankfurt, na-ashburn, na-siliconvalleyap-bangkok, ap-mumbai, sa-saopauloCPU核数: 1, 2, 4, 8, 16, 32等
内存大小GB: 根据CPU核数和内存比值确定实例类型:
本技能严格遵循以下映射规则,不做任何自动转换:
⚠️ "一年"的正确理解:
| 用户输入 | 实例计费 | 带宽计费 | 说明 |
|---|---|---|---|
| ---------- | ---------- | ---------- | ------ |
| "一年" / "一年多少钱" | 预付费(包年包月) | 预付费(包年包月) | 默认所有配置都按包年包月理解 |
| "按量计费"(不提一年) | 按量计费 | 按量计费 | 全部按量,无固定年费 |
| "一年 + 带宽按量计费" | 预付费(包年包月) | 按量计费 | 仅带宽按量,其他保持包年包月 |
🚨 错误理解(绝对不能这样理解):
正确理解:
示例:
→ 实例:预付费1年,带宽:预付费(默认全包年包月)
→ 实例:预付费1年,带宽:按量计费(混合计费)
→ 实例:按量计费,带宽:按量计费(全部按量)
禁止写死固定可用区(例如南京固定 ap-nanjing-3)或写死“某地区某机型不可用”。
查询 CVM 时必须执行:
https://cloud.tencent.com/document/product/213/6091)DescribeResourcePoolPackTypeConfigs,文档:https://cloud.tencent.com/document/product/213/15749)直接映射表:
| 用户输入 | 完整实例类型 | 说明 |
|---|---|---|
| ---------- | ------------- | ------ |
| SA5 + 4核8G | SA5.LARGE8 | AMD标准型 |
| SA3 + 4核8G | SA3.LARGE8 | AMD标准型 |
| SA2 + 4核8G | SA2.LARGE8 | AMD标准型 |
| S6 + 4核8G | S6.LARGE8 | Intel标准型 |
| S9 + 4核8G | S9.LARGE8 | Intel最新代 |
| SA9 + 4核8G | SA9.LARGE8 | AMD最新代 |
| BF1 + 4核8G | BF1.LARGE8 | 蜂驰型 |
| S5 + 4核8G | S5.LARGE8 | Intel标准型 |
| M5 + 4核8G | M5.LARGE8 | 内存型 |
| C5 + 4核8G | C5.LARGE8 | 计算型 |
⚠️ 注意:如果查询失败(如机型在目标可用区不可用),请用户更换机型,本技能不会自动转换。
不要在技能规则里写死“某地区某机型不可用”。
应在查询前通过 API 实时校验该机型在目标可用区是否可用:
DescribeResourcePoolPackTypeConfigs(文档:https://cloud.tencent.com/document/product/213/129953)DescribeZoneInstanceConfigInfos⚠️ 重要提示:不同地域可用实例类型会动态变化,最终以 API 实时校验结果为准。
用户可指定系列:
SA3, SA9 - AMD标准型SA5, SA2 - AMD标准型S6, S8, S9 - Intel标准型S5, S4 - Intel标准型BF1 - 蜂驰型 南京可用M5, M6 - 内存型C5, C6 - 计算型⚠️ 硬盘类型说明(API参数 vs 官网名称对照):
| API参数 | 官网名称 | 说明 |
|---|---|---|
| --------- | ---------- | ------ |
LOCAL_BASIC | 本地硬盘 | 本地盘,低延迟 |
LOCAL_SSD | 本地SSD硬盘 | 本地SSD,高性能 |
CLOUD_BASIC | 普通云硬盘 | 最便宜 |
CLOUD_PREMIUM | 高性能云硬盘 | 成本较低,推荐 |
CLOUD_SSD | SSD云硬盘 | 高性能SSD |
CLOUD_BSSD | 通用型SSD云硬盘 | ✅ 性价比优选 |
CLOUD_HSSD | 增强型SSD云硬盘 | 最高性能 |
CLOUD_TSSD | 极速型SSD云硬盘 | 超高IOPS |
⚠️ 重要提醒:
CLOUD_BSSDCLOUD_PREMIUMCLOUD_HSSDCLOUD_TSSDCLOUD_BSSD(通用型SSD云硬盘)硬盘大小: 50GB, 100GB, 200GB等
固定镜像ID: img-6n21msk1(TencentOS Server 4 for x86_64)
此镜像已通过验证,在所有支持地域均可正常使用。
带宽大小: 1Mbps, 2Mbps, 5Mbps, 10Mbps等
带宽计费类型:
BANDWIDTH_PREPAID - 包年包月带宽 默认TRAFFIC_POSTPAID_BY_HOUR - 按流量按量计费BANDWIDTH_PACKAGE - 共享带宽包包年包月时长:
1236122436PREPAID - 包年包月 默认POSTPAID_BY_HOUR - 按小时按量计费SPOTPAID - 竞价实例用户输入:
南京,SA5,4核8g,50g通用型ssd云盘,1M包年包月带宽,时长为1年
解析结果:
{
"region": "ap-nanjing",
"region_cn": "南京",
"cpu": 4,
"memory": 8,
"instance_type": "SA5.LARGE8",
"disk_size": 50,
"disk_type": "CLOUD_BSSD",
"bandwidth": 1,
"bandwidth_charge_type": "BANDWIDTH_PREPAID",
"period": 12,
"charge_type": "PREPAID"
}
输出:
💰 价格查询结果:
📦 实例价格:
原价: ¥1234.56 元
折扣价: ¥987.65 元
🌐 带宽价格:
原价: ¥111.11 元
折扣价: ¥88.89 元
📊 总费用:
实例: ¥987.65 元
带宽: ¥88.89 元
合计: ¥1076.54 元
用户输入:
帮我看一下南京地区4核8g,50g硬盘,1m包年包月带宽,最便宜的机型一年多少钱
处理流程:
用户输入:
南京4核8g多少钱
输出:
⚠️ 缺失参数,请补充:
- 硬盘大小(如:50G、100G)
- 带宽大小(如:1M、5M)
- 购买时长(如:1年、6个月)
可能原因:
处理方案:
可能原因:
处理方案:
/path/to/tencent-cloud-cvm-pricing/
├── SKILL.md # 技能主文件
├── credentials.example.json # 密钥配置模板,可复制为 credentials.json
├── scripts/
│ ├── parse_input.py # 自然语言解析脚本
│ ├── parse_cdb_input.py # CDB自然语言解析脚本
│ ├── query_cvm_price.py # CVM价格查询脚本
│ ├── query_cdb_price.py # CDB价格查询脚本
│ └── tencent_credentials.py # 共享密钥读取逻辑
└── reference/
└── regions.json # 地域映射表
tencentcloud-sdk-python - 腾讯云 Python SDK```bash
pip install tencentcloud-sdk-python
```
SDK 支持三种凭证配置方式(按优先级)。推荐给小白用户使用方式1。
方式1:本地配置文件(推荐,最容易分享和修改)
credentials.example.jsoncredentials.jsoncredentials.json,把里面的占位文字替换为自己的腾讯云 SecretId 和 SecretKey示例:
{
"secretId": "AKIDxxxxxxxxxxxxxxxx",
"secretKey": "xxxxxxxxxxxxxxxx"
}
credentials.json 已写入 .gitignore,不要把真实密钥发给别人。
方式2:环境变量
Windows CMD:
set TCC_SECRET_ID=你的SecretId
set TCC_SECRET_KEY=你的SecretKey
Windows PowerShell:
$env:TCC_SECRET_ID="你的SecretId"
$env:TCC_SECRET_KEY="你的SecretKey"
macOS / Linux:
export TCC_SECRET_ID=你的SecretId
export TCC_SECRET_KEY=你的SecretKey
方式3:TCCLI 配置文件(自动兼容)
# 如果已配置过 TCCLI,SDK 会自动读取
tccli configure
# 依次输入:SecretId、SecretKey、默认地域(如 ap-guangzhou)、输出格式(json)
配置文件位置:
C:\Users\<用户名>\.tccli\default.credential~/.tccli/default.credential接口名称: InquiryPriceRunInstances
接口描述: 创建实例询价,用于查询创建CVM实例的价格
文档地址:
```bash
pip install tencentcloud-sdk-python
```
复制 credentials.example.json 为 credentials.json,把 secretId 和 secretKey 改成自己的腾讯云密钥。
```bash
python scripts/parse_input.py "南京 SA3 4核8g 50g通用型ssd云硬盘 1M带宽 一年多少钱"
```
```bash
python scripts/query_cvm_price.py params.json
```
```bash
python scripts/parse_cdb_input.py "南京 MySQL云数据库 4核8g 150g硬盘 一年多少钱"
python scripts/query_cdb_price.py tmp_params.json
```
credentials.json、环境变量或 TCCLI 配置文件中,请注意保护credentials.json 或 TCCLI 配置文件读取凭证使用此技能前,请确保满足以下条件:
ResourceUnavailable.InstanceType 错误,可能是账户未开通CVM服务验证账户状态:
# 检查账户中是否有CVM实例
# 如果返回为空,说明账户可能没有CVM实例或未开通服务
本技能允许用户通过自然语言查询腾讯云CDB(云数据库MySQL)的价格。
核心功能:
调用 scripts/parse_cdb_input.py 解析用户输入:
import sys
import os
# 添加scripts目录到Python路径
scripts_dir = os.path.join(os.path.dirname(__file__), 'scripts')
sys.path.insert(0, scripts_dir)
# 导入模块
from parse_cdb_input import parse_input
from query_cdb_price import query_price, format_price
# 解析输入
user_input = "广州4G内存 100G硬盘 一年多少钱"
params = parse_input(user_input)
# 查询价格
price_data = query_price(params)
# 格式化输出
if price_data:
print(format_price(price_data, params))
| 参数 | 说明 | 示例 |
|---|---|---|
| ------ | ------ | ------ |
region | 地域 | ap-guangzhou, ap-shanghai |
zone | 可用区 | ap-guangzhou-3 |
memory | 内存大小(MB,必须是1000的倍数) | 2000, 4000, 8000 |
disk | 硬盘大小(GB) | 50, 100, 200 |
period | 购买时长(月) | 12, 24, 36 |
pay_type | 付费类型 | PRE_PAID(包年包月), HOUR_PAID(按量) |
| 地域 | 默认可用区 | 说明 |
|---|---|---|
| ------ | ----------- | ------ |
| 广州 | ap-guangzhou-3 | 三区(推荐) |
| 北京 | ap-beijing-5 | 五区 |
| 上海 | ap-shanghai-2 | 二区 |
| 南京 | ap-nanjing-3 | 三区 |
| 深圳 | ap-shenzhen-1 | 一区 |
| 成都 | ap-chengdu-2 | 二区 |
| 香港 | ap-hongkong-1 | 一区 |
| 新加坡 | ap-singapore-1 | 一区 |
| 东京 | ap-tokyo-1 | 一区 |
⚠️ 重要:DeviceType 参数决定实例架构类型,必须正确映射!
| 用户输入关键词 | DeviceType | 官网名称 | 说明 |
|---|---|---|---|
| -------------- | ------------ | --------- | ------ |
| 单节点 | CLOUD_NATIVE_CLUSTER | 单节点 | 云数据库MySQL单节点版 |
| 双节点通用型 | UNIVERSAL | 通用型 | 双节点高可用版 |
| 双节点经济型 | ECONOMICAL | 经济型 | 双节点低成本版 |
| 三节点 | UNIVERSAL | 三节点通用型 | 需设 InstanceNodes=3 |
| 独享 | EXCLUSIVE | 独享型 | 独享物理机资源 |
| 云盘版 | BASIC_V2 | 云盘版/基础版 | 单机版另一种形态 |
| 集群版加强 | CLOUD_NATIVE_CLUSTER_EXCLUSIVE | 集群版加强型 | 最高规格集群 |
⚠️ 默认值规则:
UNIVERSAL(双节点通用型)DeviceType=UNIVERSAL,硬盘类型仅支持 LOCAL_SSD经济型是固定配置,CPU、内存、硬盘三者绑定,不可自定义修改!
| CPU核数 | 内存 | 硬盘大小 | 说明 |
|---|---|---|---|
| -------- | ------ | --------- | ------ |
| 1核 | 2GB (2000MB) | 50GB | 最低配置 |
| 2核 | 4GB (4000MB) | 100GB | - |
| 4核 | 8GB (8000MB) | 150GB | - |
| 8核 | 16GB (16000MB) | 200GB | 最高配置 |
| 16核及以上 | ❌ 无经济型 | - | 不支持 |
当用户查询不符合经济型规则时,返回:
双节点经济型MySQL CPU与内存比固定为1:2(当前配置CPU:内存=X:Y,比值不符合)双节点经济型MySQL {cpu}核{memory}G硬盘固定为{disk}GB,已自动修正双节点经济型MySQL最高配置为8核16G,16核及以上没有经济型输入:成都地区 双节点经济型 4核8G 一年多少钱
输出:自动将硬盘修正为150GB(经济型4核8G固定配置)
输入:成都地区 双节点经济型 4核8G 200G硬盘 一年多少钱
输出:⚠️ 双节点经济型MySQL 4核8G硬盘固定为150GB,已自动修正
⚠️ 重要:CDB内存必须是1000的倍数!
⚠️ 换算规则:按整数换算,N G = N * 1000 MB(例如 4G=4000MB、8G=8000MB、16G=16000MB)
| 用户输入 | 解析结果 | 说明 |
|---|---|---|
| ---------- | ---------- | ------ |
| 1G | 1000MB | ✅ |
| 2G | 2000MB | ✅ |
| 4G | 4000MB | ✅ |
| 8G | 8000MB | ✅ |
| 16G | 16000MB | ✅ |
| 32G | 32000MB | ✅ |
示例1:查询广州MySQL价格
输入:查询 广州4G内存 100G硬盘 一年多少钱
输出:
📋 查询配置:
地域: 广州
可用区: ap-guangzhou-3
内存: 3GB
硬盘: 100GB
时长: 12个月
计费类型: 包年包月
💰 价格信息:
原价: ¥5760.00 元
折扣价: ¥4780.80 元
折扣率: 83%
每月均价: ¥398.40 元
节省: ¥979.20 元
示例2:查询上海MySQL价格
输入:查询 上海2G内存 50G硬盘 一年多少钱
示例3:按量计费
输入:查询 广州4G内存 100G硬盘 按量计费
输出:显示小时单价和估算年费
接口名称: DescribeDBPrice
接口描述: 查询CDB数据库新购、续费询价
文档地址:
本技能支持 Redis 新购实例价格查询,典型用户输入:
查询xx地区,Redis 几个分片,分片容量,副本数量,xx年的价格
使用 scripts/parse_redis_input.py 解析参数:
python scripts/parse_redis_input.py "查询广州地区 Redis 3个分片 分片容量4g 2个副本 1年的价格"
使用 scripts/query_redis_price.py 查询:
python scripts/query_redis_price.py '{"region":"ap-guangzhou","type_id":16,"mem_size":4096,"goods_num":1,"period":12,"billing_mode":1,"redis_shard_num":3,"redis_replicas_num":2,"product_version":"local"}'
| 参数 | 说明 |
|---|---|
| ------ | ------ |
region | 地域,例如 ap-guangzhou |
type_id | 实例类型:17=标准架构,16=集群架构;未指定时默认 16(Redis 6.2 集群) |
mem_size | 单分片容量,单位MB,需为1024整数倍 |
redis_shard_num | 分片数量 |
redis_replicas_num | 副本数量 |
period | 购买时长(月),如1年=12 |
billing_mode | 计费方式:1包年包月,0按量 |
InquiryPriceCreateInstance支持轻量应用服务器套餐询价,重点支持:
轻量服务器(或轻量应用服务器/lighthouse)xx地区,xx型,几核几g,多少带宽,xx年的价格
DescribeBundles 获取可售套餐(含套餐ID、核内存、带宽、硬盘)BundleId 调用 InquirePriceCreateInstances 询价解析:
python scripts/parse_lighthouse_input.py "查询广州地区 轻量应用服务器 锐驰型 4核8g 2mbps带宽 1年的价格"
询价:
python scripts/query_lighthouse_price.py '{"region":"ap-guangzhou","bundle_type":"RAZOR_SPEED_BUNDLE","cpu":4,"memory":8,"bandwidth":2,"disk":50,"period":12,"instance_count":1}'
DBVersion 固定为 2022CLOUD_HSSD 对应“增强型SSD云硬盘”解析:
python scripts/parse_sqlserver_input.py "查询广州地区 SQL Server 4核8g 增强型ssd云硬盘200g 1年的价格"
询价:
python scripts/query_sqlserver_price.py '{"region":"ap-guangzhou","cpu":4,"memory":8,"storage":200,"machine_type":"CLOUD_HSSD","db_version":"2022","period":12}'
SQL Server 某些可用区会出现售罄。脚本会自动拉取同地域可用区并逐个尝试询价,命中后返回;若都失败,会输出每个可用区的失败原因,方便快速定位。
共 8 个版本