Se cambiará el nombre de Retail a Vertex AI Search para la venta minorista. Estamos en proceso de actualizar el contenido para reflejar el nuevo desarrollo de la marca.

Se usó la API de Cloud Translation para traducir esta página.

Importa datos de autocompletado para la búsqueda

El autocompletado es una función que permite predecir el resto de las palabras que escribe un usuario, lo que puede mejorar la experiencia de búsqueda del usuario. Puede proporcionar sugerencias antes de que se escriban en función del conjunto de datos proporcionado o en función de los eventos de usuario que proporcionaste.

Considera importar datos de autocompletado solo si deseas tener controles adicionales (lista de no quitar, lista de rechazo) o si necesitas usar tus propios datos de autocompletado. Activar el aprendizaje automático es suficiente en la mayoría de los casos en los que se necesita el autocompletado. El aprendizaje automático proporciona un conjunto de datos de sugerencias basado en el aprendizaje automático según los eventos de búsqueda de los usuarios. Consulta Autocompletar para saber cómo activar el aprendizaje automático.

Estas instrucciones son solo para subir tus datos de autocompletado. Mantenla actualizada si planeas usar tu conjunto de datos de autocompletado todo el tiempo. Para obtener resultados de autocompletado en el momento de la consulta, consulta CompletionService.CompleteQuery. Los datos de autocompletado solo se usan para la búsqueda. Las recomendaciones no usan estos datos.

Antes de comenzar

Antes de importar tu información de autocompletado, debes completar las instrucciones que se indican en Antes de comenzar, en particular, cómo configurar tu proyecto, creación de una cuenta de servicio y agregado de la cuenta de servicio a tu entorno local.

Debes tener la función de IAM Editor de venta minorista para realizar la importación.

Prácticas recomendadas para la importación de Autocomplete

Cuando importes datos de autocompletado, asegúrate de implementar las siguientes prácticas recomendadas:

Lee el esquema de BigQuery que se indica en las siguientes secciones y en la documentación de la API.
No uses valores de marcador de posición.
Incluye tantos campos como sea posible.
Mantén actualizado tu propio conjunto de datos de autocompletado si planeas subirlo y usarlo.
No se permite importar datos de otro proyecto.

Importa datos de autocompletado

Importa datos de autocompletado desde BigQuery

Vertex AI Search para venta minorista admite la importación de datos de BigQuery para la lista de entidades rechazadas, la lista de entidades que no se deben quitar y la lista de términos de sugerencias. Consulta más detalles en Autocompletar.

Si quieres importar datos de autocompletado en el formato correcto desde BigQuery, usa el esquema de autocompletado de venta minorista de la Búsqueda de Vertex AI para crear una tabla de BigQuery con el formato correcto y cargar la tabla con tus datos de autocompletado. Luego, sube tus datos a Vertex AI Search para la venta minorista.

Si deseas obtener más ayuda con las tablas de BigQuery, consulta Introducción a las tablas. Para obtener ayuda con las consultas de BigQuery, consulta Descripción general de las consultas de datos de BigQuery.

Ubicación del conjunto de datos de BigQuery

Cuando crees tu conjunto de datos de BigQuery por primera vez para tus tablas de BigQuery de autocompletado, asegúrate de que la ubicación del conjunto de datos esté configurada en la ubicación multirregional "US". Si no lo configuras correctamente, tu solicitud de importación fallará más adelante. Para obtener más información sobre las ubicaciones de los conjuntos de datos de BigQuery, consulta Ubicaciones de los conjuntos de datos en la documentación de BigQuery.

Cómo propagar datos a BigQuery

Usa el esquema de autocompletado de venta minorista de la Búsqueda de Vertex AI para subir tus datos de autocompletado a BigQuery.

BigQuery puede usar el esquema para validar si los datos con formato JSON tienen nombres y tipos de campo correctos (como STRING, INTEGER y RECORD), pero no pueden realizar validaciones, como la determinación:

Si un campo de string se asignó a un valor de enumeración reconocible.
Si un campo de string usa el formato correcto.
Si un campo de número entero o flotante tiene valor en un rango válido.
Si un campo faltante es un campo obligatorio.

Para garantizar la calidad de tus datos y la experiencia de búsqueda del usuario final, asegúrate de consultar el esquema y la documentación de referencia para obtener detalles sobre los valores y formatos.

Configura el acceso a tu conjunto de datos de BigQuery

Para configurar el acceso, asegúrate de que tu conjunto de datos de BigQuery esté en el mismo proyecto que tu servicio de Búsqueda de Vertex AI para venta minorista y completa los siguientes pasos.

Abre la página de IAM en la consola de Google Cloud.

