手動觸發建模週期
本文可指導想要使用「立即模型」工具 (一種手動觸發其建模資源調製週期的方法) 的開發人員。
建立並部署模型資源之後，智慧建議服務會繼續透過定期調製週期來處理資料。 根據預設，資料調製週期會每隔 36 小時一輪。
您可以選擇在預設的 36 小時排程之前手動觸發建模週期 (有一些限制)。 預設模型推送的原因可能是由於最後時刻的資料微調，或是由於 Azure Data Lake Storage 中的資料設定錯誤。
若要手動觸發建模程序，請使用本文所述的 API 呼叫。
如何手動觸發建模程序
使用 Insomnia 觸發建立模型週期
下列 POST 要求會開始新的建模週期：
https://<your-endpoint-url>/Control/V1.0/Model?modeling=<your-modeling-name>
您可以使用查看建議結果快速入門手冊中的步驟尋找端點 URL。
手動觸發建模程序的限制
手動觸發建模程序時，需要注意一些限制：
使用者可以每 30 分鐘執行一次新的立即建模 POST 要求。
使用者每 24 小時 (滾動時間範圍) 最多可以發出 5 個 POST 要求。
建模參數視為選用。 如果沒有指定任何參數，則會觸發預設模型資源。
與所有其他 API 呼叫類似，使用 POST 要求觸發模型建立程序是對智慧建議端點進行的已驗證呼叫，因此必須包含驗證詳細資料。 如需詳細資訊，請參閱進行已驗證 API 呼叫的快速入門手冊。
API 回覆範例
成功訊息
成功的回覆會包含成功訊息：
{
"status": "Success",
"environmentId": "your env id will be written here",
"version": "20210930173241" // this is the timestamp of the trigger
}
Error message
可能會出現錯誤訊息：
- 如果調製週期已在進行中
- 如果傳送的觸發要求太多，超過了允許的頻率 (每 24 小時最多 5 次嘗試，或每隔 30 分鐘多次)。
錯誤訊息看見像這樣：
{
"error": {
"code": "TooManyRequests",
"message": "Too many requests"
}
}
若要進一步了解建模程序中可能發生的其他錯誤訊息，請參閱錯誤記錄。