准备Assets以进行智能标记 configure-asset-tagging-using-the-smart-content-service
在使用Smart Content Services开始标记资源之前,请将Experience Manager Assets与Adobe Developer Console集成以使用Adobe Sensei的智能服务。 配置完毕后,可使用一些图像和标记来训练服务。
- 新的Experience Manager Assets内部部署客户无法再使用智能内容服务。 已启用此功能的现有内部部署客户可以继续使用智能内容服务。
- 智能内容服务适用于已启用此功能的现有Experience Manager Assets个Managed Services客户。
- 新的Experience Manager Assets个Managed Services客户可以按照本文中所述的说明设置智能内容服务。
在使用智能内容服务之前,请确保:
与Adobe Developer Console集成 integrate-adobe-io
与Adobe Developer Console集成时,Experience Manager服务器会先通过Adobe Developer Console网关验证您的服务凭据,然后再将您的请求转发到智能内容服务。 要集成,您需要一个对组织具有管理员权限的Adobe ID帐户,以及已为组织购买和启用的Smart Content Service许可证。
要配置智能内容服务,请按照以下顶级步骤操作:
-
在 Adobe 开发人员控制台中创建集成,并上传生成的公共密钥。
-
测试配置。
-
或者,在资产上传🔗时启用自动标记。
通过创建智能内容服务配置获取公共证书 obtain-public-certificate
公共证书允许您在Adobe Developer Console上验证配置文件。
-
在Experience Manager用户界面中,访问 工具 > Cloud Service > 旧版Cloud Service。
-
在“Cloud Service”页面中,单击 Assets智能标记 下的 立即配置。
-
在 创建配置 对话框中,指定智能标记配置的标题和名称。 单击 创建。
-
在 AEM Smart Content Service 对话框中,使用以下值:
服务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
授权服务器:
https://ims-na1.adobelogin.com
其他字段暂时留空(稍后提供)。 单击 确定。
图:用于提供内容服务URL的Smart Content Service对话框
note note NOTE 作为服务URL提供的URL无法通过浏览器访问,并生成404错误。 使用服务URL参数的相同值时,配置工作正常。 有关整体服务状态和维护计划,请参阅https://status.adobe.com。 -
单击 下载OAuth集成的公共证书,然后下载公共证书文件
AEM-SmartTags.crt
。图:智能标记服务的设置。
证书过期时重新配置 certrenew
证书过期后,将不再受信任。 无法续订已过期的证书。 要添加证书,请执行以下步骤。
-
以管理员身份登录 Experience Manager 部署。单击 工具 > 安全 > 用户。
-
找到并单击 dam-update-service 用户。单击 密钥库 选项卡。
-
删除包含已过期证书的现有 similaritysearch KeyStore。单击 保存并关闭。
图:删除Keystore中的现有
similaritysearch
条目以添加安全证书。 -
导航到 工具 > 云服务 > 旧版云服务。单击 资产智能标记 >显 示配置 >可 用配置。 单击所需的配置。
-
要下载公共证书,请单击 为OAuth集成下载公共证书。
-
访问https://console.adobe.io并导航到 集成 页面上的现有智能内容服务。 上传新证书。 有关详细信息,请参阅创建Adobe Developer Console集成中的说明。
创建Adobe Developer Console集成 create-adobe-i-o-integration
要使用Smart Content Service API,请在Adobe Developer Console中创建集成,以获取Experience Manager中云配置的Assets智能标记服务设置的API密钥 (在Adobe Developer Console集成的客户端ID字段中生成)、技术帐户ID、组织ID和客户端密钥。
-
在浏览器中访问 https://console.adobe.io。选择相应的帐户并验证关联的组织角色是否为系统管理员。
-
创建具有任何所需名称的项目。单击 添加 API。
-
在 添加 API 页面中,依次选择 Experience Cloud 和 智能内容。单击 下一步。
-
选择 上传您的公共密钥。提供从 Experience Manager 下载的证书文件。此时将显示“公共密钥上传成功”消息。单击 下一步。
创建新的服务帐户(JWT)凭据页显示服务帐户的公钥。
-
单击 下一步。
-
在 选择产品配置文件 页面上,选择 智能内容服务。单击 保存配置的API。
页面会显示有关配置的更多信息。保持此页面处于打开状态,以复制这些值,并将其添加到Experience Manager中云配置的Assets智能标记服务设置中,从而配置智能标记。
图: Adobe Developer Console中集成的详细信息
配置智能内容服务 configure-smart-content-service
查看为AEM设置IMS集成
请参阅为内部部署用户配置OAuth的步骤
请参阅OAuth凭据的智能标记疑难解答
要配置集成,请使用Adobe Developer Console集成中的技术帐户ID、组织ID、客户端密钥和客户端ID字段的值。 创建智能标记云配置允许来自Experience Manager部署的API请求的身份验证。
-
在Experience Manager中,导航到 工具 > Cloud Service > 旧版Cloud Services 以打开Cloud Services控制台。
-
在 Assets智能标记 下,打开上面创建的配置。 在服务设置页面上,单击 编辑。
-
在 AEM 智能内容服务 对话框中,为 服务 URL 和 授权服务器 字段使用预填充的值。
-
对于字段Api密钥、技术帐户ID、组织ID和客户端密钥,请复制并使用在Adobe Developer Console集成中生成的以下值。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Assets智能标记服务设置 Adobe Developer Console集成字段 Api密钥 客户端ID 技术帐户ID 技术帐户ID 组织ID 组织ID 客户端密码 客户端密钥
为内部部署用户配置OAuth config-oauth-onprem
先决条件 prereqs-config-oauth-onprem
授权范围是包含以下先决条件的OAuth字符串:
-
在Developer Console中使用
ClientID
、ClientSecretID
和OrgID
创建新的OAuth集成。 -
在此路径
/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
-
在
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"
-
使用新OAuth配置的客户端ID更新
auth.token.provider.client.id
。 -
将
auth.access.token.request
更新至"https://ims-na1.adobelogin.com/ims/token/v3"
-
-
将文件重命名为
com.adobe.granite.auth.oauth.accesstoken.provider-<randomnumber>.config
。 -
在
com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl.<randomnumber>.config
中执行以下步骤:- 通过新的OAuth集成,使用客户端密钥更新属性auth.ims.client.secret。
- 将文件重命名为
com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl-<randomnumber>.config
-
在内容存储库开发控制台(例如CRXDE)中保存所有更改。
-
导航到
/system/console/configMgr
并将OSGi配置从.<randomnumber>
替换为-<randomnumber>
。 -
删除
/system/console/configMgr
中"Access Token provider name: adobe-ims-similaritysearch"
的旧配置。 -
重新启动控制台。
验证配置 validate-the-configuration
完成配置后,可以使用JMX MBean来验证配置。 要进行验证,请执行以下步骤。
-
访问位于
https://[aem_server]:[port]
的Experience Manager服务器。 -
转到 工具 > 操作 > Web控制台 以打开OSGi控制台。 单击 主 > JMX。
-
单击
com.day.cq.dam.similaritysearch.internal.impl
. 它会打开 SimilaritySearch其他任务。 -
单击
validateConfigs()
. 在 验证配置 对话框中,单击 调用。
验证结果将显示在同一对话框中。
在DAM更新资产工作流中启用智能标记(可选) enable-smart-tagging-in-the-update-asset-workflow-optional
-
在Experience Manager中,转到 工具 > 工作流 > 模型。
-
在 工作流模型 页面上,选择 DAM 更新资产 工作流模式。
-
单击工具栏中的 编辑。
-
展开侧面板以显示步骤。拖动 DAM 工作流部分中可用的 智能标记资产 步骤,并将其放在 流程缩略图 步骤之后。
图:在DAM更新资产工作流的流程缩略图步骤之后添加智能标记资产步骤。
-
在编辑模式下打开该步骤。在 高级设置 下,确保选中 处理程序前进 选项。
图:配置DAM更新资产工作流并添加智能标记步骤
-
在 参数 选项卡中,如果希望完成工作流,请选择 忽略错误,即使自动标记步骤失败也是如此。
图:配置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(全文搜索)。 智能标记没有单独的搜索谓词。