Udløs modelleringscyklussen manuelt

Artikel
10/07/2024

Denne artikel er en vejledning til udviklere, der vil bruge værktøjet "Modellér nu" – en fremgangsmåde til at udløse en behandlingscyklus manuelt for deres modelleringsressource.

Når der er oprettet og installeret en modelleringsressource, fortsætter tjenesten Intelligent Recommendations med at behandle data via en periodisk databehandlingscyklus. Som standard gennemføres databehandlingscyklussen hver 36. time.

Du kan vælge at udløse modelleringscyklussen manuelt (med visse begrænsninger) forud for standardtidsplanen på 36 timer. Årsager til en ekstra standardmodelleringsproces kan skyldes finjustering af data i sidste øjeblik eller fejl i datakonfigurationen i Azure Data Lake Storage.

Hvis du vil udløse modelleringsprocessen manuelt, skal du bruge det API-kald, der er beskrevet i denne artikel.

Sådan udløses modelleringsprocessen manuelt

Udløse en modelcyklus med Insomnia

Følgende POST-anmodning starter en ny modelleringscyklus:

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

Du kan finde dit slutpunkts-URL-adresse ved hjælp af trinnene i startvejledningen til visning af anbefalingsresultater.

Begrænsninger med manuel udløsning af modelleringsprocessen

Der er et par begrænsninger, du skal huske på for at udløse modelleringsprocessen manuelt:

En bruger kan udføre en ny Modellér nu-POST-anmodning hvert 30. minut.
En bruger kan maksimalt foretage fem POST-anmodninger pr. 24 timer (rullevindue).
Modelleringsparameteren betragtes som valgfri. Hvis du ikke har angivet parametre, udløses standardmodelleringsressourcen.
På samme måde som alle andre API-kald er udløsningen af modelleringsprocessen med POST-anmodningen et godkendt kald til Intelligent Recommendations-slutpunktet, så du skal inkludere godkendelsesoplysningerne. Du kan finde flere oplysninger i Startvejledning til godkendte API-kald.

Eksempler på API-svar

Udført-meddelelse

Et vellykket svar omfatter en meddelelse om en vellykket handling:

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

Fejlmeddelelse

Der kan opstå en fejlmeddelelse:

Hvis der allerede er en behandlingscyklus i gang
Hvis der er sendt for mange forespørgsler om udløsere, som overskrider den tilladte hyppighed (maks. 5 forsøg hver 24. time eller mere end én gang inden for 30 minutter).

Fejlmeddelelsen ser således ud:

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

Du kan få mere at vide om andre fejlmeddelelser, der kan forekomme under modelleringsprocessen, under Fejllogfiler.

Se også

Oversigt over datakontrakt
Startvejledning: Opret en API-anmodning
Startvejledning: Konfigurer og kør intelligente anbefalinger med prøvedata
Oversigt over udrulning

Del via