Usar Vertex AI Feature Store

SAP BTP edition v1.1

• Edición SAP BTP v1.1
• Edición local o cualquier edición en la nube v1.9

En este documento, se describe cómo usar Vertex AI Feature Store para realizar tareas como sincronizar una tienda en línea, entregar atributos desde una tienda en línea y buscar un almacén de atributos en línea con una entidad o incorporaciones con el SDK de Vertex AI para ABAP.

Vertex AI Feature Store es un servicio administrado de almacenamiento de atributos nativo de la nube. Permite optimizar los procesos de administración de atributos de aprendizaje automático y de entrega en línea, ya que te permite administrar tus datos de atributos en una tabla o vista de BigQuery.

En un flujo de trabajo típico de una configuración de Vertex AI Feature Store, primero preparas tu fuente de datos de SAP en BigQuery, registras tus fuentes de datos creando grupos de atributos y atributos, y configuras la tienda en línea y los recursos de vista de atributos. Luego, puedes entregar los valores de atributos más recientes en línea desde una vista de atributos o realizar una búsqueda de similitud en el almacén de atributos en línea. Para obtener información sobre cómo configurar Vertex AI Feature Store, consulta Vertex AI Feature Store.

Una vez que tu Vertex AI Feature Store esté listo para la entrega en línea, puedes usar el SDK de Vertex AI para ABAP para lo siguiente:

• Para proporcionar los valores de atributos más actualizados y precisos para la publicación en tiempo real durante la predicción del modelo, sincroniza tu tienda en línea con la fuente de datos de atributos en BigQuery.
• Para proporcionar valores de atributos desde una tienda en línea para aplicaciones en tiempo real, entrega atributos desde la tienda en línea.
• Para recuperar una lista de entidades semánticamente similares o relacionadas de la tienda en línea, realiza la búsqueda con una entidad o incorporación.

Antes de comenzar

Antes de usar el SDK de Vertex AI para ABAP con Vertex AI Feature Store, asegúrate de que tú o tus administradores hayan completado los siguientes requisitos previos:

• Habilitaste la API de Vertex AI en tu proyecto de Google Cloud.
• Instalaste el SDK de Vertex AI para ABAP en tu entorno de SAP.
• Configura la autenticación para acceder a la API de Vertex AI.
• Configura la entrega de atributos en línea. Para aprender a crear y usar una tienda en línea para alojar y entregar datos en BigQuery con Vertex AI Feature Store en un flujo de trabajo de extremo a extremo, consulta los instructivos de notebooks de Jupyter para Vertex AI Feature Store.

Crea una instancia de la clase ABAP para Vertex AI Feature Store

Para usar Vertex AI Feature Store en tu aplicación ABAP, debes crear una instancia de la clase /GOOG/CL_FEATURE_STORE.

DATA(lo_client) = NEW /goog/cl_feature_store(
                          iv_key_name         = 'CLIENT_KEY'
                          iv_location         = 'LOCATION_ID'
                          iv_feature_store_id = 'FEATURE_ONLINE_STORE_NAME' ).

Reemplaza lo siguiente:

• CLIENT_KEY: Es la clave del cliente configurada para la autenticación.
• LOCATION_ID: región en donde se encuentra la tienda en línea, como us-central1.
• FEATURE_ONLINE_STORE_NAME: Es el nombre de la tienda en línea que contiene la vista de atributos.

Sincroniza la tienda en línea

Para asegurarte de que tu tienda en línea tenga los valores de atributos más actualizados y precisos para la publicación en tiempo real durante la predicción del modelo, debes sincronizar los recursos de vista de atributos de tu tienda en línea con la fuente de datos de atributos en BigQuery.

Antes de comenzar

Como accedes a Vertex AI Feature Store a través de un extremo regional, debes crear un sistema de comunicación, un acuerdo de comunicación y configurar la clave de cliente según corresponda.

1. Accede al SAP Fiori launchpad del sistema BTP ABAP en el que está instalado el SDK de ABAP para Google Cloud.

2. Ve a Todos los espacios > Administración > Administración de la comunicación.

