準備Assets以進行智慧標籤 configure-asset-tagging-using-the-smart-content-service

開始使用Smart Content Services標籤資產之前,請先將Experience Manager Assets與Adobe Developer Console整合,以使用Adobe Sensei的Smart Service。 設定好後,請使用一些影像和標籤來訓練服務。

NOTE
  • 新的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授權。

若要設定智慧內容服務,請遵循下列最上層步驟:

  1. 若要產生公開金鑰,請在Experience Manager中建立Smart Content Service設定。 取得公開憑證以進行 OAuth 整合。

  2. 在 Adobe 開發人員控制台中建立整合,並上傳產生的公開金鑰。

  3. 使用Adobe Developer Console的API金鑰和其他認證來設定您的部署

  4. 測試設定

  5. 可選擇在資產上傳🔗上啟用自動標籤。

透過建立智慧內容服務設定來取得公開憑證 obtain-public-certificate

公開憑證可讓您在Adobe Developer Console上驗證設定檔。

  1. 在Experience Manager使用者介面中,存取​ 工具 > Cloud Service > 舊版Cloud Service

  2. 在Cloud Service頁面中,按一下​ Assets智慧標籤 ​底下的​ 立即設定

  3. 在​ 建立設定 ​對話方塊中,指定智慧標籤設定的標題和名稱。 按一下​ 建立

  4. 在​ AEM Smart Content Service ​對話方塊中,使用以下值:

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

    例如 https://smartcontent.adobe.io/apac。您可以將naemeaapac指定為您的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 金鑰存放區。按一下​ 「儲存並關閉」

    刪除金鑰存放區中現有的相似性搜尋專案,以新增安全性憑證

    圖:刪除金鑰存放區中現有的similaritysearch專案,以新增安全性憑證。

  4. 導覽至「 工具 > 雲端服務 >舊 版雲端服務」。按一 下「資產智慧標籤 >顯 示設定 >可 用設定」。按一下所需的設定。

  5. 若要下載公開憑證,請按一下​ 下載OAuth整合的公開憑證

  6. 存取https://console.adobe.io,並導覽至​ 整合 ​頁面上的現有智慧內容服務。 上傳新憑證。 如需詳細資訊,請參閱建立Adobe Developer Console整合中的指示。

建立Adobe Developer Console整合 create-adobe-i-o-integration

若要使用智慧內容服務API,請在Adobe Developer Console中建立整合,以取得Experience Manager中雲端設定的Assets智慧標籤服務設定的API金鑰 (產生於Adobe Developer Console整合的使用者端識別碼欄位中)、技術帳戶識別碼、組織識別碼以及使用者端密碼。

  1. 在瀏覽器中存取 https://console.adobe.io。選取適當的帳戶,並確認相關聯的組織角色是系統管理員。

  2. 以任何所需的名稱建立專案。按一下​ 「新增 API」

  3. 在​ 新增 API 頁面上選取​ 「Experience Cloud」,然後選取​ 「智慧內容」。按一下​ 下一步

  4. 選取​ 「上傳您的公開金鑰」。提供從 Experience Manager 下載的憑證檔案。畫面上會顯示已成功上傳公開金鑰訊息。按一下​ 下一步

    建立新的服務帳戶(JWT)認證頁面會顯示服務帳戶的公開金鑰。

  5. 按一下​ 下一步

  6. 在​ 選取產品設定檔 ​頁面上,選取​ 「智慧內容服務」。按一下​ 儲存設定的API

    此時會出現一個頁面,顯示更多關於設定的資訊。請保持此頁面開啟,以複製這些值,並將其新增至Experience Manager中雲端設定的Assets智慧標籤服務設定,以設定智慧標籤。

    在「概覽」索引標籤中,您可以檢閱為整合提供的資訊。

    圖: Adobe Developer Console中整合的詳細資料

設定智慧內容服務 configure-smart-content-service

CAUTION
之前,使用JWT憑證進行的設定現在會在Adobe Developer Console中遭到淘汰。 2024年6月3日之後,您無法建立新的JWT憑證。 此類設定無法再建立或更新,但可以移轉至 OAuth 設定。
請參閱為AEM設定IMS整合
檢視為內部部署使用者設定OAuth的步驟
請參閱針對OAuth認證的智慧標籤疑難排解

若要設定整合,請使用Adobe Developer Console整合中的技術帳戶ID、組織識別碼、使用者端密碼和使用者端識別碼欄位值。 建立智慧標籤雲端設定,可驗證來自Experience Manager部署的API要求。

  1. 在Experience Manager中,瀏覽至​ 工具 > Cloud Service > 舊版Cloud Services ​以開啟Cloud Services主控台。

  2. 在​ Assets智慧標籤 ​底下,開啟上方建立的設定。 在服務設定頁面上,按一下​ 編輯

  3. 在「 AEM Smart Content Service 」對話方塊中 ,使用「服務URL」和「授權伺服器」欄位的預先填入值

  4. 針對欄位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 組織識別碼
    使用者端密碼 使用者端密碼

為內部部署使用者設定OAuth config-oauth-onprem

先決條件 prereqs-config-oauth-onprem

授權範圍是包含以下先決條件的OAuth字串:

  • 使用ClientIDClientSecretIDOrgIDDeveloper Console中建立新的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

  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"

    • 以新OAuth設定的使用者端識別碼更新auth.token.provider.client.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並從.<randomnumber>取代OSGi設定至-<randomnumber>

  6. 刪除/system/console/configMgr"Access Token provider name: adobe-ims-similaritysearch"的舊組態。

  7. 重新啟動主控台。

驗證設定 validate-the-configuration

