Preparar Assets para el etiquetado inteligente configure-asset-tagging-using-the-smart-content-service

Antes de empezar a etiquetar recursos usando Smart Content Services, integre Experience Manager Assets con Adobe Developer Console para usar el servicio inteligente de Adobe Sensei. Una vez configurado, entrene el servicio con unas pocas imágenes y una etiqueta.

NOTE
  • Smart Content Services ya no está disponible para los nuevos clientes locales de Experience Manager Assets. Los clientes locales existentes, que ya tienen esta capacidad habilitada, pueden seguir utilizando los servicios de contenido inteligente.
  • Servicios de contenido inteligente disponible para los clientes existentes de Managed Services Experience Manager Assets, que ya tienen esta capacidad habilitada.
  • Los nuevos clientes de Experience Manager Assets Managed Services pueden seguir las instrucciones que se mencionan en este artículo para configurar Smart Content Services.

Antes de usar el servicio de contenido inteligente, asegúrese de lo siguiente:

Integración con Adobe Developer Console integrate-adobe-io

Al integrarse con Adobe Developer Console, el servidor Experience Manager autentica las credenciales del servicio con la puerta de enlace de Adobe Developer Console antes de reenviar la solicitud al servicio de contenido inteligente. Para integrarse, necesita una cuenta de Adobe ID que tenga privilegios de administrador para la organización y la licencia de Smart Content Service comprada y habilitada para su organización.

Para configurar el servicio de contenido inteligente, siga estos pasos de nivel superior:

Obtenga un certificado público creando la configuración del servicio de contenido inteligente obtain-public-certificate

Un certificado público permite autenticar el perfil en Adobe Developer Console.

  1. En la interfaz de usuario de Experience Manager, acceda a Herramientas > Cloud Service > Cloud Service heredados.

  2. En la página Cloud Service, haga clic en Configurar ahora en Etiquetas inteligentes de Assets.

  3. En el cuadro de diálogo Crear configuración, especifique un título y un nombre para la configuración de etiquetas inteligentes. Haga clic en Crear.

  4. AEM En el cuadro de diálogo Servicio de contenido inteligente, use los siguientes valores:

    URL de servicio: https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>

    Por ejemplo, https://smartcontent.adobe.io/apac. Puede especificar na, emea o apac como las regiones en las que está alojada la instancia de autor de Experience Manager.

    note note
    NOTE
    Si el servicio administrado de Experience Manager se aprovisiona antes del 1 de septiembre de 2022, utilice la siguiente URL de servicio:
    https://mc.adobe.io/marketingcloud/smartcontent

    Servidor de autorización: https://ims-na1.adobelogin.com

    Deje los demás campos en blanco por ahora (se proporcionarán más adelante). Haga clic en OK.

    Cuadro de diálogo Servicio de contenido inteligente de Experience Manager para proporcionar la URL del servicio de contenido

    Figura: Cuadro de diálogo Servicio de contenido inteligente para proporcionar la URL del servicio de contenido

    note note
    NOTE
    La URL proporcionada como URL de servicio no es accesible a través del explorador y genera un error 404. La configuración funciona correctamente con el mismo valor del parámetro Service URL. Para ver el estado general del servicio y el programa de mantenimiento, consulte https://status.adobe.com.
  5. Haga clic en Descargar certificado público para la integración de OAuth y descargue el archivo de certificado público AEM-SmartTags.crt.

    Representación de la configuración creada para el servicio de etiquetado inteligente

    Figura: Configuración del servicio de etiquetado inteligente.

Volver a configurar cuando caduque un certificado certrenew

Una vez que caduca un certificado, ya no es de confianza. No puede renovar un certificado caducado. Para agregar un certificado, siga estos pasos.

  1. Inicie sesión en la implementación Experience Manager como administrador. Haga clic en Herramientas > Seguridad > Usuarios.

  2. Busque y haga clic en el usuario dam-update-service. Haga clic en la pestaña Keystore.

  3. Elimine el almacén de claves similaritysearch y el certificado caducado. Haga clic en Guardar y cerrar.

    Elimine la entrada de búsqueda de similitud existente en el almacén de claves para agregar un certificado de seguridad

    Imagen: elimine la entrada similaritysearch existente en el almacén de claves para agregar un certificado de seguridad.

  4. Vaya a Herramientas > Cloud Services > Servicios de nube heredados. Haga clic en Etiquetas inteligentes de recursos > Mostrar configuración > Configuraciones disponibles. Haga clic en la configuración requerida.

  5. Para descargar un certificado público, haga clic en Descargar certificado público para la integración de OAuth.

  6. Acceda a https://console.adobe.io y vaya a los Servicios de contenido inteligente existentes en la página Integraciones. Cargue el nuevo certificado. Para obtener más información, consulte las instrucciones de Crear integración de Adobe Developer Console.