3. Crea un sistema de comunicación:

   1. Abre la app Communication Systems.
   2. Haz clic en Nuevo.

   3. En el diálogo Nuevo sistema de comunicación que aparece, ingresa un valor para los siguientes campos:

      • ID del sistema: ingresa un ID del sistema.
      • Nombre del sistema: ingresa un nombre del sistema.

   4. Haz clic en Crear.

   5. En el campo Nombre de host, ingresa la URL del extremo regional. Por ejemplo, si tu Vertex AI Feature Store reside en us-east1, el extremo del host de destino es us-east1-aiplatform.googleapis.com. Para obtener información sobre los extremos regionales, consulta Extremo de servicio.

   6. En el campo Puerto, escribe 443.

   7. En la pestaña Usuarios para la comunicación saliente, haz clic en Agregar.

   8. En el campo Método de autenticación, selecciona Ninguno.

   9. Haz clic en Guardar.

4. Crea un acuerdo de comunicación:

   1. Abre la app Communication Arrangement.
   2. Haz clic en Nuevo.

   3. En el diálogo Nuevo acuerdo de comunicaciones que aparece, ingresa un valor para los siguientes campos:

      • Situación: Selecciona Autenticación mediante la federación de Workload Identity (/GOOG/COM_SDK_SRV).
      • Nombre del acuerdo: ingresa un nombre para el acuerdo de comunicación.

   4. Haz clic en Crear.

   5. Para la entrada de acuerdo de comunicación que aparece, en el campo Sistema de comunicación, selecciona el sistema de comunicación que creaste en el paso anterior.

   6. Haz clic en Guardar.

5. Crea una clave de cliente y un mapa de comunicación:

   1. Ve al espacio que contiene las apps de SAP Fiori para la configuración del SDK.
   2. Abre la app de SDK de Google: configuración principal.
   3. Haz clic en Crear.
   4. En el cuadro de diálogo Crear que aparece, ingresa un nombre de clave de cliente.
   5. Haz clic en Continuar.

   6. Ingresa un valor para los siguientes campos:

      • Cuenta de servicio: Ingresa la cuenta de servicio que tiene acceso a las APIs de Google Cloud .
      • ID del proyecto: Ingresa el ID del proyecto de Google Cloud en el que habilitaste las APIs de Google Cloud . Para obtener información sobre el ID del proyecto, consulta Identifica proyectos.
      • Número de proyecto: Ingresa el número de proyecto de Google Cloud en el que habilitaste las APIs de Google Cloud . Para obtener información sobre el número de proyecto, consulta Identifica proyectos.
      • Tipo de autenticación: Selecciona W (federación de Workload Identity).

   7. Para el mapa de comunicación de la entrada predeterminada del nombre del servicio como "autenticación", proporciona el acuerdo de comunicación que configuraste para la autenticación basada en WIF.

   8. Agrega una entrada más al mapa de comunicación y elige el servicio como aiplatform:v1 y proporciona el acuerdo de comunicación como el que acabas de crear.

   9. Haz clic en Crear. Aparecerá un cuadro de diálogo que confirma que aceptas usar el SDK de ABAP para Google Cloud según las condiciones Google Cloud estándares.

   10. Para validar la configuración de autenticación, haz clic en Verificar conexión. Una marca de verificación verde en una entrada indica que la configuración se realizó correctamente.

       Si se produce algún error, consulta la guía de solución de problemas para obtener información sobre cómo resolver los errores comunes.

Sincroniza Vertex AI Feature Store

Para iniciar una sincronización de datos en una vista de atributos, usa el método SYNC_FEATURE_DATA_TO_FS.

DATA(lv_feature_view_sync_id) = lo_client->sync_feature_data_to_fs(
                                             iv_feature_view_id = 'FEATURE_VIEW_NAME'
                                        )->get_feature_sync_id( ).

Reemplaza FEATURE_VIEW_NAME por el nombre de la vista de componentes para la que deseas iniciar la sincronización de datos.

Este método muestra un ID de sincronización de vista de componentes, que se puede usar para verificar el estado de la sincronización.

Obtén el estado de la sincronización de Vertex AI Feature Store

Para obtener el estado de una sincronización de Vertex AI Feature Store, puedes usar el método GET_FEATURE_SYNC_STATUS.

