Questa pagina è stata tradotta dall'API Cloud Translation.

Filtrare i consigli

Se hai un'app per suggerimenti, puoi utilizzare i campi del documento per filtrare i risultati dei suggerimenti. Questa pagina spiega come utilizzare i campi del documento per filtrare un consiglio in base a un insieme specifico di documenti. Anche se gli esempi in questa pagina riguardano i consigli sui contenuti multimediali, i principi mostrati qui sono gli stessi per i consigli personalizzati. Per ulteriori informazioni sui suggerimenti per i contenuti multimediali, consulta Introduzione a Vertex AI Search per i contenuti multimediali.

Filtrare i suggerimenti e gli aggiornamenti del datastore

Dopo qualsiasi aggiornamento dell'datastore, dovrai attendere fino a 8 ore per il nuovo addestramento del modello. Questo perché il modello deve conoscere i valori attuali nei metadati del documento, nonché i campi configurati come filtrabili. Devi attendere la propagazione delle modifiche al documento e allo schema. Per i suggerimenti (a differenza della ricerca), il filtro non viene eseguito in tempo reale.

Filtri e impostazioni di diversificazione (solo consigli sui contenuti multimediali)

Oltre ai filtri, anche l'impostazione di diversificazione di un'app influisce sui risultati restituiti in una risposta di suggerimento di contenuti multimediali. Gli effetti dei filtri e della diversificazione vengono combinati. La diversificazione viene eseguita per prima e il filtraggio per secondo.

La combinazione di diversità elevata basata su regole e filtraggio degli attributi basato su categorie spesso genera un output vuoto. Questo perché l'elevata diversità limita l'app a restituire un risultato per ogni categoria.

Ad esempio, vuoi consigliare film basati su Toy Story. Hai impostato il livello di diversità basato su regole su Alto. Poiché il livello di diversità è elevato, anche se molti film potrebbero essere consigliati solo un film (ad esempio WALL·E) nella categoria dei film per bambini. Quando viene applicato il filtro per i film per bambini, viene restituito solo WALL·E come suggerimento.

Per informazioni generali sulla diversità, consulta la sezione Diversificare i suggerimenti per i contenuti multimediali.

Prima di iniziare

Assicurati di aver creato un'app di suggerimenti e un datastore. Per ulteriori informazioni, vedi Creare app multimediali o Creare un archivio dati di consigli personalizzati.

Documenti di esempio

Esamina questi documenti multimediali di esempio. Puoi fare riferimento a questi documenti di esempio mentre leggi questa pagina.

