Gestione modelli

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

Ottimizza un modello

Vertex AI Search per la vendita al dettaglio utilizza i dati di input forniti al modello per regolare gli iperparametri per l'addestramento.

L'ottimizzazione richiede 2-4 giorni, durante i quali il modello continua a funzionare come di consueto. Per i dettagli dei costi di ottimizzazione, consulta la sezione Prezzi.

Imposta la frequenza di ottimizzazione di un modello

Ti consigliamo di ottimizzare periodicamente il modello. Questo consente di ottimizzare l'addestramento del modello man mano che i dati cambiano e il comportamento dei clienti cambia. Inoltre, alcuni upgrade principali interni di modelli possono essere applicati solo dopo l'ottimizzazione del modello.

Durante la creazione del modello, puoi impostarlo in modo che venga ottimizzato automaticamente ogni tre mesi o scegliere di ottimizzarlo manualmente. Indipendentemente dall'impostazione scelta, il modello si ottimizza automaticamente una volta dopo la creazione.

Puoi modificare l'impostazione dello stato dell'ottimizzazione in qualsiasi momento. La modifica di questa 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 vedere lo stato dell'ottimizzazione di ciascun modello nella sezione Stato dell'ottimizzazione.

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

  3. Fai clic su Modifica accanto a Stato ottimizzazione.

  4. Seleziona un'impostazione dall'elenco a discesa:

    • Ogni tre mesi. Sintonizza automaticamente quando l'ultimo brano è avvenuto 90 giorni prima.
    • Solo correzione manuale. Sintonizza solo quando esegui l'ottimizzazione manuale.

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

arricciatura

Effettua una richiesta Models.patch utilizzando l'API. Consulta il riferimento dell'API Models.patch.

Per maggiori dettagli su tutti i campi Models, consulta il riferimento dell'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'

Ottimizza manualmente un modello

L'ottimizzazione manuale attiva un'ottimizzazione una tantum del modello. Potresti ottimizzare manualmente il tuo modello quando si verifica un cambiamento significativo nel catalogo (ad esempio un aumento delle dimensioni o una modifica nella gerarchia del catalogo) o in caso di eventi (come il backfill di eventi storici o una modifica della distribuzione dei dati dopo la promozione di determinati gruppi di articoli).

Per ottimizzare manualmente un modello:

Console

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

    Vai alla pagina Modelli

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

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

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

arricciatura

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

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 un riaddestramento coerente, assicurati di caricare i dati sugli eventi utente non più di 24 ore dopo il verificarsi dell'evento.

Puoi mettere in pausa il modello per interrompere il riaddestramento. Ti consigliamo di eseguire questa operazione se hai importato dati errati o per rimanere entro il 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 dell'addestramento, consulta i prezzi.

Puoi avviare fino a cinque operazioni sul modello 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 di Search for Retail.

    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 FORMAZIONE), fai clic su Metti in pausa .

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

arricciatura

Per mettere in pausa un modello attivo, effettua una richiesta Models.pause utilizzando l'API. Consulta il riferimento dell'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 sia nella console che nella risposta API.

Console

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

    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 visualizzare la relativa pagina Dettagli.

arricciatura

Per ottenere le informazioni di un singolo modello, effettua una richiesta Models.get utilizzando l'API. Consulta il riferimento dell'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 utilizza il metodo API Models.list.

Console

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

    Vai alla pagina Modelli

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

arricciatura

Per elencare tutti i modelli e i relativi dettagli in linea, effettua una richiesta Models.list utilizzando l'API. Consulta il 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 includerà un token di pagina. Puoi passare un token di pagina nel parametro pageToken di una richiesta list per recuperare la pagina dei risultati successiva. L'esempio seguente 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 fino a cinque operazioni sul modello al minuto. Le operazioni limitate nei modelli includono creazione, eliminazione, messa in pausa e ripresa.

Elimina un modello nella console o utilizza il metodo 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 da eliminare per aprire la relativa pagina dei dettagli.

  3. Fai clic su Elimina nella barra dei pulsanti.

  4. Inserisci di nuovo il nome del modello e fai clic su Conferma.

arricciatura

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

Per maggiori dettagli su tutti i campi Models, consulta il riferimento dell'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'