Abrir la página IAM
Selecciona tu proyecto de Vertex AI Search para la venta minorista.
En la página IAM y administración, haz clic en Otorgar acceso.
En Principales nuevos, ingresa cloud-retail-customer-data-access@system.gserviceaccount.com y selecciona el rol BigQuery > Visualizador de datos de BigQuery.

Si no deseas proporcionar la función de Lector de datos a todo el proyecto, puedes agregar esta función directamente al conjunto de datos. Más información
Haz clic en Guardar.

Activa la importación de datos a Vertex AI Search para la venta minorista

Console

Ir a la página Controles
Ve a la pestaña Controles de autocompletar.
En la sección Listas de términos, busca el tipo de lista que deseas importar (Lista de bloqueo, Lista de no quitar o Lista de términos sugeridos) y haz clic en Importar o Reemplazar.

Se abrirá el panel Importar.
Ingresa la ruta de BigQuery de tu ubicación de datos o selecciona Explorar para seleccionarla.

La ruta de BigQuery debe estar en el mismo proyecto y su esquema debe ser correcto. Para verificar esto, haz clic en Explorar y, luego, en el nombre de la tabla para ver su contenido en la consola de BigQuery.
En el panel Importar, haz clic en Importar.

Comienza la importación. Puedes salir de la página sin interrumpir la importación.

cURL

Crea un archivo de datos para los parámetros de entrada de la importación. Los valores de tus parámetros de entrada dependen de si importas desde Cloud Storage o BigQuery.

Usa el objeto BigQuerySource para apuntar a tu conjunto de datos de BigQuery.
- dataset-id: el ID del conjunto de datos de BigQuery.
- table-id: el ID de la tabla de BigQuery que contiene tus datos.
- data-schema: Para la propiedad dataSchema, usa el valor suggestions (predeterminado), allowlist y denylist. Usa el esquema de autocompletado de Vertex AI Search para la venta minorista.
```
{
  "inputConfig":{
    "bigQuerySource": {
      "datasetId":"dataset-id",
      "tableId":"table-id",
      "dataSchema":"data-schema"
    }
  }
}
```

Importa la información de autocompletado a Vertex AI Search para la venta minorista mediante una solicitud POST al método de REST CompletionData:import y proporciona el nombre del archivo de datos (se muestra como input.json en el siguiente ejemplo).

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" -d @./input.json
"https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/completionData:import"

Puedes verificar el estado de manera programática mediante la API. Deberías recibir un objeto de respuesta similar al siguiente:

{
  "name": "projects/PROJECT_ID/locations/global/catalogs/default_catalog/operations/123456",
  "done": false
}

El campo de nombre es el ID del objeto de operación. Para solicitar el estado de este objeto, reemplaza el campo de nombre por el valor que muestra el método de importación. Cuando se completa la importación, el campo done se muestra como true:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/locations/global/catalogs/default_catalog/operations/123456"

Cuando se completa la operación, el objeto que se muestra tiene un valor done de true y, además, incluye un objeto de estado similar al siguiente ejemplo:

{
  "name": "projects/PROJECT_ID/locations/global/catalogs/default_catalog/operations/123456",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.retail.v2alpha.ImportMetadata",
    "createTime": "2020-01-01T03:33:33.000001Z",
    "updateTime": "2020-01-01T03:34:33.000001Z",
    "successCount": "2",
    "failureCount": "1"
  },
  "done": true
  "response": {
    "@type": "type.googleapis.com/google.cloud.retail.v2alpha.ImportCompletionDataResponse",
  }
}

Formato de datos de Autocomplete

Tu archivo JSON debería verse como los siguientes ejemplos: Los saltos de línea son para facilitar la lectura; debes proporcionar una sugerencia completa en una sola línea. Cada sugerencia debe estar en su propia línea.

Campos obligatorios mínimos de las sugerencias:

{
  "suggestion": "ABC",
  "globalScore": "0.5"
}

{
  "suggestion": "ABC",
  "frequency": "100"
}

Duración de la importación de datos de autocompletado

Por lo general, una importación desde BigQuery tarda entre unos minutos y una hora en completarse.

Cuando finaliza la importación del conjunto de datos, el campo done en el objeto de operación se marca como verdadero. Después de eso, es posible que los datos tarden entre 1 y 2 días más en indexarse y usarse en la publicación en producción.

Mantén actualizado tu conjunto de datos de autocompletado

Si planeas usar tu propio conjunto de datos subido, se recomienda mantenerlo actualizado con regularidad.

Actualización por lotes

Puedes usar el método de importación para actualizar por lotes el autocompletado. El procedimiento es el mismo que para la importación inicial; sigue los pasos en Importación de datos de autocompletado. Esto reemplazará todo el conjunto de datos importado.