DATA(ls_status) = lo_client->get_feature_sync_status(
                               iv_feature_view_id     = 'FEATURE_VIEW_NAME'
                               iv_feature_sync_id     = 'FEATURE_VIEW_SYNC_ID'
              )->get_feature_sync_status( ).

Reemplaza lo siguiente:

• FEATURE_VIEW_NAME: Es el nombre de la vista de atributos de la que deseas verificar el estado de sincronización.

• FEATURE_VIEW_SYNC_ID: El ID de sincronización de la vista de funciones que se recibió de Sync Vertex AI Feature Store.

  Este método muestra uno de los siguientes estados junto con el mensaje de error, si corresponde: C: Complete, R: Running o F: Failed.

Publica funciones desde una tienda en línea

Puedes publicar valores de atributos desde una tienda en línea para aplicaciones en tiempo real, como las recomendaciones de productos. Según el tipo de entrega en línea que configuraste para tu tienda en línea, puedes entregar valores de atributos de una de las siguientes maneras:

• Recupera valores de atributos mediante la entrega en línea de Bigtable
• Recupera valores de atributos mediante la entrega en línea optimizada con un extremo público.
• Recupera valores de atributos mediante la entrega en línea optimizada con un extremo de Private Service Connect.

Para obtener más información sobre la entrega de valores de atributos, consulta Cómo publicar atributos desde una tienda en línea.

Antes de comenzar

Antes de comenzar a publicar valores de atributos desde una tienda en línea, debes recuperar el nombre de dominio del extremo público de los detalles de la tienda en línea. Después de esto, debes crear un sistema de comunicación y un acuerdo de comunicación, y configurarlos en la configuración de claves del cliente con la app de SAP Fiori SDK de Google: configuración principal.

1. Para recuperar el extremo público, crea el ZCL_GET_FEATURE_STORE_PUB_EP en un paquete local que elijas. Debes pasar una clave de cliente válida, el ID y la ubicación de Vertex AI Feature Store.

   CLASS zcl_get_feature_store_pub_ep DEFINITION
   PUBLIC FINAL
   CREATE PUBLIC.
   PUBLIC SECTION.
      INTERFACES if_oo_adt_classrun.
   ENDCLASS.
   CLASS zcl_get_feature_store_pub_ep IMPLEMENTATION.
   METHOD if_oo_adt_classrun~main.
      DATA lv_ckey        TYPE /goog/keyname.
      DATA lv_location_id TYPE string.
      DATA lv_fsid        TYPE string.
      DATA lv_project_id  TYPE string.
      DATA lv_msg         TYPE string.
   
      "TODO:Developer - Pass relevant values
      lv_ckey = 'CLIENT_KEY'.
      lv_fsid = 'FEATURE_ONLINE_STORE_NAME'.
      lv_location_id = 'LOCATION_ID'.
      TRY.
         DATA(lo_aip) = NEW  /goog/cl_aiplatform_v1( iv_key_name = lv_ckey ).
         lv_project_id = lo_aip->gv_project_id.
         " Call API method: aiplatform.projects.locations.featureOnlineStores.get
         lo_aip->get_feature_online_stores( EXPORTING iv_p_projects_id              = lv_project_id
                                                      iv_p_locations_id             = lv_location_id
                                                      iv_p_feature_online_stores_id = lv_fsid
                                             IMPORTING es_output                     = DATA(ls_output)
                                                      ev_ret_code                   = DATA(lv_ret_code)
                                                      ev_err_text                   = DATA(lv_err_text) ).
         IF lo_aip->is_success( lv_ret_code ) = abap_true.
            out->write( | Public endpoint is| ).
            out->write( ls_output-dedicated_serving_endpoint-public_endpoint_domain_name ).
         ENDIF.
         CATCH /goog/cx_sdk INTO DATA(lo_cx_sdk).
         lv_msg = lo_cx_sdk->get_text( ).
         out->write( |Exception occurred, reason: { lv_msg }| ).
      ENDTRY.
   ENDMETHOD.
   ENDCLASS.
   

