Esta página foi traduzida pela API Cloud Translation.

Filtrar recomendações

Se você tiver um app de recomendações, use os campos de documento para filtrar os resultados. Nesta página, explicamos como usar campos de documento para filtrar uma recomendação para um conjunto específico de documentos. Embora os exemplos nesta página sejam para recomendações de mídia, os princípios mostrados aqui são os mesmos para recomendações personalizadas. Para mais informações sobre recomendações de mídia, consulte Introdução à Vertex AI Search para mídia.

Filtrar recomendações e atualizações do repositório de dados

Depois de qualquer atualização do repositório de dados, aguarde até 8 horas enquanto o modelo é retreinado. Isso porque o modelo precisa saber os valores atuais nos metadados do documento, bem como quais campos estão configurados como filtráveis. É necessário aguardar a propagação das mudanças no documento e no esquema. Para recomendações (ao contrário da pesquisa), a filtragem não é feita em tempo real.

Filtros e configurações de diversificação (somente recomendações de mídia)

Além dos filtros, a configuração de diversificação de um app também afeta os resultados retornados em uma resposta de recomendação de mídia. Os efeitos de filtros e diversificação são combinados. A diversificação é feita primeiro e a filtragem, depois.

A combinação de alta diversidade baseada em regras e filtragem de atributos baseada em categorias geralmente resulta em saída vazia. Isso porque a alta diversidade limita o app a retornar um resultado para cada categoria.

Por exemplo, você quer recomendar filmes com base em Toy Story. Você define o nível de diversidade com base em regras como "alto". Como o nível de diversidade é alto, embora muitos filmes possam ser recomendados, apenas um filme (por exemplo, WALL·E) na categoria de filmes infantis é retornado. Quando o filtro de filmes infantis é aplicado, apenas WALL·E é retornado como uma recomendação.

Para informações gerais sobre diversidade, consulte Diversificar recomendações de mídia.

Antes de começar

Verifique se você criou um app de recomendações e um repositório de dados. Para mais informações, consulte Criar apps de mídia ou Criar um armazenamento de dados de recomendações personalizado.

Exemplos de documentos

Revise estes exemplos de documentos de mídia. Consulte esses exemplos de documentos enquanto lê esta página.

{"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"}}

Expressões de filtro

Use expressões de filtro para definir seus filtros de recomendação.

Sintaxe das expressões de filtro

O Formato Backus-Naur estendido a seguir resume a sintaxe da expressão de filtro que você pode usar para definir seus filtros de recomendações.

  # 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;

Restrições de expressões de filtro

As seguintes restrições se aplicam às expressões de filtro para recomendações:

A profundidade de incorporação dos operadores AND e OR entre parênteses é limitada. As expressões lógicas no filtro precisam estar na forma normal conjuntiva (CNF). A expressão lógica mais complexa compatível pode ser uma lista de cláusulas conectadas por AND que contêm apenas operadores OR, como: (... OR ... OR ...) AND (... OR ...) AND (... OR ...)
As expressões podem ser negadas com a palavra-chave NOT ou com -. Isso só funciona com expressões ANY() com um único argumento.
As restrições de available precisam estar no nível superior. Elas não podem ser usadas como parte de uma cláusula OR ou uma negação (NOT). Só é possível usar available: true. Se você omitir esse filtro, documentos expirados e ainda não disponíveis poderão ser retornados como recomendações.

O campo available é mapeado para a seguinte lógica:

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

Se o expire_time não estiver definido, datetime.now <= expire_time será resolvido como true.
O número máximo de termos na cláusula AND de nível superior é 20.
Uma cláusula OR pode ter até 100 argumentos incluídos em expressões ANY(). Se uma cláusula OR tiver várias expressões ANY(), todos os argumentos delas serão contabilizados para esse limite. Por exemplo, categories: ANY("drama", "comedy") OR categories: ANY("adventure") tem três argumentos.

Exemplos de expressões de filtro

A tabela a seguir mostra exemplos de expressões de filtro válidas e inválidas. Ela também informa os motivos da invalidez dos exemplos.

Expressão	Válido	Observações
`language_code: ANY("en", "fr")`	Sim
`NOT language_code: ANY("en")`	Sim
`NOT language_code: ANY("en", "fr")`	Não	Nega um `ANY()` com mais de um argumento.
`language_code: ANY("en", "fr") OR categories: ANY("drama")`	Sim
`(language_code: ANY("en") OR language_code: ANY("fr")) AND categories: ANY("drama")`	Sim
`(language_code: ANY("en") AND language_code: ANY("fr")) OR categories: ANY("drama")`	Não	Não está na forma normal conjuntiva.
`(language_code: ANY("en")) AND (available: true)`	Sim
`(language_code: ANY("en")) OR (available: true)`	Não	Combina `available` em uma expressão `OR` com outras condições.

A expressão de filtro a seguir filtra documentos que estão nas categorias drama ou ação, que não estão em inglês e que estão disponíveis:

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

Limites de filtragem

Cada campo de documento filtrável consome um pouco de memória em cada um dos seus modelos. Os limites a seguir ajudam a evitar efeitos adversos no desempenho da veiculação:

É possível definir até 10 campos personalizados como filtráveis no seu esquema.

Se mais de 10 campos personalizados forem encontrados durante o treinamento do app, apenas 10 serão usados.
Até 100.000.000 valores de campo filtráveis podem estar presentes no seu esquema.

Para estimar o número total de valores de campo filtráveis no seu esquema, multiplique o número de documentos no esquema pelo número de campos filtráveis. Se você exceder esses limites, vai acontecer o seguinte:
- Não é possível definir outros campos como filtráveis.
- O treinamento do app falha.