Creación de la integración con Adobe Developer Console create-adobe-i-o-integration

Para usar las API del servicio de contenido inteligente, cree una integración en Adobe Developer Console para obtener clave de API (generada en el campo ID de cliente de la integración de Adobe Developer Console), ID de cuenta técnica, ID de organización y SECRETO DE CLIENTE para la configuración del servicio de etiquetado inteligente de Assets de la nube en Experience Manager.

  1. Acceda a https://console.adobe.io en el explorador. Seleccione la cuenta adecuada y compruebe que la función de organización asociada sea administrador del sistema.

  2. Cree un proyecto con el nombre que desee. Haga clic en Añadir API.

  3. En la página Añadir una API , seleccione Experience Cloud y Contenido inteligente. Haga clic en Siguiente.

  4. Seleccione Cargar la clave pública. Proporcione el archivo de certificado descargado de Experience Manager. Se muestra un mensaje con las claves públicas cargadas correctamente. Haga clic en Siguiente.

    La página Crear una nueva credencial de cuenta de servicio (JWT) muestra la clave pública de la cuenta de servicio.

  5. Haga clic en Siguiente.

  6. En la página Seleccionar perfiles de producto, seleccione Servicios de contenido inteligente. Haga clic en Guardar API configurada.

    La página muestra más información sobre la configuración. Mantenga esta página abierta para copiar y agregar estos valores en Configuración del servicio de etiquetado inteligente de Assets de la configuración de la nube en Experience Manager para configurar las etiquetas inteligentes.

    En la pestaña Información general, puede revisar la información proporcionada para la integración.

    Figura: Detalles de la integración en Adobe Developer Console

Configurar el servicio de contenido inteligente configure-smart-content-service

CAUTION
Antes, las configuraciones que se realizaban con las credenciales de JWT ahora están sujetas a desaprobación en Adobe Developer Console. No puede crear nuevas credenciales de JWT después del 3 de junio de 2024. Estas configuraciones ya no se pueden crear ni actualizar, pero sí migrar a las configuraciones de OAuth.
AEM Consulte Configuración de integraciones de IMS para el usuario
Consulte Pasos para configurar OAuth para usuarios locales
Consulte Solución de problemas de etiquetas inteligentes para credenciales de OAuth

Para configurar la integración, use los valores de los campos ID. DE CUENTA TÉCNICA, ID. DE ORGANIZACIÓN, SECRETO DE CLIENTE e ID. DE CLIENTE de la integración de Adobe Developer Console. La creación de una configuración de nube de etiquetas inteligentes permite la autenticación de solicitudes de API desde la implementación de Experience Manager.

  1. En Experience Manager, vaya a Herramientas > Cloud Service > Cloud Services heredados para abrir la consola de Cloud Services.

  2. En Etiquetas inteligentes de Assets, abra la configuración creada anteriormente. En la página de configuración del servicio, haga clic en Editar.

  3. En el cuadro de diálogo AEM Smart Content Service, utilice los valores predefinidos para los campos URL de servicio y Servidor de autorización.

  4. Para los campos Clave de API, ID de cuenta técnica, ID de organización y Secreto de cliente, copie y utilice los siguientes valores generados en la integración de Adobe Developer Console.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Configuración del servicio de etiquetado inteligente de Assets Adobe Developer Console campos de integración
    Clave De Api ID. DE CLIENTE
    Id. de cuenta técnica ID. DE CUENTA TÉCNICA
    ID de organización ID. DE ORGANIZACIÓN
    Secreto de cliente SECRETO DE CLIENTE

