Adobe Experience Manager (AEM) Assets Copilot 連接器,將 AEM Assets 內容整合進 Microsoft 365 生態系統,使 Copilot 與 Microsoft Search 能夠顯示已發佈的資產。 本文說明部署與客製化連接器的步驟。
必要條件
在部署 Adobe Experience Manager 資產連接器前,請確保你符合以下先決條件:
- 您必須是貴組織 Microsoft 365 租戶的搜尋管理員。
- 你有你組織的 Adobe Experience Cloud 實例作者環境 URL 和發佈環境 URL:
- 作者網址格式:
https://author-p<PROGRAM_ID>-e<ENVIRONMENT_ID>.<REGION>.adobeaemcloud.com - 發佈網址格式:
https://publish-p<PROGRAM_ID>-e<ENVIRONMENT_ID>.<REGION>.adobeaemcloud.com
- 作者網址格式:
- 你有一個 Adobe Experience Manager Assets 的技術帳號,並擁有存取已發佈資產和元資料的憑證。 這個帳號是一個安全、服務型的外部存取帳號。 詳情請參見「 為伺服器端 API 產生存取權杖」。
展開連接器
要為您的組織新增 Adobe Experience Manager 資產連接器:
- 在 Microsoft 365 系統管理中心左側窗格,選擇 Copilot>連接器。
- 到「 連接器 」分頁,在左側窗格選擇 「圖庫」。
- 從可用的連接器列表中,選擇 Adobe Experience Manager 資產。
集合顯示名稱
顯示名稱用來識別 Copilot 回應中的參考資料,並作為內容來源過濾器。 你可以接受預設的顯示名稱,或自訂成組織內使用者熟悉的名稱。
欲了解更多資訊,請參閱 增強 Copilot 對連接器內容的發現。
設定實例網址
提供 Adobe Experience Manager 資產實例的作者與發佈環境 URL。
選擇認證類型
連接器支援 Adobe Experience Cloud 的技術帳號認證 。 請依照「 為伺服器端 API 產生存取權杖」中所述配置技術帳號。
推出
在部署前驗證連接器,請使用分階段部署。 若要推送至有限受眾,請選擇「 推展」 旁的「有限受眾」切換,並指定要推送連接器的使用者與群組。 欲了解更多資訊,請參閱 Copilot 連接器的分階段部署。
選擇 建立 來部署連線。 連接器會立即開始索引已發表的資產。
下表列出預設值。
| 類別 | 預設值 |
|---|---|
| 使用者 | 所有透過連接器索引的已發佈資產,租戶中的所有 Microsoft 365 使用者都能看到。 |
| 內容 | 所有已發佈的資產皆預設為選擇。 |
| 同步處理 | 漸進爬行:每15分鐘一次;全天候爬行:每天。 |
要自訂這些數值,請選擇 自訂設定。 欲了解更多資訊,請參閱 自訂設定。
建立連線後,您可以在 Microsoft 365 系統管理中心的連接器區查看狀態。
自訂設定 (可選)
你可以自訂 Adobe Experience Manager 資產連接器設定的預設值。 要自訂設定,在管理中心的連接器頁面選擇 自訂設定。
自訂使用者設定
存取權限
目前,只有您 AEM 資產中已發佈的資產才會被索引。 所有使用 Adobe Experience Manager 資產 Copilot 連接器索引的資料,租戶中所有 Microsoft 365 使用者都能透過 Microsoft Search 或 Copilot 看到。
使用者身份映射
連接器將 Adobe Experience Cloud 使用者帳號映射到 Microsoft 365 (Microsoft Entra ID) 身份。 如果 Adobe Experience Cloud 使用者的電子郵件與其 Entra ID 使用者主體名稱 (UPN) 相符,此映射將自動完成。 如果兩者不同,你可以提供一個映射規則,將 Adobe Experience Cloud 的身份映射到 Microsoft 365 中的身份。 映射規則確保系統在回應中向 Adobe Experience Cloud 內容提供適當的活動訊號。
自訂內容設定
內容擷取過濾器
內容擷取過濾器允許您根據路徑與元資料屬性定義包含與排除規則,控制哪些資產被索引。
你可以選擇包含或排除某些內容路徑。
應該擷取的內容路徑 只支援精確路徑。 有效的內容路徑必須包含至少兩個層級,根 /content 路徑為 。
不應該被擷取的內容路徑 只支援輸入 Java 正規表達式的路徑。 排除路徑優先於已包含路徑。
您也可以根據中繼資料屬性的值設定擷取過濾器,包括標準與自訂的中繼資料屬性:
- 輸入該屬性的 JSON 路徑 。
- 從下拉選單 (
=,!=, ,In)Not In選擇一位操作員。 - 輸入目標值。
要找到並驗證屬性路徑,請參閱 查詢建構器 API。
在 . 處開啟查詢建構器除錯器
http://<host>:<port>/libs/cq/search/content/querydebug.html。輸入以下查詢。
p.limit=10 p.guessTotal=true p.hits=full type=dam:Asset p.nodedepth=2 property=jcr:content/cq:lastReplicationAction property.value=Activate選擇 搜尋。
結果回傳後,選擇 JSON 查詢建工具連結 ,查看包含所有屬性的 JSON 內容。
找到該屬性的屬性和 JSON 路徑。 例如,屬性
dc:format的 JSON 路徑為hits.jcr:content.metadata.dc:format。
Operators
操作員定義在內容過濾過程中對屬性所施加的比較類型。 支援的運算子如下:
-
=:平等 -
!=:不平等 -
In:與列表中的任意值相匹配 -
Not In:排除列表中的任何值
目標值
目標值會指定屬性應該對應什麼。
| 源頭性質 | 語意標籤 | 描述 |
|---|---|---|
| IconUrl | IconUrl | 圖示網址 |
| 項目路徑 | 項目路徑 | 資料來源中項目的路徑以 / 分離值表示。 儲存階層中每個層級的顯示值,分隔為 /。 |
| 最後修改者 | 上次修改者 | 最近編輯該資料來源項目的人姓名 |
| 長度 | 無 | 圖片長度 |
| 連結 | URL | 資料來源中項目的目標網址 |
| 修改時間 | 最後修正日期時間 | 該項目在資料來源中最後修改的日期與時間 |
| 出版人 | 無 | 在資料來源中發表該項目的人姓名 |
| 發布時間 | 無 | 該項目在資料來源中發布的日期與時間 |
| title | 無 | 物品標題 |
| 寬度 | 無 | 寬度 |
| 標記 | 無 | 標籤定義於 Adobe Experience Manager 資產的元資料中。 在 Adobe Experience Manager 中,標籤是階層式組織的。 |
管理物業
要檢查 Adobe Experience Manager 資產中的可用標準屬性,請為屬性指派一個結構, (定義屬性是否可搜尋、查詢、可檢索或可精煉) ,更改語意標籤,並為屬性添加別名。 以下標準屬性預設為索引。
| 源頭性質 | 語意標籤 | 描述 |
|---|---|---|
| 另類文字 | 無 | Adobe Experience Manager 資產元資料中的 替代文字 欄位。 |
| 資產類型 | 無 | 資產的檔案類型 (例如影像、多媒體、文件) 。 |
| 內容 | 內容 | 文件內容,無法提供圖片。 |
| CreatedBy | 建立者 | 資料來源中項目建立的日期與時間。 |
| 創造時間 | 建立約會時間 | 資料來源中項目建立的日期與時間。 |
| 描述 | 描述 | 資產內容簡要摘要。 |
| 檔案副檔名 | 副檔名 | 檔案名稱結尾的後綴,例如 .txt、.jpg、.exe。 |
| FileName | 標題 | 資產的檔名。 |
| IconUrl | IconUrl | 圖示網址。 |
| 項目路徑 | 項目路徑 | 資料來源中項目的路徑以 / 分離值表示。 儲存階層中每個層級的顯示值,分隔為 /。 |
| 最後修改者 | 上次修改者 | 最近編輯該資料來源項目的人姓名。 |
| 長度 | 無 | 圖片長度。 |
| 連結 | URL | 資料來源中項目的目標網址。 |
| 修改時間 | 最後修正日期時間 | 該項目在資料來源中最後修改的日期與時間。 |
| 出版人 | 無 | 在資料來源中發表該項目的人姓名。 |
| 發布時間 | 無 | 該項目在資料來源中發表的日期與時間。 |
| title | 無 | 物品標題。 |
| 寬度 | 無 | 寬度。 |
| 標記 | 無 | 標籤定義於 Adobe Experience Manager 資產的元資料中。 在 Adobe Experience Manager 中,標籤是階層式組織的。 |
新增更多自訂屬性:
- 選擇 新增屬性。
- 請填寫以下欄位:a。 物業名稱 b。 C型。 JSON 路徑
- 定義該結構 (可搜尋、可查詢、可檢索或可精煉的) 。
自訂同步間隔
刷新間隔決定資料來源與 Adobe Experience Manager 資產連接器索引同步的頻率。 副駕駛連接器使用兩種刷新間隔:
- 完整爬行:預設值是每天。
- 增量爬行:預設值為每 15 分鐘一次。
你可以更改刷新間隔的預設值。 欲了解更多資訊,請參閱 同步設定指引。