Migliorare e nascondere i consigli sui contenuti multimediali

Questa pagina spiega come modificare la posizione nel ranking dei contenuti multimediali consigliati restituiti dal modello utilizzando i controlli di pubblicazione del boost (chiamati anche controlli).

Un controllo del boost modifica l'ordine dei consigli dopo che questi sono stati restituiti dal modello. Applichi un'espressione di filtro ai risultati per identificare i consigli che vuoi promuovere o nascondere e poi applichi un valore di incremento compreso tra -1 e +1. Un valore di incremento pari a +1 fornisce il maggiore incremento a un consiglio, posizionandolo in cima ai consigli restituiti. Un valore di -1 seppellisce il suggerimento verso la parte inferiore dell'elenco dei suggerimenti restituiti.

Il boost è un controllo del tempo di pubblicazione. Innanzitutto, il modello di suggerimenti restituisce un elenco di suggerimenti. Utilizzando una configurazione di gestione, il controllo del boost viene applicato a questo elenco per modificare il ranking dei consigli. Il controllo del boost non aggiunge né elimina i consigli, ma controlla l'ordine in cui vengono presentati all'utente.

Consigli su come aumentare o filtrare

Boost è un filtro soft. Il filtro normale per i consigli, descritto in Filtrare i consigli, è un filtro rigido.

Se applichi un filtro rigido ai consigli, non vedrai mai i documenti filtrati. Tuttavia, con un filtro soft, non rimuovi i documenti dall'elenco dei consigli. Il filtro viene invece utilizzato per determinare quali documenti devono essere visualizzati in alto o in basso nell'elenco dei risultati restituiti.

Evita di sovraccaricare il modello di consigli

Quando applichi un filtro di boost o di eliminazione, sono consigliati valori piccoli vicini allo zero. I valori vicini a +1 o -1 probabilmente sovraccaricano il modello di consigli, in modo che la classificazione dei consigli applicata dal modello non si rifletta nell'ordine in cui l'utente visualizza i consigli.

Ad esempio, se aumenti i film d'animazione con +1, gli utenti vedranno solo i film d'animazione nella parte superiore dell'elenco dei consigli. Questi spingeranno i film non animati che erano altamente consigliati dal modello in fondo all'elenco, dove l'utente potrebbe non vederli.

Retrocessione e seppellimento

La retrocessione e l'eliminazione spostano i consigli per le mosse in posizioni inferiori nell'elenco dei consigli restituiti rispetto a dove apparirebbero altrimenti.

Tuttavia, la retrocessione si basa sull'età dei contenuti o sul fatto che l'utente abbia già guardato parte dei contenuti. Per saperne di più sulla retrocessione, vedi Retrocedere i suggerimenti per i contenuti multimediali.

L'occultamento si applica ai contenuti identificati da un filtro. Il filtro può essere qualsiasi campo di dati contrassegnato come filtrabile nello schema. Per informazioni generali sui filtri per i consigli, incluso come contrassegnare un campo come filtrabile, consulta Filtrare i consigli.

Informazioni sui controlli di boost e sulle configurazioni di pubblicazione

Ogni controllo della pubblicazione del boost è costituito da un filtro e da un valore di boost. Ad esempio, un controllo di boost aumenta i film con la parola "Natale" nel titolo con un valore di 0.1, mentre un altro seppellisce i film horror con un valore di -0.2.

Dopo aver creato uno o più controlli di boost, li colleghi a una configurazione di pubblicazione. Quando viene creata un'app Vertex AI Search, viene creata automaticamente anche una configurazione di pubblicazione predefinita. La configurazione di pubblicazione viene utilizzata al momento della pubblicazione per determinare i risultati generati dall'app. Oltre ai controlli di boost, la configurazione di pubblicazione può contenere altri tipi di controlli, come i controlli diversify e demote.

La configurazione di pubblicazione può essere applicata quando chiami il metodo recommend. Tutti i controlli nella configurazione di pubblicazione vengono quindi applicati ai consigli restituiti dalla chiamata al metodo.

Inoltre, puoi avere più configurazioni di pubblicazione associate alla tua app. In questo modo puoi applicare diversi set di controlli in circostanze diverse. Ad esempio, se la richiesta di consigli proviene dall'account di un bambino, vengono messi in evidenza i film nelle categorie adatte ai bambini e vengono nascosti i film non adatti. Allo stesso modo, se la richiesta proviene da un account contrassegnato come per adulti, vengono promossi titoli o categorie popolari tra gli adulti. In alternativa, puoi scegliere di avere configurazioni di pubblicazione diverse per località geografiche diverse e promuovere i contenuti in base alla loro popolarità regionale. Per ulteriori informazioni sulle configurazioni di pubblicazione, consulta Creare e gestire le configurazioni di pubblicazione di contenuti multimediali.

I valori boost sono cumulativi

Se hai collegato più controlli di pubblicazione a una configurazione di pubblicazione, i boost e i seppellimenti diventano additivi.

