Gestione modelli

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

Consigli generali per la qualità dei modelli

In genere, gli eventi devono essere caricati almeno una volta al giorno per mantenere una buona qualità dei dati.

  • Limiti di età dei dati: gli eventi utente precedenti al 2015 non sono accettati. Per i suggerimenti di apprendimento automatico, il sistema utilizza gli eventi utente degli ultimi 180 giorni. Allo stesso modo, le metriche per gli eventi utente precedenti a 180 giorni o generati più di 180 giorni fa non sono esportabili.

  • ID visitatore univoco: il numero totale di ID visitatore unico per ogni tipo di evento deve essere almeno 100 per garantire dati sufficienti per risultati di qualità.

La maggior parte dei modelli funziona al meglio con almeno tre mesi di visualizzazioni delle pagine di prodotto, visualizzazioni della home page ed eventi add-to-cart.

Per il modello Acquistati frequentemente insieme, è consigliabile avere una cronologia acquisti di uno o due anni. Questo modello richiede in modo specifico uno dei seguenti elementi:

  • In media, 10 occorrenze per voce di catalogo (con una finestra di un anno di eventi di completamento dell'acquisto).

  • Sia 90 giorni di eventi di completamento dell'acquisto nell'ultimo anno sia 1000 eventi di completamento dell'acquisto nello stesso anno.

Una o due settimane di visualizzazioni delle pagine dei dettagli possono essere sufficienti per iniziare l'addestramento dei modelli Altri articoli che potrebbero interessarti e Consigliati per te.

Ottimizzare un modello

AI Commerce Search 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 come di consueto. Per i dettagli sui costi di ottimizzazione, consulta 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 man mano che i dati cambiano e il comportamento dei clienti varia nel corso dell'anno. Inoltre, alcuni upgrade interni importanti dei modelli 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 oppure scegliere 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. 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 AI Commerce Search in Gemini Enterprise for Customer Experience.

    Vai alla pagina Modelli

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

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

  3. Fai clic su Modifica accanto a Stato di ottimizzazione.

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

    • Ogni tre mesi. Viene ottimizzato automaticamente quando l'ultima ottimizzazione risale a 90 giorni fa.
    • Solo correzione manuale. Viene ottimizzato solo quando esegui l'ottimizzazione manuale.

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

curl

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

Per i dettagli su tutti i Models campi, consulta il Models riferimento API.

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 modifica significativa nel catalogo (ad esempio un aumento delle dimensioni o una modifica della gerarchia del catalogo) o negli eventi (ad esempio il backfill degli 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 AI Commerce Search in Gemini Enterprise for Customer Experience.

    Vai alla pagina Modelli

  2. Fai clic sul nome di un modello per visualizzarne la 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.

curl

Effettua una richiesta Models.tune utilizzando l'API. Consulta il riferimento 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 riaddestrato almeno una volta alla settimana, ma non più di una volta al giorno. Per un riaddestramento coerente, assicurati di caricare i dati degli eventi utente entro 24 ore dalla loro occorrenza.

Puoi mettere in pausa il modello per interrompere il riaddestramento. Potresti volerlo fare 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 di addestramento, consulta 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 AI Commerce Search in Gemini Enterprise for Customer Experience.

    Vai alla pagina Modelli

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

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

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

curl

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

Visualizzare i dettagli del 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, segui questa procedura. Tutti gli altri dettagli del modello sono disponibili nella console e nella risposta dell'API.

Console

  1. Vai alla pagina Modelli nella console AI Commerce Search in Gemini Enterprise for Customer Experience.

    Vai alla pagina Modelli

  2. Nella pagina Modelli sono elencati 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, effettua una richiesta Models.get utilizzando l'API. Consulta il riferimento 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'

Elencare i modelli

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

Console

  1. Vai alla pagina Modelli nella console AI Commerce Search in Gemini Enterprise for Customer Experience.

    Vai alla pagina Modelli

  2. Nella pagina Modelli sono elencati 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 il Models.list riferimento API.

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 di pagina. Puoi passare un token di pagina nel parametro pageToken di una richiesta list per recuperare la pagina successiva dei risultati. Questo esempio 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'

Eliminare 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 API Models.delete.

Console

  1. Vai alla pagina Modelli nella console AI Commerce Search in Gemini Enterprise for Customer Experience.

    Vai alla pagina Modelli

  2. Fai clic sul nome del modello che vuoi eliminare per aprirne la 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.

curl

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

Per i dettagli su tutti i Models campi, consulta il Models riferimento API.

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'