完成設定後,您可以使用JMX MBean來驗證設定。 若要進行驗證,請按照以下步驟操作。

  1. https://[aem_server]:[port]存取您的Experience Manager伺服器。

  2. 移至​ 工具 > 作業 > 網頁主控台 ​以開啟OSGi主控台。 按一下​ 主要 > JMX

  3. 按一下 com.day.cq.dam.similaritysearch.internal.impl。它會開啟​ SimilaritySearch其他任務

  4. 按一下 validateConfigs()。在​ 驗證組態 ​對話方塊中,按一下​ 叫用

驗證結果會顯示在相同的對話方塊中。

在DAM更新資產工作流程中啟用智慧標籤(選用) enable-smart-tagging-in-the-update-asset-workflow-optional

  1. 在Experience Manager中,移至​ 工具 > 工作流程 > 模型

  2. 在「 工作流模型 」頁面上,選擇「DAM 更新資產 」工作流模型。

  3. 按一下工具列中的​ 「編輯」

  4. 展開「側面板」以顯示步驟。拖 曳DAM Workflow (DAM工作流程) 區段中可用的智慧型標籤資產步驟,並將其置於​ 「處理縮 圖」 ​步驟之後 。

    在「DAM 更新資產」工作流程中,在處理縮圖步驟之後新增智慧標記資產步驟

    圖:在DAM更新資產工作流程中,在處理縮圖步驟之後新增智慧標籤資產步驟。

  5. 在編輯模式中開啟步驟。在「 進階設定」下,確定已選取 「處理常式進階 」選項。

    設定DAM更新資產工作流程並新增智慧標籤步驟

    圖:設定DAM更新資產工作流程並新增智慧標籤步驟

  6. 在「參 」頁籤中,如果希望工作流完成,即使自動標籤步驟失敗,請選擇「忽略錯誤 ​」。

    設定DAM更新資產工作流程以新增智慧標籤步驟並選取處理常式進階

    圖:設定DAM更新資產工作流程以新增智慧標籤步驟並選取處理常式前進

    若無論是否對資料夾啟用智慧標記,都要在資產上傳時標記資產,請選取​ 「忽略智慧標記旗標」

    設定DAM更新資產工作流程以新增智慧標籤步驟,並選取忽略智慧標籤旗標

    圖:設定DAM更新資產工作流程以新增智慧標籤步驟,並選取「忽略智慧標籤旗標」。

  7. 按一下[確定] ​關閉程式步驟,然後儲存工作流程。

訓練智慧內容服務 training-the-smart-content-service

若要讓智慧內容服務辨識您的企業分類,請在已包含與企業相關標籤的一組資產上執行它。 為了有效標籤您的品牌影像,智慧內容服務要求培訓影像符合特定准則。 訓練之後,此服務可以將相同的分類法套用至類似的資產集。

您可以訓練服務多次,以提高其套用相關標籤的能力。 在每個訓練週期後,執行標籤工作流程並檢查您的資產是否已正確標籤。

您可以定期或依需求訓練智慧內容服務。

NOTE
訓練工作流程僅在資料夾中執行。

訓練准則 guidelines-for-training

為達到最佳效果,訓練集中的影像需符合下列准則:

​數量和大小:每個標籤至少30個影像。長邊至少500像素。

Coherence:用於特定標籤的影像在視覺上類似。

例如,將所有影像標籤為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. 指定工作流程的標題並新增註解。 然後,按一下​ 執行。 資產和標籤會提交以進行訓練。

    工作流程對話方塊

NOTE
一旦資料夾中的資產處理完畢,用於訓練後,後續訓練週期內將僅處理修改後的資產。

檢視訓練報告 viewing-training-reports

若要檢查智慧型內容服務是否已針對您的資產培訓集中的標籤進行培訓,請從「報表」控制檯檢閱培訓工作流程報表。

  1. 在Experience Manager介面中,移至​ 工具 > Assets > 報表

  2. 在​ 資產報表 ​頁面中,按一下​ 建立

  3. 選取「智慧標籤培訓」報表,然後從工具列按一下「下一步」。

  4. 指定報表的標題和說明。在「 排程報表」下,保 留「現在 」選項。如果您想要排程報表以供稍後使用,請選 「稍後」並指定日期和時間。然後,從工具列按一下​ 建立

  5. 在「資 產報表 」頁面中,選取您產生的報表。若要檢視報表,請按一下工具列中的​ 檢視

  6. 檢閱報告的詳細資訊。

    報表會顯示您所訓練之標籤的訓練狀態。「培訓狀態」欄 中的綠色 ,表示智慧型內容服務已接受標籤的培訓。黃色表示服務未針對特定標籤進行完整訓練。在這種情況下,請使用特定標籤新增更多影像,並執行培訓工作流程,以完全在標籤上訓練服務。

    如果您在此報告中未看到您的標籤,請再次執行這些標籤的培訓工作流程。

  7. 若要下載報表,請從清單中選取報表,然後按一下工具列中的[下載]。 ​報表會下載為Microsoft Excel試算表。

限制 limitations

  • 增強型智慧標籤是以影像及其標籤的學習模型為基礎。 這些模型並非總能完美地識別標籤。 目前版本的智慧內容服務有下列限制:

    • 無法辨認影像中的細微差異。 例如,超薄襯衫和一般適合的襯衫。
    • 無法根據影像的微小模式/部分識別標籤。 例如,T恤上的標誌。
    • 支援Experience Manager的區域設定支援標籤。
  • 若要搜尋具有智慧標籤(一般或增強功能)的資產,請使用Assets Omnisearch (全文檢索搜尋)。 智慧標籤沒有單獨的搜尋述詞。

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