Cómo destacar y ocultar recomendaciones de contenido multimedia

En esta página, se explica cómo cambiar la posición de clasificación de las recomendaciones de contenido multimedia que muestra el modelo mediante los controles de publicación para aumentar o disminuir la visibilidad.

Un control de aumento o ocultación cambia el orden de las recomendaciones después de que el modelo las muestra. Aplicas una expresión de filtro a los resultados para identificar qué recomendaciones deseas mejorar o destinar, y luego aplicas un valor de mejora entre -1 y +1. Un valor de impulso de +1 le brinda el impulso más grande a una recomendación, lo que la coloca en la parte superior de las recomendaciones que se muestran. Un valor de -1 entierra la recomendación en la parte inferior de la lista de recomendaciones que se muestra.

Mejorar/ocultar es un control posterior al modelo. Primero, el modelo de recomendaciones muestra una lista de recomendaciones. Con una configuración de publicación, el control de aumento o ocultación se aplica a esa lista para ajustar la clasificación de las recomendaciones. El control de aumento o ocultación no agrega ni borra recomendaciones, pero sí controla el orden en que se presentan al usuario.

Diferencias entre las recomendaciones para mejorar o ocultar y las de filtrado

El filtro de aumento o ocultación es suave. Mientras que el filtro normal para las recomendaciones, que se describe en Cómo filtrar recomendaciones, es un filtro estricto.

Si aplicas un filtro estricto a las recomendaciones, nunca verás los documentos que se filtran. Sin embargo, con un filtro suave, no quitas los documentos de la lista de recomendaciones. En cambio, el filtro se usa para determinar qué documentos deben estar más arriba o más abajo en la lista de recomendaciones que se muestran.

Evita sobrecargar tu modelo de recomendaciones

Cuando se aplica un filtro de aumento o ocultación, se recomiendan valores pequeños cercanos a cero. Es probable que los valores cercanos a +1 o -1 abrumen al modelo de recomendaciones, de modo que la clasificación de recomendaciones que aplica el modelo no se refleje en el orden en que el usuario ve las recomendaciones.

Por ejemplo, si promocionas películas animadas con +1, los usuarios solo verán películas animadas en la parte superior de la lista de recomendaciones. Estas desplazarían las películas no animadas que el modelo recomendó mucho hasta la parte inferior de la lista, donde es posible que el usuario no las vea.

Descenso de nivel en comparación con el entierro

La baja de clasificación y el ocultamiento de las recomendaciones las mueven a posiciones más bajas en la lista de recomendaciones que se muestran, de lo contrario.

Sin embargo, la reducción de clasificación se basa en la antigüedad del contenido o en si el usuario ya lo vio. Para obtener más información sobre el descenso de nivel, consulta Cómo descender de nivel las recomendaciones de contenido multimedia.

La ocultación se aplica al contenido identificado por un filtro. El filtro puede ser cualquier campo de datos marcado como filtrable en el esquema. Para obtener información general sobre los filtros de recomendaciones, incluida la forma de marcar un campo como filtrable, consulta Filtra recomendaciones.

Información sobre los controles de mejorar y ocultar, y las configuraciones de publicación

Cada control de publicación de aumento o ocultación consta de un filtro y un valor de aumento. Por ejemplo, un control de aumento aumenta las películas con el título Navidad con un valor de 0.1 y otro oculta las películas de terror con un valor de -0.2.

Después de crear uno o más controles de aumento o ocultación, debes agregarlos a una configuración de entrega. Cuando se crea una app de Vertex AI Search, también se crea automáticamente una configuración de publicación predeterminada. Se hace referencia a la configuración de entrega en el momento de la entrega para determinar qué resultados genera la app. Además de los controles de aumento o ocultación, la configuración de publicación puede contener otros tipos de controles, como los controles de diversificación y reducción de clasificación.

La configuración de publicación se puede aplicar cuando llamas al método recommend. Luego, todos los controles de la configuración de publicación se aplican a las recomendaciones que muestra la llamada de método.

Además, puedes tener varias configuraciones de publicación asociadas con tu app. Esto te permite aplicar diferentes conjuntos de controles en diferentes circunstancias. Por ejemplo, si la solicitud de recomendación proviene de la cuenta de un niño o niña, destaca las películas en categorías aptas para niños y oculta las que no lo son. Del mismo modo, si la solicitud proviene de una cuenta marcada como para adultos, aumenta los títulos o las categorías populares entre los adultos. Como alternativa, puedes optar por tener diferentes parámetros de configuración de publicación para diferentes ubicaciones geográficas y aumentar o ocultar el contenido según lo que sea popular en la región. Para obtener más información sobre las configuraciones de publicación, consulta Crea y administra configuraciones de publicación de contenido multimedia.

Los valores de impulso son aditivos

Si asociaste varios controles de publicación a una configuración de publicación, los aumentos y las ocultaciones se suman.