{"id":"1","schemaId":"default_schema","structData":{"title":"Toy Story (1995)","categories":["Adventure","Animation","Children","Comedy","Fantasy"],"uri":"http://mytestdomain.movie/content/1","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}
{"id":"88125","schemaId":"default_schema","structData":{"title":"Harry Potter and the Deathly Hallows: Part 2 (2011)","categories":["Action","Adventure","Drama","Fantasy","Mystery","IMAX"],"uri":"http://mytestdomain.movie/content/88125","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}
{"id":"2857","schemaId":"default_schema","structData":{"title":"Yellow Submarine (1968)","categories":["Adventure","Animation","Comedy","Fantasy","Musical"],"uri":"http://mytestdomain.movie/content/2857","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}
{"id":"60069","schemaId":"default_schema","structData":{"title":"WALL·E (2008)","categories":["Adventure","Animation","Children","Romance","Sci-Fi"],"uri":"http://mytestdomain.movie/content/60069","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}

Espressioni di filtro

Utilizza le espressioni di filtro per definire i filtri dei consigli.

Sintassi delle espressioni di filtro

Il seguente Extended Backus–Naur form riassume la sintassi dell'espressione di filtro che puoi utilizzare per definire i filtri dei consigli.

  # A single expression or multiple expressions that are joined by "AND" or "OR".
  filter = expression, { " AND " | "OR", expression };
  # An expression can be prefixed with "-" or "NOT" to express a negation.
  expression = [ "-" | "NOT " ],
    # A parenthesized expression
    | "(", expression, ")"
    # A simple expression applying to a textual field.
    # Function "ANY" returns true if the field contains any of the literals.
    textual_field, ":", "ANY", "(", literal, { ",", literal }, ")"
    # OR filter by "available"
    available, ":", "true",
  # A literal is any double-quoted string. You must escape backslash (\) and
  # quote (") characters.
  literal = double-quoted string;
  textual_field = see the tables below;

Limitazioni delle espressioni di filtro

Si applicano le seguenti limitazioni alle espressioni di filtro per i consigli:

La profondità degli operatori AND e OR tra parentesi è limitata. Le espressioni logiche nel filtro devono essere in forma normale congiuntiva (CNF). L'espressione logica supportata più complessa può essere un elenco di clausole connesse da AND che contengono solo operatori OR, ad esempio: (... OR ... OR ...) AND (... OR ...) AND (... OR ...)
Le espressioni possono essere negate con la parola chiave NOT o con -. Questa opzione funziona solo con le espressioni ANY() con un solo argomento.
Le limitazioni available devono essere di primo livello. Non possono essere utilizzati come parte di una clausola OR o di una negazione (NOT). Puoi utilizzare solo available: true. Se ometti questo filtro, i documenti scaduti e quelli non ancora disponibili potrebbero essere restituiti come consigli.

Il campo available viene mappato alla seguente logica:

datetime.now >= available_time AND datetime.now <= expire_time

Se expire_time non è impostato, datetime.now <= expire_time viene risolto in true.
Il numero massimo di termini nella clausola AND di primo livello è 20.
Una clausola OR può avere fino a 100 argomenti inclusi nelle espressioni ANY(). Se una clausola OR ha più espressioni ANY(), tutti i relativi argomenti vengono conteggiati ai fini di questo limite. Ad esempio, categories: ANY("drama", "comedy") OR categories: ANY("adventure") ha tre argomenti.

Esempi di espressioni di filtro

La tabella seguente mostra esempi di espressioni di filtro valide e non valide. Inoltre, fornisce i motivi per cui gli esempi non validi non sono validi.

Espressione	Valido	Note
`language_code: ANY("en", "fr")`	Sì
`NOT language_code: ANY("en")`	Sì
`NOT language_code: ANY("en", "fr")`	No	Nega un `ANY()` con più di un argomento.
`language_code: ANY("en", "fr") OR categories: ANY("drama")`	Sì
`(language_code: ANY("en") OR language_code: ANY("fr")) AND categories: ANY("drama")`	Sì
`(language_code: ANY("en") AND language_code: ANY("fr")) OR categories: ANY("drama")`	No	Non in forma normale congiuntiva.
`(language_code: ANY("en")) AND (available: true)`	Sì
`(language_code: ANY("en")) OR (available: true)`	No	Combina `available` in un'espressione `OR` con altre condizioni.

La seguente espressione di filtro filtra i documenti che rientrano nella categoria drammatico o azione, che non sono in inglese e che sono disponibili:

categories: ANY("drama", "action") AND NOT language_code: ANY("en") AND available: true

Limiti di filtraggio

Ogni campo del documento filtrabile consuma una parte di memoria in ciascuno dei tuoi modelli. I seguenti limiti contribuiscono a prevenire effetti negativi sul rendimento della pubblicazione:

Nello schema è possibile impostare fino a 10 campi personalizzati come filtrabili.

Se durante l'addestramento dell'app vengono trovati più di 10 campi personalizzati, ne vengono utilizzati solo 10.
Nello schema possono essere presenti fino a 100.000.000 valori di campi filtrabili.

Puoi stimare il numero totale di valori dei campi filtrabili nello schema moltiplicando il numero di documenti nello schema per il numero di campi filtrabili. Se superi questi limiti, si verificano le seguenti situazioni:
- Non puoi impostare campi aggiuntivi come filtrabili.
- L'addestramento dell'app non riesce.