Modelle verwalten

Auf dieser Seite wird beschrieben, wie Sie Empfehlungsmodelle optimieren, pausieren, fortsetzen, löschen und auflisten. Informationen zum Erstellen eines neuen Empfehlungsmodells finden Sie unter Empfehlungsmodelle erstellen.

Modell abstimmen

Vertex AI Search für den Einzelhandel verwendet die von Ihnen für Ihr Modell bereitgestellten Eingabedaten, um Hyperparameter für das Training anzupassen.

Die Optimierung dauert zwei bis vier Tage, während der das Modell wie gewohnt funktioniert. Weitere Informationen zu den Optimierungskosten finden Sie unter Preise.

Optimierungshäufigkeit eines Modells festlegen

Wir empfehlen daher, das Modell regelmäßig zu optimieren. So bleibt das Modelltraining optimal, da sich die Daten im Laufe des Jahres ändern und das Kundenverhalten variiert. Außerdem können einige interne umfangreiche Modellupgrades erst angewendet werden, nachdem das Modell optimiert wurde.

Bei der Erstellung des Modells können Sie festlegen, dass es alle drei Monate automatisch optimiert wird, oder Sie können es ausschließlich manuell optimieren. Unabhängig von der ausgewählten Einstellung wird das Modell nach der Erstellung automatisch optimiert.

Sie können die Einstellung des Optimierungsstatus jederzeit ändern. Eine Änderung dieser Einstellung wirkt sich nicht auf aktuell ausgeführte Optimierungsprozesse aus.

So bearbeiten Sie die Einstellung des Optimierungsstatus eines Modells:

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Modelle auf.

    Zur Seite „Modelle“

    Sie können den Optimierungsstatus jedes Modells unter Optimierungsstatus einsehen.

  2. Klicken Sie auf einen Modellnamen, um die zugehörige Detailseite anzusehen.

  3. Klicken Sie neben Optimierungsstatus auf Bearbeiten .

  4. Wählen Sie aus der Drop-down-Liste eine Einstellung aus:

    • Alle drei Monate. Automatisch optimieren, wenn die letzte Optimierung vor 90 Tagen vorgenommen wurde.
    • Nur manuelle Optimierung. Wird nur optimiert, wenn Sie manuell optimieren.

  5. Klicken Sie auf Fertig , um die Einstellung zu speichern.

curl

Senden Sie eine Models.patch-Anfrage über die API. Weitere Informationen finden Sie in der Models.patch API-Referenz.

Weitere Informationen zu allen Models-Feldern finden Sie in der Models API-Referenz.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID",
  "PeriodicTuningState": "NEW_TUNING_STATE_VALUE"
}' \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID?updateMask=PeriodicTuningState'

Modell manuell optimieren

Die manuelle Optimierung löst eine einmalige Optimierung Ihres Modells aus. Sie können Ihr Modell manuell optimieren, wenn es eine signifikante Änderung in Ihrem Katalog (z. B. Vergrößerung oder Änderung der Kataloghierarchie) oder bei Ereignissen (z. B. ein Backfill vergangener Ereignisse oder eine Änderung der Datenverteilung nach dem Verschieben bestimmter Artikelgruppen) gibt.

So optimieren Sie ein Modell manuell:

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Modelle auf.

    Zur Seite „Modelle“

  2. Klicken Sie auf einen Modellnamen, um die zugehörige Detailseite anzusehen.

  3. Klicken Sie in der Schaltflächenleiste auf Manuelle Optimierung.

    Die Optimierung dauert zwei bis vier Tage, während der das Modell wie gewohnt funktioniert.

curl

Stelle eine Models.tune-Anfrage über die API. Weitere Informationen finden Sie in der Models.tune API-Referenz.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:tune'

Training für ein Modell anhalten und fortsetzen

Wenn Ihr Modell aktiv ist (nicht pausiert), wird das Modell mindestens einmal pro Woche neu trainiert, jedoch nicht häufiger als einmal täglich. Für ein konsistentes erneutes Training müssen Sie Nutzerereignisdaten spätestens 24 Stunden nach dem Ereignis hochladen.

