Crear una aplicación de recomendaciones personalizada

Nota: Esta función es una oferta de vista previa, sujeta a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de los Términos Específicos de los Servicios de GCP. Las funciones y los productos previos a la disponibilidad general pueden tener una asistencia limitada y los cambios que se produzcan en ellos podrían no ser compatibles con otras versiones previas a la disponibilidad general. Para obtener más información, consulta las descripciones de las fases de lanzamiento. Además, al usar esta función, aceptas los términos y condiciones de la vista previa de IA generativa ("Términos de la Vista Previa"). Para usar esta función, puedes tratar datos personales tal como se indica en la Adenda sobre Tratamiento de Datos de Cloud, de acuerdo con las restricciones y obligaciones aplicables del Contrato (tal como se definen en los Términos de la Vista Previa).

En esta página se describe cómo crear una aplicación de recomendaciones personalizada.

Consola

Para usar la Google Cloud consola y crear una aplicación de recomendaciones personalizada, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

   Aplicaciones de IA

2. En la página Aplicaciones, haz clic en Crear aplicación.

3. En la página Crear aplicación, en Motor de recomendaciones, haz clic en Crear.

4. En el campo Nombre de tu aplicación, introduce el nombre de tu aplicación. El ID de la aplicación aparece debajo del nombre del motor.

5. Opcional: Haz clic en Editar para modificar el ID de tu aplicación.

6. Haz clic en Continuar.

7. Para conectarse a un almacén de datos, en la página Almacenes de datos, seleccione un almacén de datos que contenga datos estructurados o cree uno. Elige una de estas opciones:

   • Selecciona un almacén de datos, si hay alguno disponible. Un almacén de datos solo se puede asociar a una aplicación y no se puede quitar de la aplicación más adelante.

   • Crea un almacén de datos estructurados e ingiere datos en él. Para ello, haga clic en Crear almacén de datos y siga los pasos del panel Crear un almacén de datos que se abre. A continuación, selecciona el nuevo almacén de datos. Para obtener más información sobre cómo crear un almacén de datos, consulta Crear un almacén de datos de recomendaciones personalizadas.

8. Opcional: Para ver una lista de los almacenes de datos no disponibles, haga clic en Más información.

   Se muestra una tabla con una lista de los almacenes de datos y el motivo por el que no están disponibles. Estos son algunos de los motivos por los que puede que un almacén de datos no esté disponible:

   • Tu tipo de almacén de datos solo permite la conexión a una aplicación y el almacén de datos ya está conectado.
   • Tu almacén de datos y tu aplicación están en regiones diferentes.
   • Tu almacén de datos y tu aplicación son de tipos diferentes. Por ejemplo, no puedes conectar un almacén de datos multimedia a una aplicación de recomendaciones personalizada.
   • Tu almacén de datos tiene una búsqueda básica en el sitio web, mientras que una aplicación de recomendaciones personalizadas requiere un almacén de datos con indexación avanzada de sitios web.

9. Haz clic en Crear.

REST

Antes de usar la línea de comandos para crear una aplicación, debes tener un almacén de datos. Si no tienes ningún almacén de datos, crea uno siguiendo los pasos que se indican en Crear un almacén de datos de recomendaciones personalizado.

Nota: Esta función está en fase experimental.

Para crear una aplicación de recomendaciones mediante la línea de comandos, sigue estos pasos:

1. Busca el ID de tu almacén de datos. Si ya tiene el ID del almacén de datos, vaya al siguiente paso.

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

      Ir a la página Almacenes de datos

   2. Haga clic en el nombre de su almacén de datos.

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

2. Crea una aplicación y conéctala a un almacén de datos estructurados. Un almacén de datos solo se puede adjuntar a una aplicación y no se puede quitar de la aplicación más adelante.

   Término clave: en Vertex AI Search, el término aplicación se puede usar indistintamente con el término buscador en el contexto de las APIs.

   curl -X POST \
   -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/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ID"],
     "solutionType": ["SOLUTION_TYPE_RECOMMENDATION"],
     "similarDocumentsConfig": {}
   }'
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID de tu proyecto de Google Cloud .
   • APP_ID: el ID de la aplicación de recomendaciones que quiere crear.
   • APP_DISPLAY_NAME: el nombre visible de la aplicación de recomendaciones que quieras crear.
   • DATA_STORE_ID: el ID de un almacén de datos de recomendaciones que quieras añadir a la aplicación de recomendaciones.

Siguientes pasos

• Para ver una vista previa de cómo aparecen las recomendaciones, consulta Obtener recomendaciones.