Utlös modellcykeln manuellt

Artikel
10/07/2024

Den här artikeln vägleder utvecklare som vill använda verktyget "Modell nu" – ett sätt manuellt för sina modelleringsresurser.

När en modellresurs har skapats och distribuerats fortsätter tjänsten Intelligent Recommendations kommer att fortsätta bearbeta data genom en periodisk livscykel. Som standard sker datacykeln var 36:e timme.

Du kan välja att manuellt utlösa modellcykeln (med vissa begränsningar) före standardschemat på 36 timmar. Orsaker till en standardmodellerings-push kan bero på finjustering av data i sista minuten eller som ett resultat av datakonfigurationsfel i Azure Data Lake Storage.

Om du vill utlösa modellprocessen manuellt använder du API-anropet som beskrivs i den här artikeln.

Utlösa modellprocessen manuellt

Utlösa en modelleringscykel Insomnia

Följande POST-begäran startar en ny modelleringscykel:

https://<your-endpoint-url>/Control/V1.0/Model?modeling=<your-modeling-name>

Du hittar information slutpunkt URL:en i stegen i snabbstartsguiden för att se rekommendationers resultat.

Begränsningar med att manuellt utlösa modellprocessen

Det finns några begränsningar att tänka på när du utlöser modellprocessen manuellt:

En användare kan köra en ny Modell nu POST begäran var 30:e minut.
En användare kan göra ett maxantal på 5 POST-förfrågningar per 24 timmar (rullningsfönster).
Modellparametern anses vara valfri. Om du inte har angett några parametrar kommer standardmodellresursen att aktiveras.
Precis som med andra API-anrop utlöser modellprocessen med POST-begäran ett autentiserat samtal till Intelligent Recommendations slutpunkt, så du måste ta med autentiseringsinformationen. Mer information finns i Snabbstartsguide för autentiserade API-anrop.

API-exempelsvar

Framgångsmeddelande

Ett framgångsrikt svar innehåller följande meddelande:

{
    "status": "Success",
    "environmentId": "your env id will be written here",
    "version": "20210930173241" // this is the timestamp of the trigger
}

Felmeddelande

Ett felmeddelande kan visas:

Om en arbetscykel redan pågår
Om alltför många utlösarförfrågningar skickas överstiger den tillåtna frekvensen (max 5 försök var 24:e timme, eller mer än en gång per 30-minuter fönster).

Felmeddelandet ser ut så här:

{
    "error": {
        "code": "TooManyRequests",
        "message": "Too many requests"
    }
}

Mer information om andra felmeddelanden som kan uppstå under modellprocessen finns i Felloggar.

Se även

Översikt över datakontrakt
Snabbstartsguide: Skapa en API-begäran
Konfigurera och köra Intelligent Recommendations med översikt över exempeldatadistribution
Distributionsöversikt

Dela via