Esta página se ha traducido con Cloud Translation API.

Filtrar recomendaciones

Si tienes una aplicación de recomendaciones, puedes usar campos de documento para filtrar los resultados de las recomendaciones. En esta página se explica cómo usar los campos de documento para filtrar una recomendación a un conjunto específico de documentos. Aunque los ejemplos de esta página son de recomendaciones de contenido multimedia, los principios que se muestran aquí son los mismos para las recomendaciones personalizadas. Para obtener más información sobre las recomendaciones de contenido multimedia, consulta la introducción a Vertex AI Search for Media.

Filtrar recomendaciones y actualizaciones de almacenes de datos

Después de actualizar un almacén de datos, tendrás que esperar hasta 8 horas para que el modelo se vuelva a entrenar. Esto se debe a que el modelo necesita conocer los valores actuales de los metadatos del documento, así como los campos que están configurados como filtrables. Debes esperar a que se propaguen los cambios en los documentos y en el esquema. En el caso de las recomendaciones (a diferencia de las búsquedas), el filtrado no se realiza en tiempo real.

Filtros y ajustes de diversificación (solo en recomendaciones de contenido multimedia)

Además de los filtros, el ajuste de diversificación de una aplicación también afecta a los resultados devueltos en una respuesta de recomendación de contenido multimedia. Se combinan los efectos de los filtros y la diversificación. La diversificación se realiza primero y el filtrado, después.

Si se combinan una diversidad alta basada en reglas y un filtrado de atributos basado en categorías, a menudo no se obtienen resultados. Esto se debe a que una diversidad alta limita la aplicación a devolver un resultado por categoría.

Por ejemplo, quieres recomendar películas basadas en Toy Story. Has definido el nivel de diversidad basado en reglas como alto. Como el nivel de diversidad es alto, aunque se recomienden muchas películas, solo se devolverá una película (por ejemplo, WALL·E) en la categoría de películas infantiles. Si se aplica el filtro de películas infantiles, solo se devolverá WALL·E como recomendación.

Para obtener información general sobre la diversidad, consulta el artículo Diversificar las recomendaciones de contenido multimedia.

Antes de empezar

Asegúrate de haber creado una aplicación de recomendaciones y un almacén de datos. Para obtener más información, consulta Crear aplicaciones multimedia o Crear un almacén de datos de recomendaciones personalizadas.

Documentos de ejemplo

Consulta estos documentos multimedia de ejemplo. Puedes consultar estos documentos de ejemplo mientras lees 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"}}

Expresiones de filtro

Usa expresiones de filtro para definir los filtros de recomendaciones.

Sintaxis de las expresiones de filtro

La siguiente forma de Backus-Naur ampliada resume la sintaxis de las expresiones de filtro que puede usar para definir los filtros de recomendaciones.

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

Restricciones de las expresiones de filtro

Las expresiones de filtro de las recomendaciones están sujetas a las siguientes restricciones:

La profundidad de la inserción de los operadores AND y OR entre paréntesis es limitada. Las expresiones lógicas del filtro deben estar en forma normal conjuntiva (FNC). La expresión lógica más compleja que se admite puede ser una lista de cláusulas conectadas con AND que solo contengan operadores OR, como la siguiente: (... OR ... OR ...) AND (... OR ...) AND (... OR ...)
Las expresiones se pueden negar con la palabra clave NOT o con -. Esta opción solo funciona con expresiones ANY() que tienen un único argumento.
Las restricciones de available deben estar en el nivel superior. No se pueden usar como parte de una cláusula OR o de una negación (NOT). Solo se puede usar available: true. Si omite este filtro, es posible que se devuelvan como recomendaciones documentos caducados y documentos que aún no estén disponibles.

El campo available se asigna a la siguiente lógica:

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

Si no se define expire_time, datetime.now <= expire_time se resuelve como true.
El número máximo de términos de la cláusula AND de nivel superior es 20.
Una cláusula OR puede tener hasta 100 argumentos incluidos en ANY() expresiones. Si una cláusula OR tiene varias expresiones ANY(), todos sus argumentos se tienen en cuenta para este límite. Por ejemplo, categories: ANY("drama", "comedy") OR categories: ANY("adventure") tiene tres argumentos.

Ejemplos de expresiones de filtro

En la siguiente tabla se muestran ejemplos de expresiones de filtro válidas e inválidas. También indica los motivos por los que los ejemplos no válidos no lo son.

Expresión	Sí	Notas
`language_code: ANY("en", "fr")`	Sí
`NOT language_code: ANY("en")`	Sí
`NOT language_code: ANY("en", "fr")`	No	Niega un `ANY()` con más de un argumento.
`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	No está en forma normal conjuntiva.
`(language_code: ANY("en")) AND (available: true)`	Sí
`(language_code: ANY("en")) OR (available: true)`	No	Combina `available` en una expresión `OR` con otras condiciones.

La siguiente expresión de filtro busca documentos que pertenezcan a la categoría de drama o acción, que no estén en inglés y que estén disponibles:

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

Límites de filtrado

Cada campo de documento filtrable consume memoria en cada uno de tus modelos. Los siguientes límites ayudan a evitar efectos adversos en el rendimiento del servicio:

Puedes definir hasta 10 campos personalizados como filtrables en tu esquema.

Si se encuentran más de 10 campos personalizados durante el entrenamiento de la aplicación, solo se usarán 10.
Tu esquema puede incluir hasta 100.000.000 valores de campos filtrables.

Para estimar el número total de valores de campo filtrables de tu esquema, multiplica el número de documentos de tu esquema por el número de campos filtrables. Si superas estos límites, ocurrirá lo siguiente:
- No puedes definir campos adicionales como filtrables.
- La preparación de la aplicación falla.