Ad esempio, se aumenti i film d'animazione per bambini di 0,3 e i film d'avventura animati di 0,4, un film classificato come film d'avventura animato per bambini viene aumentato di 0,7.

Allo stesso modo, se un film horror è stato aumentato di 0,2 da un controllo e ridotto di -0,3 da un altro controllo nella stessa configurazione di pubblicazione, il risultato netto sarebbe quello di ridurre il film di -0,1.

La somma dei boost può superare +1. Ad esempio, se i controlli hanno aumentato i film di animazione per bambini di 0,6 e i film di avventura di animazione di 0,5, un film di avventura di animazione per bambini aumenterebbe di 1,1.

Esempi di filtri

Di seguito sono riportati alcuni esempi di filtri per i consigli sui contenuti multimediali.

Filtri sulle proprietà chiave comuni

Esempi di filtri sulle proprietà comuni delle stringhe chiave (category, image_name, image_uri, language, title e uri).

• Animazioni per bambini:
  "filter": "categories: ANY(\"animation\") AND categories: ANY(\"children\")"

• Contenuti spaventosi:
  "filter": "categories: ANY(\"horror\", \"thriller\", \"crime\")

• Contenuti multimediali con titolo "Natale":
  "filter": "title: ANY(\"Christmas\")"

• Contenuti multimediali in cui il primo elemento dell'array images ha il valore name "beach ball":
  "filter": "images[0].name: ANY(\"beach ball\")"

Filtri sulle proprietà delle chiavi dei contenuti multimediali

Esempi di filtri sulle proprietà chiave dei contenuti multimediali. Le proprietà dei tasti multimediali iniziano con media_ e, nella sintassi del filtro, il nome del campo è preceduto da media_key_properties.. Per un elenco delle proprietà dei tasti multimediali, vedi Schema predefinito di Google e schema personalizzato.

• Media in cui il tipo è audio:
  "filter": "media_key_properties.media_type: ANY(\"audio\")"

• Elementi multimediali in cui l'array hash_tags contiene una stringa #winter:
  "filter": "media_key_properties.hash_tags: ANY(\"#winter\")"

• Media in cui il primo elemento dell'array hash_tags è la stringa #winter:
  "filter": "media_key_properties.hash_tags[0]: ANY(\"#winter\")"

Campi personalizzati

Esempi di filtri sui campi personalizzati. Per gli attributi personalizzati, anteponi attributes. al nome del campo.

• Nello schema hai un campo stringa personalizzato, festival, per rappresentare il festival cinematografico in cui è stato presentato in anteprima un film. Per filtrare solo i film presentati in anteprima a Cannes:
  "filter": "attributes.festival: ANY(\"Cannes\")

• Hai un campo booleano personalizzato, audio_desc, che è vero quando i contenuti multimediali includono una descrizione audio per gli spettatori con disabilità visive. Per filtrare i contenuti multimediali con una descrizione audio:
  "filter": "attributes.audio_desc: ANY(true)"

Limitazioni dei campi filtrabili

Ai controlli di pubblicazione del boost si applicano le seguenti limitazioni:

• Nei filtri per l'incremento possono essere utilizzati solo i campi delle proprietà di tipo stringa e booleano.

• Non puoi filtrare in base a campi nidificati a più di un livello. Ad esempio, puoi filtrare in base a persons.name, ma non puoi filtrare in base a un campo persons.name.stage (anche se un campo di questo tipo esistesse).

• I filtri devono corrispondere esattamente. Ciò significa che negli esempi, un film chiamato "Christmas Story" o "CHRISTMAS" non verrebbe potenziato.

Prima di iniziare

• Assicurati di aver creato un'app e un datastore di suggerimenti sui contenuti multimediali. Per ulteriori informazioni, consulta Creare un'app e un datastore per i suggerimenti per i contenuti multimediali.

• (Facoltativo) Se non vuoi utilizzare la configurazione di gestione predefinita, crea una nuova configurazione di gestione seguendo i passaggi da 1 a 5 e 7 in Creare una configurazione di gestione. Se la tua app è in produzione, Google consiglia di creare una configurazione di pubblicazione separata per testare i controlli di boost prima di applicarli alla configurazione di pubblicazione di produzione.

• Assicurati che tutti i campi che vuoi utilizzare nel controllo del boost siano contrassegnati come Filtrabili nello schema. Per saperne di più, vedi Configurare le impostazioni dei campi. Vedi anche Limiti di filtraggio.

Boost o bury dei suggerimenti

Questa procedura descrive come creare controlli di boost e collegarli a una configurazione di pubblicazione.

Dopo aver collegato i controlli alla configurazione di pubblicazione, puoi specificare la configurazione di pubblicazione quando chiami il metodo servingConfigs.recommend e il controllo dell'incremento verrà utilizzato per influenzare l'ordine dei consigli restituiti.

