Udostępnij za pośrednictwem

Ręczne wywoływanie cyklu modelowania

  • Artykuł

Ten artykuł jest przewodnikiem dla deweloperów, którzy chcą używać narzędzia „Modeluj teraz” — sposobu ręcznego wyzwalania cyklu cyklowego dla zasobów modelowych.

Po utworzeniu i wdrożeniu zasobu modelowania usługa inteligentnych rekomendacji będzie nadal przetwarzać dane w cyklu okresowym. Domyślnie cykl cykl życia danych występuje co 36 godzin.

Użytkownik może ręcznie wyzwolić cykl modelowania (z pewnymi ograniczeniami) przed domyślnym 36-godzinnym harmonogramem. Przyczyny domyślnego wypychania modelowania mogą być efektem dostrojenia danych w ostatniej chwili lub z powodu błędów w konfiguracji danych Azure Data Lake Storage.

Aby ręcznie wyzwolić proces modelowania, użyj wywołania interfejsu API opisanego w tym artykule.

Jak ręcznie wyzwolić proces modelowania

Wyzwalanie cyklu modelowania przy użyciu Insomnia

Następujące żądanie postu rozpoczyna nowy cykl modelowania:

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

Adres URL tego punkt końcowy, korzystając z kroków, które zawiera przewodnik Szybki start, umożliwia zobaczenie wyników zalecenia.

Ograniczenia związane z ręcznym wyzwoleniem procesu modelowania

Należy pamiętać o kilku ograniczeniach dotyczących ręcznego wyzwalania procesu modelowania:

  • Użytkownik może wykonać żądanie nowego POST Modeluj teraz co 30 minut.

  • Użytkownik może wykonać 5 żądań POST na 24 godziny (okno rolling).

  • Parametr modelowania jest uważany za opcjonalny. Jeśli nie określisz parametrów, jest wyzwalany domyślny zasób modelowania.

  • Podobnie jak we wszystkich innych wywołaniach interfejsów API, wyzwolenie procesu modelowania przy użyciu żądania POST jest uwierzytelnionym wywoływaniem Intelligent Recommendations punkt końcowy, więc musisz dołączyć szczegóły uwierzytelniania. Aby uzyskać więcej informacji, zobacz Przewodnik Szybki start w przypadku uwierzytelnionych wywołań interfejsu API.

Przykładowa odpowiedź API

Komunikat dotyczący sukcesu

Udana odpowiedź zawiera komunikat o sukcesie:

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

Error message

Może zostać wyświetlony komunikat o błędzie:

  • Jeśli cykl gotowania jest już w toku
  • Jeśli wysłano zbyt wiele żądań wyzwalania, które przekroczą dozwoloną częstotliwość (maksymy 5 prób co 24 godziny lub więcej niż raz na 30 minut).

Komunikat o błędzie wygląda tak:

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

Aby dowiedzieć się więcej o innych komunikatach o błędach, które mogą wystąpić w procesie modelowania, zobacz Dzienniki błędów.

Zobacz też

Omówienie kontraktu danych
Przewodnik szybkiego startu: Tworzenie żądania API
Przewodnik szybkiego startu: Skonfiguruj i uruchom Intelligent Recommendations z przykładowymi danymi
Omówienie wdrażania