2. Activa y ejecuta la clase ZCL_GET_FEATURE_STORE_PUB_EP.

   El resultado, que es el extremo público de tu tienda en línea, usa el siguiente formato:

   xxxxxxxxxx.LOCATION_ID-PROJECT_ID.featurestore.vertexai.goog
   

   En esta salida, se incluyen los siguientes valores:

   • LOCATION_ID: Es la región en la que se encuentra tu tienda en línea.
   • PROJECT_ID: El ID del proyecto de Google Cloud en el que se encuentra tu tienda en línea.

3. Accede al SAP Fiori launchpad del sistema BTP ABAP en el que está instalado el SDK de ABAP para Google Cloud.

4. Ve a Todos los espacios > Administración > Administración de la comunicación.

5. Crea un sistema de comunicación:

   1. Abre la app Communication Systems.
   2. Haz clic en Nuevo.

   3. En el diálogo Nuevo sistema de comunicación que aparece, ingresa un valor para los siguientes campos:

      • ID del sistema: ingresa un ID del sistema.
      • Nombre del sistema: ingresa un nombre del sistema.

   4. Haz clic en Crear.

   5. En el campo Nombre de host, ingresa el extremo público que recuperaste ejecutando la clase ZCL_GET_FEATURE_STORE_PUB_EP en un paso anterior.

   6. En el campo Puerto, escribe 443.

   7. Ve a la pestaña Usuarios para la comunicación saliente y haz clic en Agregar.

   8. En el campo Método de autenticación, selecciona Ninguno.

   9. Haz clic en Guardar.

6. Crea un acuerdo de comunicación:

   1. Abre la app Communication Arrangements.
   2. Haz clic en Nuevo.

   3. En el diálogo Nuevo acuerdo de comunicaciones que aparece, ingresa un valor para los siguientes campos:

      • Situación: Selecciona Autenticación mediante la federación de Workload Identity (/GOOG/COM_SDK_SRV).
      • Nombre del acuerdo: ingresa un nombre para el acuerdo de comunicación.

   4. Haz clic en Crear.

   5. Para la entrada de acuerdo de comunicación que aparece, en el campo Sistema de comunicación, selecciona el sistema de comunicación que creaste en el paso anterior.

   6. Haz clic en Guardar.

7. Crea una clave de cliente y un mapa de comunicación:

   1. Ve al espacio que contiene las apps de SAP Fiori para la configuración del SDK.
   2. Abre la app de SDK de Google: configuración principal.
   3. Haz clic en Crear.
   4. En el cuadro de diálogo Crear que aparece, ingresa un nombre de clave de cliente.
   5. Haz clic en Continuar.

   6. Ingresa los siguientes detalles:

      • Cuenta de servicio: Ingresa la cuenta de servicio que tiene acceso a las APIs de Google Cloud .
      • ID del proyecto: Ingresa el ID del proyecto de Google Cloud en el que habilitaste las APIs de Google Cloud . Para obtener información sobre el ID del proyecto, consulta Identifica proyectos.
      • Número de proyecto: Ingresa el número de proyecto de Google Cloud en el que habilitaste las APIs de Google Cloud . Para obtener información sobre el número de proyecto, consulta Identifica proyectos.
      • Tipo de autenticación: Selecciona W (federación de Workload Identity).

   7. Para el mapa de comunicación de la entrada predeterminada del nombre del servicio como "autenticación", proporciona el acuerdo de comunicación que configuraste para la autenticación basada en WIF.

   8. Agrega una entrada más al mapa de comunicación y elige el servicio como aiplatform:v1 y proporciona el acuerdo de comunicación como el que acabas de crear.

   9. Haz clic en Crear. Aparecerá un cuadro de diálogo que confirma que aceptas usar el SDK de ABAP para Google Cloud según las condiciones Google Cloud estándares.

   10. Para validar la configuración de autenticación, haz clic en Verificar conexión. Una marca de verificación verde en una entrada indica que la configuración se realizó correctamente.

       Si se produce algún error, consulta la guía de solución de problemas para obtener información sobre cómo resolver los errores comunes.