Configuración de OAuth para usuarios locales config-oauth-onprem

Requisitos previos prereqs-config-oauth-onprem

Un ámbito de autorización es una cadena OAuth que contiene los siguientes requisitos previos:

  • Cree una nueva integración de OAuth en Developer Console con ClientID, ClientSecretID y OrgID.

  • Agregar los siguientes archivos en esta ruta de acceso /apps/system/config in crx/de:

    • com.adobe.granite.auth.oauth.accesstoken.provider.<randomnumbers>.config
    • com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl.<randomnumber>.config

Configuración de OAuth para usuarios locales steps-config-oauth-onprem

  1. Agregar o actualizar las siguientes propiedades en com.adobe.granite.auth.oauth.accesstoken.provider.<randomnumbers>.config:

    • auth.token.provider.authorization.grants="client_credentials"

    • auth.token.provider.orgId="<OrgID>"

    • auth.token.provider.default.claims=("\"iss\"\ :\ \"<OrgID>\"")

    • auth.token.provider.scope="read_pc.dma_smart_content,\ openid,\ AdobeID,\ additional_info.projectedProductContext"

      auth.token.validator.type="adobe-ims-similaritysearch"

    • Actualice auth.token.provider.client.id con el ID de cliente de la nueva configuración de OAuth.

    • Actualizar auth.access.token.request a "https://ims-na1.adobelogin.com/ims/token/v3"

  2. Cambie el nombre del archivo a com.adobe.granite.auth.oauth.accesstoken.provider-<randomnumber>.config.

  3. Siga estos pasos en com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl.<randomnumber>.config:

    • Actualice la propiedad auth.ims.client.secret con el Secreto del cliente desde la nueva integración de OAuth.
    • Cambie el nombre del archivo a com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl-<randomnumber>.config
  4. Guarde todos los cambios en la consola de desarrollo del repositorio de contenido, por ejemplo, CRXDE.

  5. Vaya a /system/console/configMgr y reemplace la configuración de OSGi de .<randomnumber> a -<randomnumber>.

  6. Elimine la configuración anterior de "Access Token provider name: adobe-ims-similaritysearch" en /system/console/configMgr.

  7. Reinicie la consola.

Validar la configuración validate-the-configuration

Una vez completada la configuración, puede utilizar un MBean de JMX para validar la configuración. Para validar, siga estos pasos.

  1. Obtenga acceso a su servidor Experience Manager en https://[aem_server]:[port].

  2. Vaya a Herramientas > Operaciones > Consola web para abrir la consola OSGi. Haga clic en Principal > JMX.

  3. Haga clic en com.day.cq.dam.similaritysearch.internal.impl. Se abrirá Tareas varias de SimilaritySearch.

  4. Haga clic en validateConfigs(). En el diálogo Validar configuraciones, haga clic en Invocar.

Los resultados de validación se muestran en el mismo cuadro de diálogo.

Habilitar el etiquetado inteligente en el flujo de trabajo Recurso de actualización DAM (opcional) enable-smart-tagging-in-the-update-asset-workflow-optional

  1. En Experience Manager, vaya a Herramientas > Flujo de trabajo > Modelos.

  2. En la página Modelos de flujo de trabajo, seleccione el modelo de flujo de trabajo de recursos de actualización de DAM.

  3. Haga clic en Editar en la barra de herramientas.

  4. Expanda el panel lateral para mostrar los pasos. Arrastre el paso Recurso de etiqueta inteligente que está disponible en la sección Flujo de trabajo de DAM y colóquelo después del paso Miniaturas del proceso.

    Añada el paso del recurso de etiquetas inteligentes después del paso de miniaturas de proceso en el flujo de trabajo de recursos de actualización de DAM

    Imagen: agregue el paso del recurso de etiquetas inteligentes después del paso de miniaturas de proceso en el flujo de trabajo Recurso de actualización DAM.

  5. Abra el paso en modo de edición. En Configuración avanzada, compruebe que la opción Avance del controlador está seleccionada.

    Configurar el flujo de trabajo de recursos de actualización DAM y agregar el paso de etiquetas inteligentes

    Figura: Configurar el flujo de trabajo de recursos de actualización de DAM y agregar el paso de etiquetas inteligentes

  6. En la pestaña Argumentos, seleccione Omitir errores si desea que el flujo de trabajo se complete aunque falle el paso de etiquetado automático.

    Configure el flujo de trabajo del recurso de actualización DAM para agregar el paso de la etiqueta inteligente y seleccionar el avance del controlador

    Figura: Configurar el flujo de trabajo de recursos de actualización de DAM para agregar el paso de etiquetas inteligentes y seleccionar el avance del controlador

    Para etiquetar recursos al cargarlos, independientemente de si el etiquetado inteligente está activado en las carpetas, seleccione Omitir indicador de etiqueta inteligente.

    Configure el flujo de trabajo del recurso de actualización DAM para agregar el paso de la etiqueta inteligente y seleccione omitir indicador de etiqueta inteligente

    Figura: Configurar el flujo de trabajo de recursos de actualización de DAM para agregar el paso de etiquetas inteligentes y seleccionar la opción para omitir el indicador de etiquetas inteligentes.

  7. Haga clic en Aceptar para cerrar el paso del proceso y, a continuación, guarde el flujo de trabajo.