Sie können Ihr Modell pausieren, um das erneute Training zu beenden. Dies kann sinnvoll sein, wenn Sie fehlerhafte Daten importiert haben oder um die Grenze von 10 aktiven Modellen pro Projekt nicht zu überschreiten. Wenn Sie weniger als 10 aktive Modelle haben, können Sie ein pausiertes Modell jederzeit neu starten.

Weitere Informationen zu Trainingskosten finden Sie unter Preise.

Sie können bis zu fünf Modellvorgänge pro Minute starten. Zu den eingeschränkten Modellvorgängen gehören das Erstellen, Löschen, Anhalten und Fortsetzen.

So pausieren Sie ein Modell an oder starten es neu:

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Modelle auf.

    Zur Seite „Modelle“

    Sie können den Trainingsstatus jedes Modells unter Trainingsstatus sehen.

  2. Klicken Sie zum Pausieren eines aktiven Modells (Trainingsstatus von TRAINING) auf Pausieren .

  3. Klicken Sie zum Starten eines pausierten Modells (Trainingsstatus von PAUSIERT) auf Fortsetzen .

curl

Wenn Sie ein aktives Modell pausieren möchten, senden Sie eine Models.pause-Anfrage über die API. Weitere Informationen finden Sie in der Models.pause API-Referenz.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:pause'

Wenn Sie ein pausiertes Modell starten möchten, senden Sie eine Models.resume-Anfrage über die API.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:resume'

Modelldetails ansehen

Sie können die Details eines Modells in der Console oder mit der Models.get API-Methode aufrufen.

Wenn Sie die Bereitstellungskonfigurationen sehen möchten, die mit einem bestimmten Modell verknüpft sind, verwenden Sie die folgende Anleitung für die Google Console. Alle anderen Modelldetails sind sowohl in der Console als auch in der API-Antwort verfügbar.

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Modelle auf.

    Zur Seite „Modelle“

  2. Auf der Seite Modelle sind alle Ihre Modelle und deren Trainings- und Abfragestatus aufgeführt.

  3. Klicken Sie auf einen Modellnamen, um die Seite Details aufzurufen.

curl

Wenn Sie Informationen zu einem einzelnen Modell abrufen möchten, senden Sie eine Models.get-Anfrage über die API. Weitere Informationen finden Sie in der Models.get API-Referenz.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'

Modelle auflisten

Eine Liste Ihrer Modelle finden Sie in der Console oder mithilfe der Models.list API-Methode.

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Modelle auf.

    Zur Seite „Modelle“

  2. Auf der Seite Modelle sind alle Ihre Modelle und deren Trainings- und Abfragestatus aufgeführt.

curl

Wenn Sie alle Modelle und ihre Details inline auflisten möchten, senden Sie eine Models.list-Anfrage über die API. Weitere Informationen finden Sie in der Models.list API-Referenz.

Optional können Sie mit dem Parameter pageSize eine maximale Anzahl von Ergebnissen festlegen, die zurückgegeben werden sollen. Wenn weitere Ergebnisse verfügbar sind, enthält die list-Antwort ein Seitentoken. Sie können ein Seitentoken im Parameter pageToken einer list-Anfrage übergeben, um die nächste Ergebnisseite abzurufen. Im folgenden Beispiel werden beide Parameter verwendet.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

Modell löschen

Sie können bis zu fünf Modellvorgänge pro Minute starten. Zu den eingeschränkten Modellvorgängen gehören das Erstellen, Löschen, Anhalten und Fortsetzen.

Löschen Sie ein Modell in der Console oder mit der Models.delete API-Methode.

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Modelle auf.

    Zur Seite „Modelle“

  2. Klicken Sie auf den Namen des Modells, das Sie löschen möchten, um die Detailseite zu öffnen.

  3. Klicken Sie in der Schaltflächenleiste auf Löschen.

  4. Geben Sie den Modellnamen noch einmal ein und klicken Sie auf Bestätigen.

curl

Senden Sie eine Models.delete-Anfrage über die API. Weitere Informationen finden Sie in der Models.delete API-Referenz.

Weitere Informationen zu allen Models-Feldern finden Sie in der Models API-Referenz.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'