准备 Assets 用于智能标记 configure-asset-tagging-using-the-smart-content-service

在使用Smart Content Services开始标记资源之前,请集成 Experience Manager Assets 使用Adobe Developer Console提供的智能服务 Adobe Sensei. 配置完毕后,可使用一些图像和标记来训练服务。

NOTE
  • 智能内容服务不再可供新用户使用 Experience Manager Assets 内部部署客户。 已启用此功能的现有内部部署客户可以继续使用智能内容服务。
  • 智能内容服务可用于现有 Experience Manager Assets 已启用此功能的Managed Services客户。
  • 新建 Experience Manager Assets Managed Services客户可以按照本文中所述的说明设置智能内容服务。

在使用智能内容服务之前,请确保:

与Adobe Developer控制台集成 integrate-adobe-io

在与Adobe Developer控制台集成时, Experience Manager 在将您的请求转发到智能内容服务之前,服务器会使用Adobe Developer控制台网关验证您的服务凭据。 要集成,您需要一个对组织具有管理员权限的Adobe ID帐户,以及已为组织购买和启用的Smart Content Service许可证。

要配置智能内容服务,请按照以下顶级步骤操作:

  1. 要生成公钥, 创建智能内容服务 中的配置 Experience Manager. 为 OAuth 集成获取公共证书

  2. 在 Adobe 开发人员控制台中创建集成,并上传生成的公共密钥。

  3. 配置部署 从Adobe Developer控制台使用API密钥和其他凭据。

  4. 测试配置

  5. (可选) 在资产上传时启用自动标记.

通过创建智能内容服务配置获取公共证书 obtain-public-certificate

公共证书允许您在Adobe Developer控制台上验证配置文件。

  1. 在 Experience Manager 用户界面,访问 工具 > Cloud Service > 旧版Cloud Service.

  2. 在“Cloud Service”页面中,单击 立即配置资产智能标记.

  3. 创建配置 对话框,请为智能标记配置指定标题和名称。 单击​ 创建

  4. AEM智能内容服务 对话框,请使用以下值:

    服务URLhttps://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>

    例如,https://smartcontent.adobe.io/apac。您可以指定 naemea,或, apac 作为托管Experience Manager创作实例的地区。

    note note
    NOTE
    如果Experience Manager托管服务是在2022年9月1日之前配置的,请使用以下服务URL:
    https://mc.adobe.io/marketingcloud/smartcontent

    授权服务器https://ims-na1.adobelogin.com

    其他字段暂时留空(稍后提供)。 单击​ 确定

    Experience Manager智能内容服务对话框以提供内容服务URL

    图:用于提供内容服务URL的智能内容服务对话框

    note note
    NOTE
    提供的URL为 服务URL 无法通过浏览器访问,并生成404错误。 如果具有相同值,则配置工作正常。 服务URL 参数。 有关总体服务状态和维护计划,请参阅 https://status.adobe.com.
  5. 单击 下载用于OAuth集成的公共证书,并下载公共证书文件 AEM-SmartTags.crt.

    为智能标记服务创建的设置的表示形式

    图:智能标记服务的设置。

证书过期时重新配置 certrenew

证书过期后,将不再受信任。 无法续订已过期的证书。 要添加证书,请执行以下步骤。

  1. 以管理员身份登录 Experience Manager 部署。单击​ 工具 > 安全 > 用户

  2. 找到并单击 dam-update-service 用户。单击 密钥库 选项卡。

  3. 删除包含已过期证书的现有 similaritysearch KeyStore。单击​ 保存并关闭

    删除Keystore中的现有相似性搜索条目以添加安全证书

    图:删除现有的 similaritysearch 条目来添加安全证书。

  4. 导航到​ 工具 > 云服务 > 旧版云服务。单击 资产智能标记 >显 示配置 >可 用配置。 单击所需的配置。

  5. 要下载公共证书,请单击 下载用于OAuth集成的公共证书.

  6. 访问 https://console.adobe.io 并导航到 集成 页面。 上传新证书。 有关更多信息,请参阅 创建Adobe Developer控制台集成.