Por ejemplo, si aumentas las películas animadas infantiles en un 0.3 y las películas animadas de aventuras en un 0.4, una película que se clasifica como una aventura animada infantil se aumentará en un 0.7.

Del mismo modo, si un control aumenta una película de terror en 0.2 y otro la reduce en 0.3 en la misma configuración de publicación, el resultado neto sería reducir la película en 0.1.

La suma de los aumentos puede superar el +1. Por ejemplo, si los controles aumentaran las películas animadas para niños en un 0.6 y las películas de aventuras animadas en un 0.5, una película de aventuras animadas para niños aumentaría en un 1.1.

Ejemplos de filtros

Los siguientes son algunos ejemplos de filtros que podrías usar para aumentar o ocultar las recomendaciones de contenido multimedia:

  • Destaca las películas con el título Navidad.

    filter: "title: ANY(\"Christmas\")"

  • Mejora las películas animadas para niños:

    filter: "categories: ANY(\"animation\") AND categories: ANY(\"children\")"

  • Entierra las películas de terror:

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

Estas deben ser coincidencias exactas. Por ejemplo, una película con "NAVIDAD" en el título no se destacaría.

Limitaciones de los campos filtrables

Se aplican las siguientes limitaciones a los controles de publicación o ocultación:

  • Solo se pueden usar campos de propiedad de los tipos cadena y booleano en las expresiones de filtro para aumentar o disminuir la visibilidad.

  • No puedes filtrar campos anidados en más de un nivel. Por ejemplo, puedes filtrar por persons.name, pero no puedes filtrar por un campo persons.name.stage (si existiera un campo de este tipo).

Antes de comenzar

Cómo aumentar o ocultar recomendaciones

En este procedimiento, se describe cómo crear controles de publicación para aumentar o disminuir la publicación y asociarlos con una configuración de publicación.

Después de agregar los controles a la configuración de publicación, puedes especificarla cuando llames al método servingConfigs.recommend, y se usará el control de aumento o ocultación para influir en el orden de las recomendaciones que se muestran.

REST

Para crear controles de publicación para aumentar o reducir la visibilidad y agregarlos a una configuración de publicación, sigue estos pasos:

  1. Busca el ID de tu app. Si ya tienes el ID de tu app, ve al siguiente paso.

    1. En la consola de Google Cloud, ve a la página Agent Builder.

      Ve a Apps.

    2. En la página Apps, busca el nombre de tu app y obtén su ID de la columna ID.

  2. Busca el ID de tu almacén de datos. Si ya tienes el ID del almacén de datos, ve al siguiente paso.

    1. En la consola de Google Cloud, ve a la página Agent Builder y, en el menú de navegación, haz clic en Almacenes de datos.

      Ve a la página Almacenes de datos.

    2. Haz clic en el nombre de tu almacén de datos.

    3. En la página Datos de tu almacén de datos, obtén el ID del almacén de datos.

  3. Crea un control de 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: El ID del proyecto de Google Cloud.

    • CONTROL_DISPLAY_NAME: Un nombre legible para identificar el control. Debe ser una cadena UTF-8 con una longitud máxima de 128 caracteres.

    • CONTROL_ID: Un identificador único (dentro de un almacén de datos) para el control. El ID puede contener letras minúsculas, dígitos, guiones y guiones bajos.

    • APP_ID: El ID de la app de Vertex AI Search.

    • DATA_STORE_ID: el ID del almacén de datos de Vertex AI Search.

    • BOOST_VALUE: Un número de punto flotante entre -1 y 1. Cuando el valor es negativo, las recomendaciones descienden de nivel (aparecen más abajo en los resultados). Cuando el valor es positivo, se promocionan las recomendaciones (aparecen más arriba en los resultados).

    • FILTER: Es la expresión de filtro que describe qué documentos se destacarán o ocultarán. Para obtener información detallada sobre cómo formular la expresión de filtro, consulta Expresiones de filtro.

  4. Repite el paso 3 para cada control de aumento o ocultación que quieras aplicar a tus recomendaciones. Por ejemplo, puedes querer un control de aumento que aumente las películas infantiles, boost-kids, y un segundo control que oculte las películas de terror, bury-horror.

  5. Busca el ID de la configuración de publicación. Si ya tienes el ID de configuración de publicación, ve al siguiente paso.

    1. En la consola de Google Cloud, ve a la página Agent Builder.

      Ve a Apps.

    2. En la página Apps, haz clic en el nombre de tu app.

    3. Ve a la página Configuraciones y haz clic en la pestaña Publicación.

    4. Obtén el ID de configuración de publicación de la columna ID.

  6. Agrega el nuevo control de entrega de aumento a la configuración de entrega con una solicitud de actualización:

    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: Es el ID de la configuración de publicación a la que deseas agregar los controles de aumento o ocultación. Consulta el paso anterior.

  7. Espera 5 minutos para que se apliquen los resultados.

  8. Obtén una vista previa de los efectos de tu control de mejorar o ocultar. Consulta Obtén recomendaciones de contenido multimedia.