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 per il retail utilizza i dati di input forniti al modello per aggiustare 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 modello. In questo modo, l'addestramento del modello rimane ottimale poiché i dati cambiano e il comportamento dei clienti è diverso 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 per la regolazione automatica ogni tre mesi o scegliere di regolarlo solo manualmente. Indipendentemente dall'impostazione scelta, il modello viene ottimizzato automaticamente una volta dopo la creazione.

Puoi modificare l'impostazione dello stato della sintonizzazione in qualsiasi momento. La modifica di questa impostazione non influisce sui processi di ottimizzazione in esecuzione.

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

Console

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

    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 Stato sintonizzazione.

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

    • Ogni tre mesi. Si sintonizza automaticamente se l'ultima sintonizzazione risale a 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

Fai una richiesta Models.patch utilizzando l'API. Consulta il riferimento all'API Models.patch.

Per informazioni dettagliate su tutti i campi Models, consulta il riferimento all'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. Potresti ottimizzare manualmente il modello quando si verifica una variazione significativa nel catalogo (ad esempio un aumento delle dimensioni o una modifica nella gerarchia del catalogo) o negli eventi (ad esempio il backfill degli eventi storici o una variazione nella distribuzione dei dati dopo la promozione di determinati gruppi di articoli).

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 visualizzarne la 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

Fai una richiesta Models.tune utilizzando l'API. Consulta il riferimento all'API 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'

Mettere in pausa e riprendere l'addestramento di un modello

Se il modello è attivo (non in pausa), viene sottoposto a ricodificazione 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.

Puoi mettere in pausa il modello per interrompere la riaddestramento. Ti consigliamo di eseguire questa operazione se hai importato dati errati o se vuoi rimanere al di sotto del limite di 10 modelli attivi per progetto. Se hai meno di 10 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 addestramento 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 dell'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 sia nella console sia nella 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 stati di addestramento e query.

  3. Fai clic sul nome di un modello per visualizzarne 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 stati di addestramento e query.

curl

Per elencare tutti i modelli e i relativi dettagli in linea, effettua una richiesta Models.list utilizzando l'API. Consulta la documentazione di riferimento dell'API Models.list.

Facoltativamente, puoi utilizzare il parametro pageSize per impostare un numero massimo di risultati da restituire. Se sono disponibili altri risultati, la risposta list include un token pagina. Puoi passare un token di pagina nel parametro pageToken di una richiesta list per recuperare la pagina di risultati successiva. 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 Ricerca per la vendita al dettaglio.

    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

Invia 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'