创建Adobe Developer控制台集成 create-adobe-i-o-integration

要使用Smart Content Service API,请在Adobe Developer控制台中创建集成以获取 API密钥 (生成于 客户端ID 字段(例如Adobe Developer控制台集成字段), 技术帐户ID, 组织ID、和 客户端密码 对象 资产智能标记服务设置 中的云配置 Experience Manager.

  1. 在浏览器中访问 https://console.adobe.io。选择相应的帐户并验证关联的组织角色是否为系统管理员。

  2. 创建具有任何所需名称的项目。单击​ 添加 API

  3. 在​ 添加 API 页面中,依次选择 Experience Cloud 和​ 智能内容。单击​ 下一步

  4. 选择​ 上传您的公共密钥。提供从 Experience Manager 下载的证书文件。此时将显示“公共密钥上传成功”消息。单击​ 下一步

    创建新的服务帐户(JWT)凭据 此页显示服务帐户的公钥。

  5. 单击​ 下一步

  6. 在​ 选择产品配置文件 ​页面上,选择​ 智能内容服务。单击 保存配置的API.

    页面会显示有关配置的更多信息。保持此页面处于打开状态,以复制这些值并将其添加到中 资产智能标记服务设置 中的云配置 Experience Manager 以配置智能标记。

    在“概述”选项卡中,您可以查看为集成提供的信息。

    图:Adobe Developer控制台中集成的详细信息

配置智能内容服务 configure-smart-content-service

CAUTION
以前,使用JWT凭据进行的配置现在可在Adobe Developer控制台中弃用。 2024年6月3日之后,您将无法创建新的JWT凭据。 无法再创建或更新此类配置,但可以将它们迁移到 OAuth 配置。
请参阅 为AEM设置IMS集成
请参阅 为内部部署用户配置OAuth的步骤
请参阅 OAuth凭据的智能标记疑难解答

要配置集成,请使用 技术帐户ID, 组织ID, 客户端密码、和 客户端ID Adobe Developer控制台集成中的字段。 创建智能标记云配置允许对来自的API请求进行身份验证 Experience Manager 部署。

  1. 在 Experience Manager,导航到 工具 > Cloud Service > 旧版Cloud Service 以打开 Cloud Service 控制台。

  2. 资产智能标记,打开上面创建的配置。 在服务设置页面上,单击 编辑.

  3. AEM 智能内容服务 ​对话框中,为​ 服务 URL 和​ 授权服务器 ​字段使用预填充的值。

  4. 对于字段 Api密钥, 技术帐户ID, 组织ID、和 客户端密码,复制并使用中生成的以下值 Adobe Developer控制台集成.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    资产智能标记服务设置 Adobe Developer Console 集成字段
    Api密钥 客户端ID
    技术帐户ID 技术帐户ID
    组织ID 组织ID
    客户端密码 客户端密码

为内部部署用户配置OAuth config-oauth-onprem

先决条件 prereqs-config-oauth-onprem

授权范围是包含以下先决条件的OAuth字符串:

  • 在中创建新的OAuth集成 开发人员控制台 使用 ClientIDClientSecretID、和 OrgID.

  • 在此路径中添加以下文件 /apps/system/config in crx/de

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

为内部部署用户配置OAuth steps-config-oauth-onprem

  1. 在中添加或更新以下属性 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"

    • 更新 auth.token.provider.client.id 与新OAuth配置的客户端ID一起使用。

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

  2. 将文件重命名为 com.adobe.granite.auth.oauth.accesstoken.provider-<randomnumber>.config.

  3. 在中执行以下步骤 com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl.<randomnumber>.config

    • 通过新的OAuth集成,使用客户端密钥更新属性auth.ims.client.secret。
    • 将文件重命名为 com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl-<randomnumber>.config
  4. 在内容存储库开发控制台(例如CRXDE)中保存所有更改。

  5. 导航到 /system/console/configMgr 并从替换OSGi配置 .<randomnumber>-<randomnumber>.

  6. 删除的旧配置 "Access Token provider name: adobe-ims-similaritysearch"/system/console/configMgr.

  7. 重新启动控制台。

验证配置 validate-the-configuration

完成配置后,可以使用JMX MBean来验证配置。 要进行验证,请执行以下步骤。

  1. 访问 Experience Manager 服务器位于 https://[aem_server]:[port].

  2. 转到 工具 > 操作 > Web控制台 以打开OSGi控制台。 单击 主要 > JMX.

  3. 单击 com.day.cq.dam.similaritysearch.internal.impl. 它会打开 相似性搜索其他任务.

  4. 单击 validateConfigs(). 在 验证配置 对话框,请单击 调用.

验证结果将显示在同一对话框中。

在中启用智能标记 DAM更新资产 工作流(可选) enable-smart-tagging-in-the-update-asset-workflow-optional

  1. 在 Experience Manager,转到 工具 > 工作流 > 模型.

  2. 在​ 工作流模型 ​页面上,选择 DAM 更新资产 ​工作流模式。

  3. 单击工具栏中的​ 编辑

  4. 展开侧面板以显示步骤。拖动 DAM 工作流部分中可用的​ 智能标记资产 ​步骤,并将其放在​ 流程缩略图 ​步骤之后。

    在 DAM 更新资产工作流中的流程缩略图步骤之后添加智能标记资产步骤

    图:在中的流程缩略图步骤之后添加智能标记资产步骤 DAM更新资产 工作流。

  5. 在编辑模式下打开该步骤。在​ 高级设置 ​下,确保选中​ 处理程序前进 ​选项。

    配置DAM更新资产工作流并添加智能标记步骤

    图:配置DAM更新资产工作流并添加智能标记步骤

  6. 在​ 参数 ​选项卡中,如果希望完成工作流,请选择​ 忽略错误,即使自动标记步骤失败也是如此。

    配置DAM更新资产工作流以添加智能标记步骤并选择高级处理程序

    图:配置DAM更新资产工作流以添加智能标记步骤并选择高级处理程序

    要在上传资产时标记资产,而不考虑是否对文件夹启用了智能标记,请选择​ 忽略智能标记标志

    配置DAM更新资产工作流以添加智能标记步骤并选择忽略智能标记标志

    图:配置DAM更新资产工作流以添加智能标记步骤并选择忽略智能标记标志。

  7. 单击 确定 以关闭流程步骤,然后保存工作流。

培训智能内容服务 training-the-smart-content-service

为了使智能内容服务能够识别您的业务分类,请在一组已包含与您的业务相关的标记的资源上运行该分类。 为了有效地标记您的品牌图像,智能内容服务要求培训图像符合某些准则。 培训之后,该服务可以在类似的一组资产中应用相同的分类。

您可以多次培训服务以提高其应用相关标记的能力。 在每个培训周期后,运行标记工作流并检查资产是否进行了正确标记。

您可以定期或根据需要培训智能内容服务。

NOTE
培训工作流仅在文件夹上运行。

培训准则 guidelines-for-training

为获得最佳效果,培训集中的图像应符合以下准则:

数量和大小: ​每个标记至少 30 张图像。长边至少 500 像素。

一致性:用于特定标记的图像在视觉上类似。

例如,将所有图像标记为 my-party (用于培训),因为它们视觉上并不相似。

说明性图像以说明培训准则

覆盖率:在训练中使用足够的图像变化。 其理念是提供一些合理多样化的示例,以便Experience Manager学习关注正确的事情。 如果您要在视觉上不同的图像上应用相同的标记,请至少包含每种类型的五个示例。

例如,对于标记 模型向下姿态,包括更多与下面高亮显示的图像类似的训练图像,以便该服务在标记期间更准确地识别类似图像。

说明性图像以说明培训准则

分心/阻碍:此服务可更好地培训注意力较少图像(突出的背景、不相关的伴侣,如具有主要主题的物体/人员)。

例如,对于标记 休闲鞋,第二幅图像不是很好的候选训练图像。

说明性图像以说明培训准则

完整性: ​如果图像符合多个标记的条件,请在包含培训图像之前添加所有适用的标记。例如,对于标记,如 raincoatmodel-side-view,在将其加入培训之前,在符合条件的资产上添加这两个标记。

说明性图像以说明培训准则

NOTE
智能内容服务根据您的标记进行培训并将其应用于其他图像的能力取决于您用于培训的图像质量。 为获得最佳结果,Adobe建议您使用视觉上相似的图像,为每个标签培训服务。

定期训练 periodic-training

您可以使智能内容服务定期针对文件夹中的资源和关联标记进行培训。 打开 属性 页面,选择 启用智能标记详细信息 选项卡,并保存更改。

enable_smart_tags

为文件夹选择此选项后, Experience Manager 自动运行培训工作流,对文件夹资产及其标记上的智能内容服务进行培训。 默认情况下,培训工作流每周于星期六凌晨12:30运行。

按需培训 on-demand-training

您可以根据需要从工作流控制台培训智能内容服务。

  1. 在 Experience Manager 界面,转到 工具 > 工作流 > 模型.

  2. 工作流模型 页面上,选择 智能标记训练 工作流,然后单击 启动工作流 工具栏中。

  3. 运行工作流 对话框,浏览到有效负荷文件夹,其中包含用于培训服务的已标记资产。

  4. 指定工作流的标题并添加评论。 然后,单击 运行. 提交资产和标记以进行培训。

    workflow_dialog

NOTE
一旦文件夹中的资产处理用于训练,后续训练周期将仅处理修改后的资产。

查看培训报告 viewing-training-reports

要检查智能内容服务是否针对培训资产集中的标记进行了培训,请从“报表”控制台中查看培训工作流报表。

  1. 在 Experience Manager 界面,转到 工具 > 资产 > 报表.

  2. 资产报表 页面,单击 创建.

  3. 选择 智能标记训练 报表,然后单击 下一个 工具栏中。

  4. 指定报表的标题和描述。在​ 计划报告 ​下,保持选中​ 立即 ​选项。如果要安排以后的计划报告,请选择​ 稍后,然后指定日期和时间。然后,单击 创建 工具栏中。

  5. 在​ 资产报表 ​页面中,选择生成的报表。要查看报告,请单击 视图 工具栏中。

  6. 查看报告的详细信息。

    报表显示您培训的标记的培训状态。培训状态 ​列中的绿色表示已为标记培训“智能内容服务”。黄色表示服务未针对特定标记进行完整培训。在这种情况下,使用特定标记添加更多图像并运行培训工作流以在标签上完整地培训服务。

    如果您未在此报表中看到您的标记,请再次运行这些标记的培训工作流。

  7. 要下载报表,请从列表中选择该报表,然后单击 下载 工具栏中。 报表将下载为Microsoft Excel电子表格。

限制 limitations

  • 增强型智能标记基于图像及其标记的学习模型。 这些模型在识别标记方面并不总是完美的。 当前版本的智能内容服务具有以下限制:

    • 无法识别图像中的细微差异。 例如,超薄衬衫和普通衬衫。
    • 无法根据图像的微小模式/部分识别标记。 例如,T恤上的徽标。
    • 在以下区域设置中支持标记 Experience Manager 中支持。
  • 要搜索带有智能标记(常规或增强)的资产,请使用 Assets Omnisearch(全文搜索)。 智能标记没有单独的搜索谓词。

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