Questa pagina spiega come modificare la posizione del ranking dei consigli sui contenuti media retitrati dal modello utilizzando i controlli di pubblicazione per aumentare/nascondere.
Un controllo di aumento/seppellimento modifica l'ordine dei consigli dopo che questi sono stati restituiti dal modello. Applica un'espressione di filtro ai risultati per identificare i consigli che vuoi mettere in evidenza o nascondere, quindi applica un valore di boost compreso tra -1 e +1. Un valore di boost pari a +1 offre il boost maggiore a un consiglio, posizionandolo in cima ai consigli restituito. Un valore pari a -1 nasconde il consiglio nella parte inferiore dell'elenco dei consigli restituiti.
Boost/bury è un controllo post-modello. Innanzitutto, il modello di consigli restituisce un elenco di consigli. Utilizzando una configurazione di pubblicazione, il controllo di aumento/seppellimento viene poi applicato all'elenco per modificare il ranking dei consigli. Il controllo di evidenza/nascondimento non aggiunge né elimina i consigli, ma controlla l'ordine in cui vengono presentati all'utente.
Confronto tra i consigli di boost/bury e i consigli di filtro
Boost/bury è un filtro sfumato. Invece, il filtro regolare per i consigli, описанном в разделе Filtrare i consigli, è un filtro rigoroso.
Se applichi un filtro rigido ai consigli, non vedrai mai i documenti esclusi. Tuttavia, con un filtro flessibile, i documenti non vengono rimossi dall'elenco dei consigli. Il filtro viene invece utilizzato per determinare quali documenti devono essere più in alto o più in basso nell'elenco dei consigli restituiti.
Evitare di sovraccaricare il modello di consigli
Quando applichi un filtro di boost o di occultamento, sono consigliati valori piccoli vicini a zero. I valori vicini a +1 o -1 rischiano di sopraffare il modello di consigli, in modo che il ranking dei consigli applicato dal modello non sia riportato nell'ordine in cui l'utente visualizza i consigli.
Ad esempio, se dai un boost ai film d'animazione con +1, gli utenti vedranno solo i film animati nella parte superiore dell'elenco dei consigli. I film non animati vivamente consigliati dal modello verranno spostati in fondo all'elenco, dove l'utente potrebbe non vederli.
Retrocessione e occultamento
La retrocessione e l'archiviazione spostano entrambi i consigli in posizioni inferiori nell'elenco dei consigli restituiti rispetto a quelle in cui apparirebbero altrimenti.
Tuttavia, la rimozione si basa sull'età dei contenuti o sul fatto che l'utente abbia già guardato alcuni di questi contenuti. Per ulteriori informazioni sulla retrocessione, consulta Retrocedere i suggerimenti per i contenuti multimediali.
Il seppellimento 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 dei consigli, incluso come contrassegnare un campo come filtrabile, consulta Consigli per i filtri.
Informazioni sui controlli boost/bury e sulle configurazioni di pubblicazione
Ogni controllo di pubblicazione di tipo boost/bury è costituito da un filtro e da un valore di boost. Ad esempio, un controllo dell'incremento aumenta i film con il termine Natale nel titolo con un valore di 0.1 e un altro nasconde i film horror con un valore di -0.2.
Dopo aver creato uno o più controlli di aumento/seppellimento, aggiungili a una configurazione di pubblicazione. Quando viene creata un'app Vertex AI Search, viene creata automaticamente anche una configurazione di pubblicazione predefinita. Al momento della pubblicazione viene fatto riferimento alla configurazione di pubblicazione per determinare i risultati generati dall'app. Oltre ai controlli di miglioramento/rimozione, la configurazione di pubblicazione può contenere altri tipi di controlli, come quelli di diversificazione e retrocessione.
La configurazione di pubblicazione può essere applicata quando chiami il metodo recommend. Tutti i controlli nella configurazione di pubblicazione vengono poi applicati ai consigli restituiti dalla chiamata al metodo.
Inoltre, puoi avere più configurazioni di pubblicazione associate alla tua app. In questo modo puoi applicare insiemi diversi di controlli in circostanze diverse. Ad esempio, se la richiesta di consigli proviene dall'account di un bambino, promuovi i film nelle categorie adatte ai bambini e rimuovi quelli non adatti. Analogamente, se la richiesta proviene da un account contrassegnato come per adulti, promuovi i titoli o le categorie apprezzati da questo pubblico. In alternativa, puoi scegliere di avere configurazioni di pubblicazione diverse per località geografiche diverse e mettere in evidenza/nascondere i contenuti in base a ciò che è popolare a livello regionale. Per ulteriori informazioni sulle configurazioni di pubblicazione, consulta Creare e gestire le configurazioni di pubblicazione dei contenuti multimediali.
I valori di boost sono cumulativi
Se hai associato più controlli di pubblicazione a una configurazione di pubblicazione, i potenziamenti e i seppellimenti diventano additivi.
Ad esempio, se aumenti i film d'animazione per bambini di 0,3 punti e i film d'animazione avventurosi di 0,4 punti, un film classificato come film d'animazione avventuroso per bambini viene aumentato di 0,7 punti.
Analogamente, se un film horror è stato migliorato di 0,2 da un gruppo di controllo e peggiorato di 0,3 da un altro gruppo di controllo nella stessa configurazione di pubblicazione, il risultato netto sarebbe un peggioramento del film di 0,1.
La somma dei potenziamenti può superare +1. Ad esempio, se i controlli hanno incrementato i film d'animazione per bambini di 0,6 e i film d'avventura di animazione di 0,5, un film d'avventura di animazione per bambini verrà incrementato di 1,1.
Esempi di filtri
Di seguito sono riportati alcuni esempi di filtri che puoi utilizzare per mettere in evidenza o nascondere i consigli sui contenuti multimediali:
Metti in evidenza i film con il termine Natale nel titolo.
filter: "title: ANY(\"Christmas\")"Metti in evidenza i film d'animazione per bambini:
filter: "categories: ANY(\"animation\") AND categories: ANY(\"children\")"Nascondere i film horror:
filter: "categories: ANY(\"horror\", \"thriller\", \"crime\")
Devono essere corrispondenze esatte. Ad esempio, un film con "Natale" nel titolo non verrebbe migliorato.
Limitazioni dei campi filtrabili
Ai controlli di pubblicazione in evidenza/nascosti si applicano le seguenti limitazioni:
Solo i campi delle proprietà di tipo stringa e booleano possono essere utilizzati nelle espressioni di filtro per l'incremento/l'oscuramento.
Non puoi filtrare in base a campi nidificati su più livelli. Ad esempio, puoi filtrare in base a
persons.name, ma non puoi filtrare in base a un campopersons.name.stage(se esistesse un campo di questo tipo).
Prima di iniziare
Assicurati di aver creato un'app di suggerimenti sui contenuti multimediali e un datastore. Per ulteriori informazioni, consulta Creare un'app di suggerimenti per i contenuti multimediali e un datastore.
(Facoltativo) Se non vuoi utilizzare la configurazione di pubblicazione predefinita, crea una nuova configurazione di pubblicazione seguendo i passaggi 1-5 e 7 dell'articolo Creare una configurazione di pubblicazione. Se la tua app è in produzione, Google consiglia di creare una configurazione di pubblicazione separata per testare il potenziamento/l'oscuramento prima di applicare i controlli di pubblicazione alla configurazione di pubblicazione in produzione.
Assicurati che i campi che vuoi utilizzare nel controllo di aumento/seppellimento siano contrassegnati come Filtrabili nello schema. Per ulteriori informazioni, vedi Configurare le impostazioni dei campi. Consulta anche i limiti dell'applicazione di filtri.
Metti in evidenza o nascondi i consigli
Questa procedura descrive come creare controlli di pubblicazione per aumentare/nascondere i risultati e associarli a una configurazione di pubblicazione.
Dopo aver aggiunto i controlli alla configurazione di pubblicazione, puoi specificare la configurazione di pubblicazione quando chiami il metodo servingConfigs.recommend e il controllo di boost/bury verrà utilizzato per influenzare l'ordine dei consigli restituiti.
REST
Per creare controlli di visualizzazione di tipo boost/bury e aggiungerli a una configurazione di pubblicazione, segui questi passaggi:
Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.
Nella console Google Cloud, vai alla pagina Agent Builder.
Nella pagina App, trova il nome della tua app e recupera l'ID dall'app colonna ID.
Trova l'ID del tuo datastore. Se hai già l'ID del tuo datastore, vai al passaggio successivo.
Nella console Google Cloud, vai alla pagina Agent Builder e nel menu di navigazione fai clic su Data Store.
Fai clic sul nome del tuo datastore.
Nella pagina Dati del tuo datastore, ottieni l'ID datastore.
Crea un controllo dell'aumento:
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls?controlId=CONTROL_ID" \ -d '{ "displayName": "CONTROL_DISPLAY_NAME", "solutionType": "SOLUTION_TYPE_RECOMMENDATION", "boostAction": { "dataStore": "projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID", "boost" : BOOST_VALUE, "filter": "FILTER" } }'PROJECT_ID: l'ID del tuo progetto Google Cloud.CONTROL_DISPLAY_NAME: un nome leggibile per identificare il controllo. Deve essere una stringa UTF-8 con una lunghezza massima di 128 caratteri.CONTROL_ID: un identificatore univoco (all'interno di un data store) per il controllo. L'ID può contenere lettere minuscole, cifre, trattini e trattini bassi.APP_ID: l'ID dell'app Vertex AI Search.DATA_STORE_ID: l'ID dello datastore di Vertex AI Search.BOOST_VALUE: un numero a virgola mobile compreso tra -1 e 1. Quando il valore è negativo, i consigli vengono retrocessi (vengono visualizzati più in basso nei risultati). Quando il valore è positivo, i consigli vengono promossi (vengono visualizzati più in alto nei risultati).FILTER: l'espressione del filtro che descrive i documenti da mettere in evidenza o nascondere. Per informazioni dettagliate su come formulare l'espressione di filtro, consulta Espressioni di filtro.
Ripeti il passaggio 3 per ogni controllo di aumento/seppellimento che vuoi applicare ai consigli. Ad esempio, potresti volere un controllo di aumento che metta in evidenza i film per bambini,
boost-kidse un secondo controllo che nasconda i film horror,bury-horror.Trova l'ID della configurazione di pubblicazione. Se hai già l'ID configurazione di pubblicazione, vai al passaggio successivo.
Nella console Google Cloud, vai alla pagina Agent Builder.
Nella pagina App, fai clic sul nome dell'app.
Vai alla pagina Configurazioni e fai clic sulla scheda Pubblicazione.
Recupera l'ID configurazione di pubblicazione dalla colonna ID.
Aggiungi il nuovo controllo di pubblicazione con boost alla configurazione di pubblicazione con una richiesta di aggiornamento:
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/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/servingConfigs/CONFIG_ID?update_mask=boost_control_ids"}}" \ -d '{ "boostControlIds": ["CONTROL_ID"] }'CONFIG_ID: l'ID della configurazione di pubblicazione a cui vuoi aggiungere i controlli di boost/bury. Consulta il passaggio precedente.
Attendi 5 minuti affinché i risultati vengano applicati.
Visualizza l'anteprima degli effetti del controllo boost/bury. Consulta Ricevere consigli su contenuti media.