azure-pricing

Azure 定价技能

使用此技能可从公开的 Azure Retail Prices API 检索实时的 Azure 零售定价数据。无需身份验证。

何时使用此技能

• 用户询问 Azure 服务的费用（例如“D4s v5 VM 多少钱？”）
• 用户想要比较不同区域或 SKU 的价格
• 用户需要针对某个工作负载或架构的成本估算
• 用户提到 Azure 定价、Azure 成本或 Azure 计费
• 用户询问预留实例与即用即付定价的对比
• 用户想了解节省计划或现货定价

API 终结点

GET https://prices.azure.com/api/retail/prices?api-version=2023-01-01-preview

使用 OData 筛选语法将 $filter 作为查询参数追加。始终使用 api-version=2023-01-01-preview 以确保包含节省计划数据。

分步说明

如果对用户的请求有任何不清楚之处，请提出澄清性问题，以在调用 API 之前确定正确的筛选字段和值。

1. 从用户请求中识别筛选字段（服务名称、区域、SKU、价格类型）。
2. 解析区域：API 要求 armRegionName 值为小写且不含空格（例如 "East US" → eastus，"West Europe" → westeurope，"Southeast Asia" → southeastasia）。完整列表请参见 references/REGIONS.md。
3. 构建筛选字符串，使用下方字段并获取 URL。
4. 解析 JSON 响应中的 Items 数组。每个项都包含价格和元数据。
5. 通过 NextPageLink 跟进分页，如果你需要超过前 1000 条结果（很少需要）。
6. 计算成本估算，使用 references/COST-ESTIMATOR.md 中的公式生成月度/年度估算。
7. 呈现结果，以清晰的汇总表展示服务、SKU、区域、单价以及月度/年度估算。

可筛选字段

字段	类型	示例
serviceName	字符串（精确匹配，区分大小写）	'Functions'、'Virtual Machines'、'Storage'
serviceFamily	字符串（精确匹配，区分大小写）	'Compute'、'Storage'、'Databases'、'AI + Machine Learning'
armRegionName	字符串（精确匹配，小写）	'eastus'、'westeurope'、'southeastasia'
armSkuName	字符串（精确匹配）	'Standard_D4s_v5'、'Standard_LRS'
skuName	字符串（支持包含匹配）	'D4s v5'
priceType	字符串	'Consumption'、'Reservation'、'DevTestConsumption'
meterName	字符串（支持包含匹配）	'Spot'

使用 eq 表示相等，使用 and 组合条件，使用 contains(field, 'value') 进行部分匹配。

筛选字符串示例

# All consumption prices for Functions in East US
serviceName eq 'Functions' and armRegionName eq 'eastus' and priceType eq 'Consumption'

# D4s v5 VMs in West Europe (consumption only)
armSkuName eq 'Standard_D4s_v5' and armRegionName eq 'westeurope' and priceType eq 'Consumption'

# All storage prices in a region
serviceName eq 'Storage' and armRegionName eq 'eastus'

# Spot pricing for a specific SKU
armSkuName eq 'Standard_D4s_v5' and contains(meterName, 'Spot') and armRegionName eq 'eastus'

# 1-year reservation pricing
serviceName eq 'Virtual Machines' and priceType eq 'Reservation' and armRegionName eq 'eastus'

# Azure AI / OpenAI pricing (now under Foundry Models)
serviceName eq 'Foundry Models' and armRegionName eq 'eastus' and priceType eq 'Consumption'

# Azure Cosmos DB pricing
serviceName eq 'Azure Cosmos DB' and armRegionName eq 'eastus' and priceType eq 'Consumption'

完整示例获取 URL

https://prices.azure.com/api/retail/prices?api-version=2023-01-01-preview&$filter=serviceName eq 'Functions' and armRegionName eq 'eastus' and priceType eq 'Consumption'

构建 URL 时，将空格编码为 %20，将引号编码为 %27。

关键响应字段

