azure-pricing

Azure 定價技能

使用此技能從公開的 Azure 零售價格 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. 處理分頁：如果需要超過前 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 的競價定價
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 以取得成本估算公式和模式。
• 請參閱 references/COPILOT-STUDIO-RATES.md 以取得 Copilot Studio 計費費率和估算公式。

疑難排解

問題	解決方案
結果為空	放寬篩選條件 — 先移除 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. 取得即時計費費率 — 使用內建的網路擷取工具從下方列出的來源 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 以取得費率、公式和計費範例的快照（若網路擷取無法使用，則作為備用）。