Supervisa el estado de la importación

Mantener actualizado tu conjunto de datos es importante para obtener resultados de sugerencias de alta calidad cuando los uses. Debes supervisar las tasas de error de importación y tomar medidas si es necesario.

Esquema de autocompletado de Vertex AI Search para la venta minorista

Cuando importes un conjunto de datos de autocompletado desde BigQuery, usa el esquema de búsqueda de venta minorista de Vertex AI que se encuentra a continuación para crear tablas de BigQuery con el formato correcto y cargarlas con tus datos de autocompletado.

Esquema para sugerencias

Este conjunto de datos se usa para proporcionar tus propias frases de sugerencias de autocompletado con tus propias puntuaciones.

JSON del esquema de sugerencias de autocompletado de Vertex AI Search para la venta minorista

JSON

[
  {
    "description": "The suggestion text",
    "mode": "NULLABLE",
    "name": "suggestion",
    "type": "STRING"
  },
  {
    "description": "Global score of this suggestion. Control how this suggestion would be scored / ranked. Only one of this and frequency should be set.",
    "mode": "NULLABLE",
    "name": "globalScore",
    "type": "FLOAT"
  },
  {
    "description": "Frequency of this suggestion. Will be used to rank suggestions when score is not available.",
    "mode": "NULLABLE",
    "name": "frequency",
    "type": "INTEGER"
  },
  {
    "description": "BCP-47 language code of this suggestion.",
    "mode": "NULLABLE",
    "name": "languageCode",
    "type": "STRING"
  },
  {
    "description": "If two suggestions have the same groupID, they will not be returned together. Instead the one ranked higher will be returned. This can be used to deduplicate semantically identical suggestions.",
    "mode": "NULLABLE",
    "name": "groupID",
    "type": "STRING"
  },
  {
    "description": "The score of this suggestion within its group",
    "mode": "NULLABLE",
    "name": "groupScore",
    "type": "FLOAT"
  },
  {
    "description": "Device type for this suggestion.",
    "mode": "NULLABLE",
    "name": "deviceType",
    "type": "STRING"
  },
  {
    "description": "Alternative matching phrases for this suggestion.",
    "mode": "REPEATED",
    "name": "alternativePhrases",
    "type": "STRING"
  },
  {
    "fields": [
      {
        "description": "The name of the custom attribute.",
        "mode": "NULLABLE",
        "name": "key",
        "type": "STRING"
      },
      {
        "fields": [
          {
            "description": "The textual values of this custom attribute.",
            "mode": "REPEATED",
            "name": "text",
            "type": "STRING"
          },
          {
            "description": "The numerical values of this custom attribute.",
            "mode": "REPEATED",
            "name": "numbers",
            "type": "FLOAT"
          }
        ],
        "mode": "NULLABLE",
        "name": "value",
        "type": "RECORD"
      }
    ],
    "description": "A custom attribute that is not explicitly modeled, which can be retrieved together with the suggestion at serving time.",
    "mode": "REPEATED",
    "name": "customAttributes",
    "type": "RECORD"
  }
]

Esquema para la lista de bloqueo

Este conjunto de datos se usa como una lista de bloqueo para evitar que se sugieran frases.

JSON del esquema de la lista de bloqueo de autocompletado de Vertex AI Search para la venta minorista

JSON

[
  {
    "description": "The phrase to block from autocomplete suggestions.",
    "mode": "REQUIRED",
    "name": "phrase",
    "type": "STRING"
  },
  {
    "description": "The operator to apply for this phrase. Choose whether to block the exact phrase, or block any suggestions containing this phrase. Supported value \"EXACT_MATCH\", \"CONTAINS\"",
    "mode": "REQUIRED",
    "name": "operator",
    "type": "STRING"
  }
]

Esquema para la lista de entidades permitidas

Este conjunto de datos se usa para omitir los procesos posteriores (como la corrección ortográfica y el filtrado de resultados nulos) en todas las frases de esta lista de entidades permitidas.

JSON del esquema de la lista de entidades permitidas de autocompletado de Vertex AI Search para la venta minorista

JSON

[
  {
    "description": "The phrase to be exempted from autocomplete post processing, e.g. spell correction, filtering",
    "mode": "REQUIRED",
    "name": "phrase",
    "type": "STRING"
  },
  {
    "description": "The operator to apply for this phrase. Whether to match the exact phrase, or any suggestions contain this phrase. Supported values are \"EXACT_MATCH\", \"CONTAINS\".",
    "mode": "REQUIRED",
    "name": "operator",
    "type": "STRING"
  }
]