Formación del servicio de contenido inteligente training-the-smart-content-service

Para que el servicio de contenido inteligente reconozca su taxonomía empresarial, ejecútela en un conjunto de recursos que ya incluyan etiquetas relevantes para su negocio. Para etiquetar de forma eficaz las imágenes de marca, el servicio de contenido inteligente requiere que las imágenes de formación se ajusten a determinadas directrices. Después de la formación, el servicio puede aplicar la misma taxonomía a un conjunto similar de recursos.

Puede entrenar el servicio varias veces para mejorar su capacidad de aplicar etiquetas relevantes. Después de cada ciclo de formación, ejecute un flujo de trabajo de etiquetado y compruebe si los recursos están etiquetados correctamente.

Puede entrenar el Servicio de contenido inteligente periódicamente o según sea necesario.

NOTE
El flujo de trabajo de formación se ejecuta únicamente en carpetas.

Directrices para la formación guidelines-for-training

Para obtener los mejores resultados, las imágenes del conjunto de formación se ajustan a las siguientes directrices:

Cantidad y tamaño: Mínimo de 30 imágenes por etiqueta. Mínimo de 500 píxeles en el lado más largo.

Coherencia: las imágenes utilizadas para una etiqueta específica son visualmente similares.

Por ejemplo, no es aconsejable etiquetar todas estas imágenes como my-party (para aprendizaje) porque no son visualmente similares.

Imágenes ilustrativas para ejemplificar las directrices de formación

Cobertura: Use suficiente variedad en las imágenes del curso de formación. La idea es ofrecer algunos ejemplos, pero razonablemente diversos, para que el Experience Manager aprenda a centrarse en las cosas correctas. Si aplica la misma etiqueta a imágenes visualmente distintas, incluya al menos cinco ejemplos de cada tipo.

Por ejemplo, para la etiqueta model-down-pose, incluya más imágenes de aprendizaje similares a la imagen resaltada a continuación para que el servicio identifique las imágenes similares con mayor precisión durante el etiquetado.

Imágenes ilustrativas para ejemplificar las directrices de formación

Distracción/obstrucción: El servicio se entrena mejor con las imágenes que tienen menos distracción (fondos destacados, acompañamientos no relacionados, como objetos/personas con el asunto principal).

Por ejemplo, para la etiqueta casual-shoe, la segunda imagen no es una buena candidata para entrenamiento.

Imágenes ilustrativas para ejemplificar las directrices de formación

Complejidad: Si una imagen cumple los requisitos para más de una etiqueta, agregue todas las etiquetas aplicables antes de incluir la imagen para formación. Por ejemplo, para etiquetas, como raincoat y model-side-view, agregue ambas etiquetas en el recurso que cumple los requisitos antes de incluirlo para formación.

Imágenes ilustrativas para ejemplificar las directrices de formación

NOTE
La capacidad del servicio de contenido inteligente para aprender sobre sus etiquetas y aplicarlas a otras imágenes depende de la calidad de las imágenes que utilice para la formación. Para obtener los mejores resultados, Adobe recomienda utilizar imágenes visualmente similares para entrenar el servicio de para cada etiqueta.

