Gestione modelli

Questa pagina descrive come ottimizzare, mettere in pausa, riprendere, eliminare ed elencare i modelli di consigli. Per assistenza nella creazione di un nuovo modello di suggerimenti, consulta Creare modelli di suggerimenti.

Ottimizza un modello

Vertex AI Search for Retail utilizza i dati di input che fornisci al modello per regolare gli iperparametri per l'addestramento.

L'ottimizzazione richiede 2-4 giorni, durante i quali il modello continua a funzionare normalmente. Per i dettagli sui costi di ottimizzazione, consulta la pagina Prezzi.

Impostare la frequenza di ottimizzazione di un modello

Ti consigliamo di ottimizzare periodicamente il tuo modello. In questo modo, l'addestramento del modello rimane ottimale poiché i dati cambiano e il comportamento dei clienti varia nel corso dell'anno. Inoltre, alcuni upgrade principali dei modelli interni possono essere applicati solo dopo che il modello è stato ottimizzato.

Quando crei il modello, puoi impostarlo in modo che venga ottimizzato automaticamente ogni tre mesi o scegli di ottimizzarlo solo manualmente. Indipendentemente dall'impostazione scelta, il modello viene ottimizzato automaticamente una volta dopo la creazione.

Puoi modificare l'impostazione dello stato di ottimizzazione in qualsiasi momento. Modifica dell'impostazione non influisce sui processi di ottimizzazione attualmente in esecuzione.

Per modificare l'impostazione dello stato di ottimizzazione di un modello:

Console

  1. Vai alla pagina Modelli nella console di Search for Retail.

    Vai alla pagina Modelli

    Puoi visualizzare lo stato della regolazione di ogni modello in Stato regolazione.

  2. Fai clic sul nome di un modello per visualizzarne la pagina dei dettagli.

  3. Fai clic su Modifica accanto a Ottimizzazione .

  4. Nell'elenco a discesa, seleziona un'impostazione:

    • Ogni tre mesi. Si sintonizza automaticamente se l'ultima sintonizzazione è avvenuta 90 giorni fa.
    • Solo correzione manuale. Esegue la sintonizzazione solo quando esegui la sintonizzazione manuale.

  5. Fai clic su Fine per salvare l'impostazione.

curl

Effettua una richiesta Models.patch utilizzando l'API. Consulta le Riferimento API di Models.patch.

Per maggiori dettagli su tutti i campi Models, consulta le Riferimento API Models.

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'

Ottimizzare manualmente un modello

L'ottimizzazione manuale attiva un'ottimizzazione una tantum del modello. Puoi ottimizzare manualmente modello quando c'è una modifica significativa nel catalogo (come un aumento delle dimensioni o una modifica nella gerarchia del catalogo) o eventi (come il backfill di eventi storici) o una modifica nella distribuzione dei dati dopo la promozione di determinati gruppi di elementi).

Per ottimizzare manualmente un modello:

Console

  1. Vai alla pagina Modelli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Modelli

  2. Fai clic sul nome di un modello per visualizzare la relativa pagina dei dettagli.

  3. Fai clic su Sintonizzazione manuale nella barra dei pulsanti.

    L'ottimizzazione richiede 2-4 giorni, durante i quali il modello continua a funzionare normalmente.

curl

Effettua una richiesta Models.tune utilizzando l'API. Consulta le Riferimento API di Models.tune.

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'

Metti in pausa e riprendi l'addestramento di un modello

Se il modello è attivo (non in pausa), viene riaddestrato almeno una volta alla settimana, ma non più di una volta al giorno. Per una ricollocazione coerente, assicurati di caricare i dati sugli eventi utente non più di 24 ore dopo l'evento.

Per interrompere il riaddestramento, puoi mettere in pausa il modello. Ti consigliamo di farlo se hai importato dati errati o rimanere al di sotto del limite di 10 modelli attivi per progetto. Se hai meno di dieci modelli attivi, puoi riavviare un modello in pausa in qualsiasi momento.

Per i dettagli sui costi della formazione, consulta la pagina Prezzi.

Puoi avviare un massimo di cinque operazioni nei modelli al minuto. Le operazioni limitate nei modelli includono creazione, eliminazione, messa in pausa e ripresa.

Per mettere in pausa o riavviare un modello:

Console

  1. Vai alla pagina Modelli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Modelli

    Puoi visualizzare lo stato di addestramento di ogni modello in Stato addestramento.

  2. Per mettere in pausa un modello attivo (Stato di addestramento di ADDESTRAMENTO), fai clic su Metti in pausa .

  3. Per avviare un modello in pausa (Stato addestramento IN PAUSA), fai clic su Riprendi .

curl

Per mettere in pausa un modello attivo, invia una richiesta Models.pause utilizzando l'API. Consulta il riferimento all'API Models.pause.

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'

Per avviare un modello in pausa, effettua una richiesta Models.resume utilizzando l'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'

Visualizza dettagli modello

Visualizza i dettagli di un modello nella console o utilizzando il metodo API Models.get.

Per visualizzare le configurazioni di pubblicazione associate a un modello specifico, utilizza la procedura della console riportata di seguito. Tutti gli altri dettagli del modello sono disponibili nella e la risposta dell'API.

Console

  1. Vai alla pagina Modelli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Modelli

  2. La pagina Modelli elenca tutti i tuoi modelli e i relativi addestramento e query stati.

  3. Fai clic sul nome di un modello per visualizzare la pagina Dettagli.

curl

Per ottenere le informazioni di un singolo modello, invia una richiesta Models.get utilizzando l'API. Consulta il riferimento all'API Models.get.

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'

Elenca i tuoi modelli

Visualizza un elenco dei tuoi modelli nella console o utilizzando il metodo dell'API Models.list.

Console

  1. Vai alla pagina Modelli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Modelli

  2. La pagina Modelli elenca tutti i tuoi modelli e i relativi addestramento e query stati.

curl

Per elencare tutti i modelli e i relativi dettagli in linea, effettua una richiesta Models.list utilizzando l'API. Vedi l'API Models.list riferimento.

Facoltativamente, puoi utilizzare il parametro pageSize per impostare un numero massimo di risultati da restituire. Se sono disponibili più risultati, viene visualizzata la risposta list. include un token di pagina. Puoi passare un token di pagina nel parametro pageToken di una richiesta list per recuperare la pagina di risultati successiva. La l'esempio riportato di seguito utilizza entrambi i parametri.

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'

Eliminazione di un modello

Puoi avviare un massimo di cinque operazioni nei modelli al minuto. Le operazioni limitate nei modelli includono creazione, eliminazione, messa in pausa e ripresa.

Elimina un modello nella console o utilizzando il metodo dell'API Models.delete.

Console

  1. Vai alla pagina Modelli nella console di Search for Retail.

    Vai alla pagina Modelli

  2. Fai clic sul nome del modello che vuoi eliminare per aprire la relativa pagina dei dettagli.

  3. Fai clic su Elimina nella barra dei pulsanti.

  4. Reinserisci il nome del modello e fai clic su Conferma.

curl

Effettua una richiesta Models.delete utilizzando l'API. Consulta il riferimento all'API Models.delete.

Per informazioni dettagliate su tutti i campi Models, consulta il riferimento all'API Models.

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'