8. Verifica que tu mapa de comunicación contenga las siguientes tres entradas:

   Nombre del servicio	Situación de comunicación	Acuerdo de comunicación
   authentication	/GOOG/SDK_COM_WIF	Acuerdo de comunicación que creaste para el servicio XSUAA
   aiplatform:v1	/GOOG/COM_SDK_SRV	Es el acuerdo de comunicación que estableciste con el sistema de comunicación que contiene el extremo regional para AI PLATFORM.
   apiinvoker:v1	/GOOG/COM_SDK_SRV	El acuerdo de comunicación que configuraste con el sistema de comunicación para el extremo público de la entrega de Vertex AI Feature Store en el paso anterior

Recupera valores de funciones

En Vertex AI Feature Store, una entidad hace referencia a un elemento del que deseas hacer un seguimiento de atributos, como un cliente, un producto o cualquier otro dato. Cada entidad está asociada con un conjunto de atributos y sus valores correspondientes.

Para recuperar valores de atributos especificando un solo ID de entidad, usa el método SERVE_FEATURE_VALUES.

DATA(lt_features) = lo_client->serve_feature_values(
                         iv_feature_view_id = 'FEATURE_VIEW_NAME'
                             it_entity_id       = 'ENTITY_ID'
                )->get_features( ).

Reemplaza lo siguiente:

• FEATURE_VIEW_NAME: El nombre de la vista de atributos desde la que deseas entregar valores de atributos.
• ENTITY_ID: Es el valor de la columna de ID en el registro de atributos desde el que deseas publicar los valores de atributos más recientes. Como alternativa, puedes proporcionar un array de partes para construir el ID de la entidad. Asegúrate de que las columnas de ID estén en el mismo orden que se define en la vista de atributos.

Busca vecinos más cercanos aproximados

En el caso de las tiendas en línea creadas para la entrega en línea optimizada, puedes realizar una búsqueda de similitud de vectores para recuperar una lista de entidades semánticamente similares o relacionadas, también llamadas vecinos más cercanos aproximados. Puedes buscar vecinos más cercanos aproximados según un ID de entidad o una incorporación.

Antes de comenzar

Antes de comenzar a publicar valores de atributos desde una tienda en línea, debes recuperar el nombre de dominio del extremo público de los detalles de la tienda en línea. Después de esto, debes crear un sistema de comunicación y un acuerdo de comunicación, y configurarlos en la configuración de claves del cliente con la app de SAP Fiori SDK de Google: configuración principal.

1. Para recuperar el extremo público, crea el ZCL_GET_FEATURE_STORE_PUB_EP en un paquete local que elijas. Debes pasar una clave de cliente válida, el ID y la ubicación de Vertex AI Feature Store.

   CLASS zcl_get_feature_store_pub_ep DEFINITION
   PUBLIC FINAL
   CREATE PUBLIC.
   PUBLIC SECTION.
      INTERFACES if_oo_adt_classrun.
   ENDCLASS.
   CLASS zcl_get_feature_store_pub_ep IMPLEMENTATION.
   METHOD if_oo_adt_classrun~main.
      DATA lv_ckey        TYPE /goog/keyname.
      DATA lv_location_id TYPE string.
      DATA lv_fsid        TYPE string.
      DATA lv_project_id  TYPE string.
      DATA lv_msg         TYPE string.
   
      "TODO:Developer - Pass relevant values
      lv_ckey = 'CLIENT_KEY'.
      lv_fsid = 'FEATURE_ONLINE_STORE_NAME'.
      lv_location_id = 'LOCATION_ID'.
      TRY.
         DATA(lo_aip) = NEW  /goog/cl_aiplatform_v1( iv_key_name = lv_ckey ).
         lv_project_id = lo_aip->gv_project_id.
         " Call API method: aiplatform.projects.locations.featureOnlineStores.get
         lo_aip->get_feature_online_stores( EXPORTING iv_p_projects_id              = lv_project_id
                                                      iv_p_locations_id             = lv_location_id
                                                      iv_p_feature_online_stores_id = lv_fsid
                                             IMPORTING es_output                     = DATA(ls_output)
                                                      ev_ret_code                   = DATA(lv_ret_code)
                                                      ev_err_text                   = DATA(lv_err_text) ).
         IF lo_aip->is_success( lv_ret_code ) = abap_true.
            out->write( | Public endpoint is| ).
            out->write( ls_output-dedicated_serving_endpoint-public_endpoint_domain_name ).
         ENDIF.
         CATCH /goog/cx_sdk INTO DATA(lo_cx_sdk).
         lv_msg = lo_cx_sdk->get_text( ).
         out->write( |Exception occurred, reason: { lv_msg }| ).
      ENDTRY.
   ENDMETHOD.
   ENDCLASS.
   

