文件AEM GuidesAEM Guides 文件

設定AI支援的智慧型建議以進行編寫

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 使用者

身為管理員，您可以為作者設定「智慧型建議」功能。 智慧型建議服務受到Adobe IMS驗證型驗證的保護。 將您的環境與Adobe的安全權杖型驗證工作流程整合，並開始使用新的智慧建議功能。 下列組態可協助您將​ AI組態 ​索引標籤新增至資料夾設定檔。 新增後，您便可以在網頁編輯器中使用智慧型建議功能。

在Adobe Developer Console中建立IMS設定

執行以下步驟，在Adobe Developer Console中建立IMS設定：

NOTE
如果您已建立OAuth專案來設定以微服務為基礎的發佈，您可以略過下列步驟來建立專案。

  1. 啟動Adobe Developer Console。

  2. 成功登入Developer Console後，您將檢視​ 首頁 ​畫面。 首頁 ​畫面可讓您輕鬆找到資訊和快速連結，包括專案和下載的頂端導覽連結。

  3. 若要建立新的空白專案，請從​ 快速入門 ​連結中選取​ 建立新專案。
    快速入門連結 {width="550"}
    建立新專案。

  4. 從​ 專案 ​畫面選取​ 新增API。 新增API ​畫面會出現。 此畫面會顯示所有可用的API、事件和服務，供您用來開發應用程式的Adobe產品和技術。

  5. 選取​ I/O管理API ​以將其新增至您的專案。
    IO管理API
    新增I/O Management API至您的專案。

  6. 建立新的​ OAuth認證 ​並儲存。

    設定API中的 OAuth認證磚

    將OAuth認證設定到您的API。

  7. 在​ 專案 ​索引標籤中，選擇​ OAuth伺服器至伺服器 ​選項，然後選取新建立的認證。

  8. 選取​ OAuth伺服器對伺服器 ​連結以檢視專案的認證詳細資料。

    已連線的認證 {width="800"}

    連線到專案以檢視認證詳細資料。

  9. 返回「專案」標籤，並在左側選取「專案概述」。

    專案概述 {width="500"}

    開始新專案。

  10. 按一下頂端的「下載」按鈕即可下載服務JSON。

    下載json {width="500"}

    下載JSON服務詳細資料。

您已設定OAuth驗證詳細資料並下載JSON服務詳細資料。 將此檔案依下一區段的要求保留為方便使用。

將IMS設定新增至環境

執行以下步驟，將IMS設定新增至環境：

  1. 開啟Experience Manager，然後選取包含您要設定環境的程式。
  2. 切換至​ 環境 ​標籤。
  3. 選取您要設定的環境名稱。 這應該會將您導覽至​ 環境資訊 ​頁面。
  4. 切換至​ 組態 ​標籤。
  5. 更新SERVICE_ACCOUNT_DETAILS JSON欄位。 確定您使用與下列熒幕擷取畫面相同的名稱和設定。

ims服務帳戶設定 {width="800"}

新增環境組態詳細資料。

新增IMS設定至環境後，請使用OSGi執行以下步驟將這些屬性與AEM Guides連結：

  1. 在您的Cloud Manager Git專案程式碼中，新增以下指定的兩個檔案（針對檔案內容，請檢視附錄）。

    • com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
    • com.adobe.fmdita.smartsuggest.service.SmartSuggestConfigurationConsumer.cfg.json

  2. 確保您的filter.xml涵蓋新新增的檔案。

  3. 認可並推送您的Git變更。

  4. 執行管道以在環境中套用變更。

完成此操作後，您應該能夠使用智慧型建議功能。

附錄 appendix

檔案：
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json

內容：

{
 "service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]",
}

檔案： com.adobe.fmdita.smartsuggest.service.SmartSuggestConfigurationConsumer.cfg.json

內容：

{
  "smart.suggestion.flag":true,
  "conref.inline.threshold":0.6,
  "conref.block.threshold":0.7,
  "emerald.url":"https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1",
  "instance.type":"prod"
}

智慧建議組態詳細資料

索引鍵
說明
允許的值
預設值
smart.suggestion.flag
控制是否啟用智慧建議
true/false
false
conref.inline.threshold
此臨界值可控制針對使用者目前輸入的標籤所擷取建議的精確度/召回率。
從–1.0到1.0的任何值。
0.6
conref.block.threshold
此臨界值會控制在整個檔案中為標籤擷取的建議精確度/召回率。
從–1.0到1.0的任何值。
0.7
emerald.url
翡翠向量資料庫的端點
https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1
https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1
instance.type
AEM執行個體的型別。 請確定此名稱對於已設定智慧建議的每個AEM執行個體都是唯一的。 使用案例是在Stage環境中以「instance.type」=「stage」測試功能，同時在「prod」上也設定此功能。
任何可識別環境的唯一關鍵值。 僅允許​ 個英數字元 ​值。 "dev"/"stage"/"prod"/"test1"/"stage2"
"prod"

完成設定後，智慧型建議圖示會顯示在Web編輯器的右側面板中。 編輯主題時，您可以檢視智慧型建議清單。 如需更多詳細資料，請檢視Experience Manager使用手冊中的AI智慧型編寫建議區段。

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178