文件AEM GuidesAEM Guides 文件

設定AI助理

Last update: Wed May 28 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 使用者

作為管理員，您可以在Experience Manager Guides中設定AI助理功能。 AI小幫手由Adobe IMS驗證型驗證保護。 將您的環境與Adobe的安全權杖型驗證工作流程整合，並開始使用AI助理功能。 下列組態可協助您將​ AI組態 ​索引標籤新增至資料夾設定檔。 新增後，您就可以在Experience Manager Guides中使用AI助理功能。

執行以下步驟來設定「AI小幫手」：

  1. 在Adobe Developer Console中建立IMS設定。
  2. 將IMS設定新增至環境
  3. 在環境中啟用AI標幟
  4. 在環境中新增GUIDES_AI_SITE_ID變數
  5. 套用變更至環境
  6. 在資料夾設定檔中啟用AI助理
  7. 在資料夾設定檔中設定智慧建議

在Adobe Developer Console中建立IMS設定

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

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

  1. 啟動Adobe Developer Console。

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

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

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

  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"}

在環境中啟用AI標幟

若要在Experience Manager Guides UI上啟用AI助理功能，請在環境中新增ENABLE_GUIDES_AI標幟。

確定您使用與下列熒幕擷取畫面相同的名稱和設定。

{width="800"}

將標幟設定為​ true ​會啟用該功能，而將其設定為​ false ​則會停用該功能。

在環境中新增GUIDES_AI_SITE_ID變數

在您的環境(Cloud Manager)中新增GUIDES_AI_SITE_ID變數並將值設定為id_f651abc807c84f52b425737bb93f87ba以啟用它。

確定您使用與下列熒幕擷取畫面相同的名稱和設定。

{width="800"}

套用變更至環境

新增IMS設定並啟用AI Assistant標幟到環境後，執行以下步驟來使用OSGi將這些屬性與AEM Guides連結：

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

    • com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
    • com.adobe.guides.ai.config.service.AiConfigImpl.cfg.json

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

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

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

在資料夾設定檔中啟用AI助理

套用組態變更後，為所需的資料夾設定檔啟用AI助理員功能。

如需詳細資訊，請檢視瞭解編輯器功能。

{width="300"}

在資料夾設定檔中設定智慧建議

啟用AI助理功能後，請在資料夾設定檔中設定智慧建議功能。

如需詳細資訊，請參閱在資料夾設定檔中設定智慧建議。

附錄 appendix

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

內容：

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

檔案： com.adobe.guides.ai.config.service.AiConfigImpl.cfg.json

內容：

{
  "conref.inline.threshold":0.6,
  "conref.block.threshold":0.7,
  "related.link.threshold":0.5,
  "emerald.url":"https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1",
  "instance.type":"prod",
  "chat.url":"https://aem-guides-ai-v2.adobe.io"
  }

AI助理設定詳細資料

索引鍵
描述
允許的值
預設值
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
chat.url
AI助理服務的端點
https://aem-guides-ai-v2.adobe.io
https://aem-guides-ai-v2.adobe.io
instance.type
AEM執行個體的型別。 請確定此名稱對於已設定智慧建議的每個AEM執行個體都是唯一的。 使用案例是在Stage環境中以「instance.type」=「stage」測試功能，同時在「prod」上也設定此功能。
任何可識別環境的唯一關鍵值。 僅允許​ 個英數字元 ​值。 "dev"/"stage"/"prod"/"test1"/"stage2"
"prod"

完成設定後， AI助理圖示會顯示在Experience Manager Guides的首頁和編輯器中。 如需詳細資訊，請檢視Experience Manager使用手冊中的AI助理區段。

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