准备Assets以进行智能标记 configure-asset-tagging-using-the-smart-content-service
在使用Smart Content Services开始标记资源之前,请将Experience Manager Assets与Adobe Developer Console集成以使用Adobe Sensei的智能服务。 配置完毕后,请使用一些图像和标记来训练服务。
在使用智能内容服务之前,请确保:
SCS升级以支持OauthAdobeManaged Services scs-upgrade-oauth-managed-services
新用户
安装Service Pack 22。 要支持Service Pack 22上的Oauth集成,您需要安装适用于Service Pack 22🔗的修补程序。
按照本文中所述的说明设置智能内容服务。
现有用户
如果您已升级到Service Pack 21,请安装适用于Service Pack 21🔗的修补程序以支持Oauth集成。 任何现有配置都会自动删除。 按照本文中所述的说明设置智能内容服务。 如果您升级到Service Pack 22,则必须安装此适用于Service Pack 22的修补程序。
对于Service Pack 20及更早版本,您需要为SCS执行解决步骤以支持Oauth集成。 请参阅OAuth凭据的智能标记疑难解答。
SCS升级以支持内部部署用户的Oauth scs-upgrade-oauth-on-premise
新用户
新的Experience Manager Assets内部部署用户无法再使用智能内容服务。
现有用户
已启用此功能的现有内部部署用户可以继续使用智能内容服务。
如果您已升级到Service Pack 21,请安装适用于Service Pack 21🔗的修补程序以支持Oauth集成。 任何现有配置都会自动删除。 按照本文中所述的说明设置智能内容服务。 如果您升级到Service Pack 22,则必须安装此适用于Service Pack 22的修补程序。
对于Service Pack 20及更早版本,您需要为SCS执行解决步骤以支持Oauth集成。 请参阅OAuth凭据的智能标记疑难解答。
与Adobe Developer Console集成 integrate-adobe-io
与Adobe Developer Console集成时,Experience Manager服务器会先通过Adobe Developer Console网关验证您的服务凭据,然后再将您的请求转发到智能内容服务。 要集成,您需要一个对组织具有管理员权限的Adobe ID帐户,以及已为组织购买和启用的Smart Content Service许可证。
要配置智能内容服务,请按照以下顶级步骤操作:
-
在Adobe Developer Console中创建集成。
-
使用Adobe Developer Console中的API密钥和其他凭据创建IMS技术帐户配置。
-
测试配置。
创建Adobe Developer Console集成 create-adobe-io-integration
要使用Smart Content Service API,请在Adobe Developer Console中创建集成,以获取Experience Manager中云配置的Assets智能标记服务设置的API密钥 (在Adobe Developer Console集成的客户端ID字段中生成)、组织ID和客户端密钥。
-
在浏览器中访问https://developer.adobe.com。 选择适当的帐户,并确认关联的组织角色是系统 管理员。
-
创建具有任何所需名称的项目。单击 添加 API。
-
在 添加 API 页面中,依次选择 Experience Cloud 和 智能内容。单击 下一步。
-
选择 OAuth服务器到服务器。 单击 下一步。
有关如何执行此配置的详细信息,请参阅Developer Console文档,具体取决于您的要求:-
概述:
-
创建新的 OAuth 凭据:
-
将现有的 JWT 凭据迁移到 OAuth 凭据:
-
-
在 选择产品配置文件 页面中,选择 智能内容服务。 单击 保存配置的API。
页面会显示有关配置的更多信息。保持此页面处于打开状态,以复制这些值,并将其添加到Experience Manager中云配置的Assets智能标记服务设置中,从而配置智能标记。
创建IMS技术帐户配置 create-ims-account-config
您需要使用以下步骤创建IMS技术帐户配置:
-
在 Experience Manager 用户界面中,访问 工具 > 安全 > Adobe IMS 配置。
-
单击 创建。
-
在IMS技术帐户配置对话框中,使用以下值:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 字段 描述 云解决方案 从下拉列表中选择 智能标记。 标题 添加配置IMS帐户的标题。 授权服务器 添加 https://ims-na1.adobelogin.com
客户端 ID 将通过Adobe Developer控制台提供。 客户端密钥 将通过Adobe Developer控制台提供。 范围 将通过Adobe Developer控制台提供。 组织 ID 将通过Adobe Developer控制台提供。 -
选择您创建的配置,然后单击 检查运行状况。
-
确认检查运行状况对话框,并在配置处于正常状态时单击关闭。
创建新配置 configure-smart-content-service
要配置集成,请使用Adobe Developer Console集成中的技术帐户ID、组织ID、客户端密钥和客户端ID字段的值。 创建智能标记云配置允许来自Experience Manager部署的API请求的身份验证。
-
在Experience Manager中,导航到 工具 > Cloud Service > 智能标记 以打开智能标记配置。
-
单击 创建 以创建新配置。 否则,请单击 属性 以更新现有配置。
-
填写以下字段:
table 0-row-2 1-row-2 2-row-2 3-row-2 字段 描述 标题 添加配置IMS帐户的标题。 关联的 Adobe IMS 配置 从下拉列表中选择配置。 服务 URL https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>
。例如,https://smartcontent.adobe.io/apac
。您可以将na
、emea
或apac
指定为承载Experience Manager创作实例的区域。note note NOTE 如果Experience Manager托管服务是在2022年9月1日之前配置的,请使用以下服务URL: https://mc.adobe.io/marketingcloud/smartcontent
-
单击“保存并关闭”。
验证配置 validate-the-configuration
完成配置后,可以使用JMX MBean来验证配置。 要进行验证,请执行以下步骤。
-
访问位于
https://[aem_server]:[port]
的Experience Manager服务器。 -
转到 工具 > 操作 > Web控制台 以打开OSGi控制台。 单击 主 > JMX。
-
单击
com.day.cq.dam.similaritysearch.internal.impl (SCS)
。 -
单击
validateConfigs()
. 在 验证配置 对话框中,单击 调用。
验证结果将显示在同一对话框中。
在DAM更新资产工作流中启用智能标记(可选) enable-smart-tagging-in-the-update-asset-workflow-optional
-
在Experience Manager中,转到 工具 > 工作流 > 模型。
-
在 工作流模型 页面上,选择 DAM 更新资产 工作流模式。
-
单击工具栏中的 编辑。
-
展开侧面板以显示步骤。拖动 DAM 工作流部分中可用的 智能标记资产 步骤,并将其放在 流程缩略图 步骤之后。
-
打开步骤的属性以修改详细信息。 在 高级设置 下,确保选中 处理程序前进 选项。
-
在 参数 选项卡中,如果希望完成工作流,请选择 忽略错误,即使自动标记步骤失败也是如此。
此外,要在上传资产时标记资产,而不考虑是否对文件夹启用了智能标记,请选择 忽略智能标记标志。
-
单击完成 以关闭流程步骤。
-
单击 同步 以保存工作流。
培训智能内容服务 training-the-smart-content-service
为了使智能内容服务能够识别您的业务分类,请在一组已包含与您的业务相关的标记的资源上运行该分类。 为了有效地标记您的品牌图像,智能内容服务要求培训图像符合某些准则。 培训之后,该服务可以在类似的一组资产中应用相同的分类。
您可以多次培训服务以提高其应用相关标记的能力。 在每个培训周期后,运行标记工作流并检查资产是否进行了正确标记。
您可以定期或根据需要培训智能内容服务。
培训准则 guidelines-for-training
为获得最佳效果,培训集中的图像应符合以下准则:
数量和大小: 每个标记至少 30 张图像。长边至少 500 像素。
Coherence:用于特定标记的图像在视觉上相似。
例如,将所有图像标记为my-party
(用于培训)是不好的,因为它们视觉上并不相似。
覆盖率:在培训图像中使用足够多的变化。 其理念是提供一些合理多样化的示例,以便Experience Manager学习关注正确的事情。 如果您要在视觉上不同的图像上应用相同的标记,请至少包含每种类型的五个示例。
例如,对于标记 模型向下姿态,请包含与下面高亮图像类似的更多训练图像,以便服务在标记期间更准确地识别类似图像。
干扰/阻碍:服务在干扰较少的图像(突出的背景、不相关的伴侣,如主主题的物体/人员)上提供更好的培训。
例如,对于标记 casual-shoe,第二个图像不是良好的训练候选项。
完整性: 如果图像符合多个标记的条件,请在包含培训图像之前添加所有适用的标记。例如,对于标记(如raincoat
和model-side-view
),请先在符合条件的资产上添加这两个标记,然后再将其加入培训。
定期训练 periodic-training
您可以使智能内容服务定期针对文件夹中的资源和关联标记进行培训。 打开资产文件夹的属性页面,在 详细信息 选项卡下选择 启用智能标记,然后保存更改。
为文件夹选择此选项后,Experience Manager将自动运行培训工作流以对文件夹资产及其标记培训智能内容服务。 默认情况下,培训工作流每周于星期六凌晨12:30运行。
按需培训 on-demand-training
您可以根据需要从工作流控制台培训智能内容服务。
-
在Experience Manager界面中,转到 工具 > 工作流 > 模型。
-
从 工作流模型 页面中,选择 智能标记培训 工作流,然后单击工具栏中的 启动工作流。
-
在 运行工作流 对话框中,浏览到有效负荷文件夹,其中包含用于培训服务的已标记资产。
-
指定工作流的标题并添加评论。 然后,单击 运行。 提交资产和标记以进行培训。
查看培训报告 viewing-training-reports
要检查智能内容服务是否针对培训资产集中的标记进行了培训,请从“报表”控制台中查看培训工作流报表。
-
在Experience Manager界面中,转到 工具 > Assets > 报表。
-
在 资产报表 页面中,单击 创建。
-
选择 智能标记培训 报表,然后单击工具栏中的 下一步。
-
指定报表的标题和描述。在 计划报告 下,保持选中 立即 选项。如果要安排以后的计划报告,请选择 稍后,然后指定日期和时间。然后,单击工具栏中的 创建。
-
在 资产报表 页面中,选择生成的报表。要查看报告,请单击工具栏中的 查看。
-
查看报告的详细信息。
报表显示您培训的标记的培训状态。培训状态 列中的绿色表示已为标记培训“智能内容服务”。黄色表示服务未针对特定标记进行完整培训。在这种情况下,使用特定标记添加更多图像并运行培训工作流以在标签上完整地培训服务。
如果您未在此报表中看到您的标记,请再次运行这些标记的培训工作流。
-
要下载报告,请从列表中选择报告,然后单击工具栏中的 下载。 报表将下载为Microsoft Excel电子表格。
限制 limitations
-
增强型智能标记基于图像及其标记的学习模型。 这些模型在识别标记方面并不总是完美的。 当前版本的智能内容服务具有以下限制:
- 无法识别图像中的细微差异。 例如,超薄衬衫和普通衬衫。
- 无法根据图像的微小模式/部分识别标记。 例如,T恤上的徽标。
- 支持Experience Manager的区域设置支持标记。
-
要搜索带有智能标记(常规或增强)的资产,请使用Assets Omnisearch(全文搜索)。 智能标记没有单独的搜索谓词。