2. Activa y ejecuta la clase ZCL_GET_FEATURE_STORE_PUB_EP.

   El resultado, que es el extremo público de tu tienda en línea, usa el siguiente formato:

   xxxxxxxxxx.LOCATION_ID-PROJECT_ID.featurestore.vertexai.goog
   

   En esta salida, se incluyen los siguientes valores:

   • LOCATION_ID: Es la región en la que se encuentra tu tienda en línea.
   • PROJECT_ID: El ID del proyecto de Google Cloud en el que se encuentra tu tienda en línea.

3. Accede al SAP Fiori launchpad del sistema BTP ABAP en el que está instalado el SDK de ABAP para Google Cloud.

4. Ve a Todos los espacios > Administración > Administración de la comunicación.

5. Crea un sistema de comunicación:

   1. Abre la app Communication Systems.
   2. Haz clic en Nuevo.

   3. En el diálogo Nuevo sistema de comunicación que aparece, ingresa un valor para los siguientes campos:

      • ID del sistema: ingresa un ID del sistema.
      • Nombre del sistema: ingresa un nombre del sistema.

   4. Haz clic en Crear.

   5. En el campo Nombre de host, ingresa el extremo público que recuperaste ejecutando la clase ZCL_GET_FEATURE_STORE_PUB_EP en un paso anterior.

   6. En el campo Puerto, escribe 443.

   7. Ve a la pestaña Usuarios para la comunicación saliente y haz clic en Agregar.

   8. En el campo Método de autenticación, selecciona Ninguno.

   9. Haz clic en Guardar.

6. Crea un acuerdo de comunicación:

   1. Abre la app Communication Arrangements.
   2. Haz clic en Nuevo.

   3. En el diálogo Nuevo acuerdo de comunicaciones que aparece, ingresa un valor para los siguientes campos:

      • Situación: Selecciona Autenticación mediante la federación de Workload Identity (/GOOG/COM_SDK_SRV).
      • Nombre del acuerdo: ingresa un nombre para el acuerdo de comunicación.

   4. Haz clic en Crear.

   5. Para la entrada de acuerdo de comunicación que aparece, en el campo Sistema de comunicación, selecciona el sistema de comunicación que creaste en el paso anterior.

   6. Haz clic en Guardar.

7. Crea una clave de cliente y un mapa de comunicación:

   1. Ve al espacio que contiene las apps de SAP Fiori para la configuración del SDK.
   2. Abre la app de SDK de Google: configuración principal.
   3. Haz clic en Crear.
   4. En el cuadro de diálogo Crear que aparece, ingresa un nombre de clave de cliente.
   5. Haz clic en Continuar.

   6. Ingresa los siguientes detalles:

      • Cuenta de servicio: Ingresa la cuenta de servicio que tiene acceso a las APIs de Google Cloud .
      • ID del proyecto: Ingresa el ID del proyecto de Google Cloud en el que habilitaste las APIs de Google Cloud . Para obtener información sobre el ID del proyecto, consulta Identifica proyectos.
      • Número de proyecto: Ingresa el número de proyecto de Google Cloud en el que habilitaste las APIs de Google Cloud . Para obtener información sobre el número de proyecto, consulta Identifica proyectos.
      • Tipo de autenticación: Selecciona W (federación de Workload Identity).

   7. Para el mapa de comunicación de la entrada predeterminada del nombre del servicio como "autenticación", proporciona el acuerdo de comunicación que configuraste para la autenticación basada en WIF.

   8. Agrega una entrada más al mapa de comunicación y elige el servicio como aiplatform:v1 y proporciona el acuerdo de comunicación como el que acabas de crear.

   9. Haz clic en Crear. Aparecerá un cuadro de diálogo que confirma que aceptas usar el SDK de ABAP para Google Cloud según las condiciones Google Cloud estándares.

   10. Para validar la configuración de autenticación, haz clic en Verificar conexión. Una marca de verificación verde en una entrada indica que la configuración se realizó correctamente.

       Si se produce algún error, consulta la guía de solución de problemas para obtener información sobre cómo resolver los errores comunes.

