azure-pricing

Azure 定价技能

使用此技能从公共 Azure 零售价格 API 获取实时 Azure 零售定价数据。无需身份验证。

何时使用此技能

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

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. 如果需要超过前 1000 个结果，则通过 NextPageLink 进行分页（很少需要）。
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') 进行部分匹配。

筛选字符串示例

# 美国东部 Functions 的所有消费价格
serviceName eq 'Functions' and armRegionName eq 'eastus' and priceType eq 'Consumption'

# 西欧的 D4s v5 VM（仅消费）
armSkuName eq 'Standard_D4s_v5' and armRegionName eq 'westeurope' and priceType eq 'Consumption'

# 某个区域的所有存储价格
serviceName eq 'Storage' and armRegionName eq 'eastus'

# 特定 SKU 的 Spot 定价
armSkuName eq 'Standard_D4s_v5' and contains(meterName, 'Spot') and armRegionName eq 'eastus'

# 1 年预留定价
serviceName eq 'Virtual Machines' and priceType eq 'Reservation' and armRegionName eq 'eastus'

# Azure AI / OpenAI 定价（现在属于 Foundry Models）
serviceName eq 'Foundry Models' and armRegionName eq 'eastus' and priceType eq 'Consumption'

# Azure Cosmos DB 定价
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 代理使用估算

当用户询问 Copilot Studio 定价、Copilot 信用或代理使用成本时，使用此部分。

何时使用此部分

• 用户询问 Copilot Studio 定价或成本
• 用户询问 Copilot 信用或代理信用消耗
• 用户想要估算 Copilot Studio 代理的月度成本
• 用户提及代理使用估算或 Copilot Studio 估算器
• 用户询问运行代理的成本

关键事实

• 1 Copilot 信用 = 0.01 美元
• 信用在整个租户中池化
• 面向员工且拥有 M365 Copilot 许可用户的代理，经典答案、生成式答案和租户图接地免费
• 超额执行触发点为预付容量的 125%

分步估算

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

要获取的源 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 获取费率和计费示例的缓存快照（如果 Web 获取不可用，则作为备用）。