Aggiornare il controllo del boost

Questa procedura descrive come aggiornare un controllo boost esistente per modificare il valore del boost o del filtro.

Dopo aver testato il controllo dell'incremento, potresti scoprire di volerlo rendere più forte o più debole. In alternativa, potresti modificare la stringa di filtro.

Quando aggiorni un valore di boost o un filtro, chiami il metodo engines.controls.patch.

Il metodo patch sostituisce i valori di boost e filter con i nuovi valori che fornisci. Questa procedura mostra come modificare separatamente il valore boost (passaggio 3) e il valore filter (passaggio 4). Tuttavia, se vuoi modificare entrambi, puoi farlo con un unico comando curl.

Eliminare un controllo boost

Questa procedura descrive come eliminare un controllo boost. Se non utilizzi un controllo boost, la best practice è eliminarlo per non raggiungere o superare la quota per il numero di controlli consentiti.

Quando elimini un controllo del boost, chiami il metodo engines.controls.delete.

I controlli di boost collegati a una configurazione di pubblicazione non possono essere eliminati. Se provi a eliminare un controllo del boost, un messaggio di errore ti indica il nome della configurazione di pubblicazione. A questo punto, devi eliminare la configurazione di pubblicazione o scollegare il controllo dalla configurazione di pubblicazione.

Aggiorna una configurazione di pubblicazione per rimuovere un controllo boost

Prima di poter eliminare un controllo del boost, devi scollegarlo da tutti i controlli di pubblicazione. A questo scopo, applica una patch ai controlli di pubblicazione per rimuovere l'ID del controllo di boost.

Per separare i controlli di boost da una configurazione di pubblicazione:

1. Scopri quali controlli di boost sono collegati alla configurazione di gestione effettuando una richiesta engines.servingConfigs.get e esaminando il campo boostControlIds nella risposta.

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID"
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo Google Cloud progetto.

   • APP_ID: l'ID dell'app Vertex AI Search.

   • CONFIG_ID: l'ID della configurazione di pubblicazione su cui vuoi saperne di più.

   Esempio di comando e risultato

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id"
   

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
     "displayName": "jane-day-test-serving-config-for-boost-bury",
     "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
     "modelId": "my-app",
     "diversityLevel": "no-diversity",
     "diversityType": "RULE_BASED_DIVERSITY",
     "mediaConfig": {},
     "createTime": "2024-11-22T23:54:45.613178Z",
     "updateTime": "2024-11-26T20:28:11.967439Z",
     "boostControlIds": [
       "boost-kids",
       "bury-horror"
     ]
   }
   

   Questo comando elenca le informazioni sulla configurazione di pubblicazione my_app-1234567_id, in particolare, mostra che alla configurazione di pubblicazione sono collegati due controlli di boost: boost-kids e bury-horror.

2. Per aggiornare la configurazione di pubblicazione in modo da rimuovere un controllo del boost, utilizza il metodo engines.servingConfigs.patch.

   curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID?update_mask=boost_control_ids" \
   -d '{
     "boostControlIds": ["CONTROL_ID"]
   }'
   

   Sostituisci quanto segue:

   • CONFIG_ID: l'ID della configurazione di pubblicazione a cui vuoi collegare i controlli di boost, ad esempio my_app-1234567_id. Vedi il passaggio precedente.

   • CONTROL_ID: contiene gli ID di uno o più controlli di boost che vuoi che la configurazione di pubblicazione abbia. Assicurati di omettere i controlli di potenziamento che vuoi eliminare. Si tratta di un array di stringhe. Se hai più di un ID, non dimenticare di utilizzare virgolette e virgole di separazione, ad esempio boost-1", "boost-2.

   Comando ed esempio di risultato: rimane un controllo

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
   -d '{
     "boostControlIds": ["bury-horror"]
   }'
   

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
     "displayName": "jane-day-test-serving-config-for-boost-bury",
     "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
     "modelId": "my-app",
     "diversityLevel": "no-diversity",
     "diversityType": "RULE_BASED_DIVERSITY",
     "mediaConfig": {},
     "boostControlIds": [
       "bury-horror"
     ]
   }
   

   Questo comando mantiene il controllo del boost bury-horror allegato alla configurazione di pubblicazione e rimuove il controllo boost-kids. Supponendo che boost-kids non sia collegato ad altre configurazioni di pubblicazione, ora può essere eliminato. Vedi Eliminare un controllo del boost.

   Comando ed esempio di risultato: rimuove tutti i controlli

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
   -d '{
   "boostControlIds": []
   }'
   

   {
   "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
   "displayName": "jane-day-test-serving-config-for-boost-bury",
   "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
   "modelId": "my-app",
   "diversityLevel": "no-diversity",
   "diversityType": "RULE_BASED_DIVERSITY",
   "mediaConfig": {}
   }
   

   Questo comando rimuove tutti i controlli di boost dalla configurazione di gestione, my_app-1234567_id