8. Verifica que tu mapa de comunicación contenga las siguientes tres entradas:

   Nombre del servicio	Situación de comunicación	Acuerdo de comunicación
   authentication	/GOOG/SDK_COM_WIF	Acuerdo de comunicación que creaste para el servicio XSUAA
   aiplatform:v1	/GOOG/COM_SDK_SRV	Es el acuerdo de comunicación que estableciste con el sistema de comunicación que contiene el extremo regional para AI PLATFORM.
   apiinvoker:v1	/GOOG/COM_SDK_SRV	El acuerdo de comunicación que configuraste con el sistema de comunicación para el extremo público de la entrega de Vertex AI Feature Store en el paso anterior

Recupera las coincidencias de vecino más cercano de una incorporación

Para buscar entidades relacionadas semánticamente, especifica una incorporación.

Para buscar vecinos más cercanos para una incorporación, envía una solicitud con el método SEARCH_USING_EMBEDDINGS.

DATA(lt_embeddings) = VALUE /goog/cl_aiplatform_v1=>ty_t_/goog/num_float( EMBEDDING_DATA ).

DATA(lt_neighbours) = lo_client->search_using_embeddings(
  EXPORTING
    iv_feature_view_id = 'FEATURE_VIEW_NAME'
    it_embeddings      = lt_embeddings
    is_search_params   = VALUE #( neighbor_count     = 'NEIGHBOR_COUNT'
                                  return_full_entity = 'RETURN_FULL_ENTITY' )
)->get_neighbours( ).

Reemplaza lo siguiente:

• EMBEDDING_DATA: Es la incorporación para la que deseas recuperar las coincidencias de vecino más cercano aproximado. Una incorporación se representa con un array de valores de punto flotante.
• FEATURE_VIEW_NAME: El nombre de la vista de características en la que deseas buscar las coincidencias aproximadas de los vecinos más cercanos.
• NEIGHBOR_COUNT: La cantidad de vecinos más cercanos aproximados que deseas recuperar.
• RETURN_FULL_ENTITY: Opcional Especifica si deseas incluir o excluir las funciones de las entidades en la respuesta. Para incluir los atributos junto con las entidades en la respuesta, ingresa ABAP_TRUE. El valor predeterminado es ABAP_FALSE.

Recupera las coincidencias de vecino más cercano de una entidad

Para buscar entidades relacionadas semánticamente, especifica un ID de entidad.

Para buscar vecinos más cercanos de un ID de entidad, envía una solicitud con el método SEARCH_USING_ENTITY.

DATA(lt_neighbours) = lo_client->search_using_entity(
  EXPORTING
    iv_feature_view_id = 'FEATURE_VIEW_NAME'
    iv_entity_id       = 'ENTITY_ID'
    is_search_params   = VALUE #( neighbor_count     = 'NEIGHBOR_COUNT'
                                  return_full_entity = 'RETURN_FULL_ENTITY' )
)->get_neighbours( ).

Reemplaza lo siguiente:

• FEATURE_VIEW_NAME: El nombre de la vista de características en la que deseas buscar las coincidencias aproximadas de los vecinos más cercanos.
• ENTITY_ID:: El ID de la entidad para la que deseas recuperar las coincidencias de vecino más cercano aproximado.
• NEIGHBOR_COUNT: La cantidad de vecinos más cercanos aproximados que deseas recuperar.
• RETURN_FULL_ENTITY: Opcional Especifica si deseas incluir o excluir las funciones de las entidades en la respuesta. Para incluir los atributos junto con las entidades en la respuesta, ingresa ABAP_TRUE. El valor predeterminado es ABAP_FALSE.

¿Qué sigue?

• Obtén información sobre el desarrollo de aplicaciones con la edición SAP BTP del SDK de ABAP para Google Cloud.
• Haz tus preguntas y analiza el SDK de Vertex AI para ABAP con la comunidad en Cloud Forums.