Formación periódica periodic-training

Puede habilitar el Servicio de contenido inteligente para que se imparta formación periódicamente sobre los recursos y las etiquetas asociadas dentro de una carpeta. Abra la página Propiedades de la carpeta de recursos, seleccione Habilitar etiquetas inteligentes en la pestaña Detalles y guarde los cambios.

enable_smart_tags

Una vez seleccionada esta opción para una carpeta, Experience Manager ejecuta un flujo de trabajo de formación automáticamente para entrenar el servicio de contenido inteligente en los recursos de la carpeta y sus etiquetas. De forma predeterminada, el flujo de trabajo de formación se ejecuta semanalmente a las 12:30 los sábados.

Formación a la carta on-demand-training

Puede entrenar el servicio de contenido inteligente siempre que sea necesario desde la consola Flujo de trabajo.

  1. En la interfaz de Experience Manager, vaya a Herramientas > Flujo de trabajo > Modelos.

  2. En la página Modelos de flujo de trabajo, seleccione el flujo de trabajo Formación sobre etiquetas inteligentes y, a continuación, haga clic en Iniciar flujo de trabajo en la barra de herramientas.

  3. En el cuadro de diálogo Ejecutar flujo de trabajo, vaya a la carpeta de carga útil que incluye los recursos etiquetados para entrenar el servicio.

  4. Especifique un título para el flujo de trabajo y añada un comentario. A continuación, haga clic en Ejecutar. Los recursos y las etiquetas se envían para su formación.

    workflow_dialog

NOTE
Una vez que los recursos de una carpeta se procesan para formación, solo los modificados se procesan en ciclos de formación posteriores.

Ver informes de formación viewing-training-reports

Para comprobar si el servicio de contenido inteligente ha recibido formación sobre las etiquetas del conjunto de recursos de formación, consulte el informe de flujo de trabajo de formación desde la consola Informes.

  1. En la interfaz de Experience Manager, vaya a Herramientas > Assets > Informes.

  2. En la página Informes de recursos, haga clic en Crear.

  3. Seleccione el informe Formación sobre etiquetas inteligentes y, a continuación, haga clic en Siguiente en la barra de herramientas.

  4. Especifique un título y una descripción para el informe. En Programar informe, deje seleccionada la opción Ahora. Si desea programar el informe para más adelante, seleccione Más adelante e indique una fecha y una hora. A continuación, haga clic en Crear en la barra de herramientas.

  5. En la página Informes de recursos, seleccione el informe que ha generado. Para ver el informe, haz clic en Ver en la barra de herramientas.

  6. Revise los detalles del informe.

    El informe muestra el estado de la formación de las etiquetas que ha entrenado. El color verde de la columna Estado de formación indica que el servicio de contenido inteligente ha recibido formación para la etiqueta. El color amarillo indica que el servicio no está completamente entrenado para una etiqueta en particular. En este caso, agregue más imágenes con la etiqueta en concreto y ejecute el flujo de trabajo de formación para que el servicio se imparta completamente en la etiqueta.

    Si no ve las etiquetas en este informe, ejecute de nuevo el flujo de trabajo de formación para estas etiquetas.

  7. Para descargar el informe, selecciónelo en la lista y haga clic en Descargar en la barra de herramientas. El informe se descarga como una hoja de cálculo de Microsoft Excel.

Limitaciones limitations

  • Las etiquetas inteligentes mejoradas se basan en modelos de aprendizaje de imágenes y sus etiquetas. Estos modelos no siempre son perfectos para identificar etiquetas. La versión actual del servicio de contenido inteligente tiene las siguientes limitaciones:

    • Incapacidad para reconocer diferencias sutiles en las imágenes. Por ejemplo, camisetas ajustadas delgadas versus regulares.
    • Incapacidad para identificar etiquetas en función de patrones o partes diminutos de una imagen. Por ejemplo, logotipos en camisetas.
    • El etiquetado es compatible con las configuraciones regionales que admiten Experience Manager.
  • Para buscar recursos con etiquetas inteligentes (regulares o mejoradas), use el Omnisearch Assets (búsqueda de texto completo). No hay ningún predicado de búsqueda independiente para las etiquetas inteligentes.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2