{
  "Items": [
    {
      "retailPrice": 0.000016,
      "unitPrice": 0.000016,
      "currencyCode": "USD",
      "unitOfMeasure": "1 Execution",
      "serviceName": "Functions",
      "skuName": "Premium",
      "armRegionName": "eastus",
      "meterName": "vCPU Duration",
      "productName": "Functions",
      "priceType": "Consumption",
      "isPrimaryMeterRegion": true,
      "savingsPlan": [
        { "unitPrice": 0.000012, "term": "1 Year" },
        { "unitPrice": 0.000010, "term": "3 Years" }
      ]
    }
  ],
  "NextPageLink": null,
  "Count": 1
}

除非用户明确要求非主计量，否则只使用 isPrimaryMeterRegion 为 true 的项。

支持的 serviceFamily 值

Analytics、Compute、Containers、Data、Databases、Developer Tools、Integration、Internet of Things、Management and Governance、Networking、Security、Storage、Web、AI + Machine Learning

提示

• serviceName 值区分大小写。不确定时，先按 serviceFamily 筛选，以在结果中发现有效的 serviceName 值。
• 如果结果为空，请尝试放宽筛选条件（例如，先移除 priceType 或区域约束）。
• 除非请求中指定了 currencyCode，否则价格始终以美元为单位。
• 对于节省计划价格，请查看每个项上的 savingsPlan 数组（仅在 2023-01-01-preview 中）。
• 常见服务名称及其正确大小写的目录请参见 references/SERVICE-NAMES.md。
• 成本估算公式和模式请参见 references/COST-ESTIMATOR.md。
• Copilot Studio 计费费率和估算公式请参见 references/COPILOT-STUDIO-RATES.md。

故障排除

问题	解决方案
结果为空	放宽筛选条件 — 首先移除 priceType 或 armRegionName
服务名称错误	使用 serviceFamily 筛选条件来发现有效的 serviceName 值
缺少节省计划数据	确保 URL 中包含 api-version=2023-01-01-preview
URL 错误	检查 URL 编码 — 空格为 %20，引号为 %27
结果过多	添加更多筛选字段（区域、SKU、priceType）以缩小范围

---

Copilot Studio Agent 使用量估算

当用户询问 Copilot Studio 定价、Copilot 点数或 Agent 使用成本时，请使用本节内容。

何时使用本节

• 用户询问 Copilot Studio 定价或成本
• 用户询问 Copilot 点数或 Agent 点数消耗
• 用户想要估算 Copilot Studio Agent 的月度成本
• 用户提到 Agent 使用量估算或 Copilot Studio 估算器
• 用户询问运行一个 Agent 需要多少成本

关键事实

• 1 Copilot 点数 = $0.01 USD
• 点数在整个租户内共享
• 面向员工且拥有 M365 Copilot 许可用户的 Agent 可免费获得经典答案、生成式答案和租户图谱落地
• 超额执行在预付容量的 125% 时触发

分步估算

1. 收集输入 从用户处获取：Agent 类型（员工/客户）、用户数量、每月交互次数、知识占比 %、租户图谱占比 %、每会话工具使用次数。
2. 获取实时计费费率 — 使用内置的网页获取工具从下面列出的 URL 下载最新费率。这确保估算始终使用最新的 Microsoft 定价。
3. 解析获取的内容 以提取当前计费费率表（每种功能类型的点数）。
4. 计算估算值 使用获取内容中的费率和公式：
   • total_sessions = users × interactions_per_month
   • 知识点数：应用租户图谱落地费率、生成式答案费率和经典答案费率
   • Agent 工具点数：按每次工具调用应用 Agent 操作费率
   • Agent 流点数：按每 100 次操作应用流费率
   • 提示词修饰符点数：按每 10 次响应应用基础/标准/高级费率
5. 呈现结果 以清晰的表格形式，包含按类别细分、总点数和估算的 USD 成本。

要获取的源 URL

回答 Copilot Studio 定价问题时，请从这些 URL 获取最新内容作为上下文：

URL	内容
https://learn.microsoft.com/en-us/microsoft-copilot-studio/requirements-messages-management	计费费率表、计费示例、超额执行规则
https://learn.microsoft.com/en-us/microsoft-copilot-studio/billing-licensing	许可选项、M365 Copilot 包含内容、预付与即用即付

在计算之前，至少获取第一个 URL（计费费率）。第二个 URL 为许可问题提供补充上下文。

有关费率、公式和计费示例的缓存快照，请参阅 references/COPILOT-STUDIO-RATES.md（如果网页获取不可用，可作为回退方案）。