Crea una app de recomendaciones genéricas

En esta página, se describe cómo crear una app de recomendaciones genéricas.

Console

Para usar la consola de Google Cloud y crear una app de recomendaciones genéricas, sigue estos pasos:

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

    Agent Builder

  2. En la página Apps, haz clic en Crear app.

  3. En la página Crear app, en Motor de recomendaciones, haz clic en Crear.

  4. En el campo Nombre de tu app, ingresa un nombre para ella. El ID de la app aparece debajo del nombre del motor.

  5. Opcional: Haz clic en Editar para editar el ID de tu app.

  6. Haga clic en Continuar.

  7. Para conectarte a un almacén de datos, en la página Almacenes de datos, selecciona un almacén de datos que hayas creado anteriormente o crea uno nuevo. Realiza una de las siguientes acciones:

    • Selecciona un almacén de datos existente, si hay uno disponible. Un almacén de datos se puede vincular a una sola app y no se puede quitar de la app más adelante.

    • Crea un almacén de datos nuevo y transfiere datos a él. Para ello, haz clic en Crear almacén de datos y sigue los pasos que se indican en el panel Crear un almacén de datos que se abre. Luego, selecciona tu almacén de datos nuevo. Para obtener más información sobre la creación de un almacén de datos, consulta Cómo crear un almacén de datos de recomendaciones genéricas.

  8. Opcional: Para ver una lista de los almacenes de datos no disponibles, haz 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 un almacén de datos podría no estar disponible:

    • Tu tipo de almacén de datos permite la conexión a una sola app y el almacén de datos ya está conectado.
    • Tu almacén de datos y tu app se encuentran en regiones diferentes.
    • Tu almacén de datos y tu app son de diferentes tipos. Por ejemplo, no puedes conectar un almacén de datos multimedia a una app de recomendaciones genéricas.
    • Tu almacén de datos tiene una búsqueda básica de sitios web, mientras que una app de recomendaciones genéricas requiere un almacén de datos con indexación de sitios web avanzada.
  9. Haz clic en Crear.

REST

Antes de usar la línea de comandos para crear una app, debes tener un almacén de datos existente. Si no tienes un almacén de datos, crea uno siguiendo los pasos que se indican en Cómo crear un almacén de datos de recomendaciones genéricas.

Para usar la línea de comandos y crear una app de recomendaciones, sigue estos pasos:

  1. 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.

  2. Crea una app y conéctala a un almacén de datos. Un almacén de datos se puede conectar a una sola app y no se puede quitar de la app más adelante.

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

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID del proyecto de Google Cloud.
    • APP_ID: El ID de la app de recomendaciones que deseas crear.
    • APP_DISPLAY_NAME: Es el nombre visible de la app de recomendaciones que deseas crear.
    • DATA_STORE_ID: El ID de un almacén de datos de recomendaciones existente que deseas agregar a la app de recomendaciones.

¿Qué sigue?