使用自然語言搜尋和分析AEM內容

使用來自Adobe CX Coworker的​Content AI MCP伺服器 (與AEM MCP伺服器搭配使用)以自然語言搜尋和分析Content AI來源,而不需撰寫低階API程式碼或導覽UI。

在本教學課程中,您​ 探索 ​可用的來源、執行​關鍵字語意​和​ 混合 ​搜尋,並使用​ 自然語言搜尋 ​來表達複雜的意圖,所有這些都是從Adobe CX Coworker針對Content AI來源進行的。

工具與存取

Content AI MCP Server提供六種工具:

工具
用途
list_indexes
探索AEM環境中可用的索引。
get_index_config
檢查原始索引設定和中繼資料。
fulltext_search
以關鍵字為基礎的搜尋,具有模糊比對和欄位選擇。
semantic_search
概念查詢的向量型相似性搜尋。
hybrid_search
結合關鍵字+語意搜尋,以獲得最佳的一般用途召回。
natural_language_search
以純英文表達意圖;伺服器會將其轉譯為結構化篩選器、範圍和語意。

Content AI MCP伺服器是​public-source-onlyX-Api-Key標頭授與來源存取權。 需要API金鑰;沒有金鑰的請求會遭到拒絕。

IMPORTANT
用於驗證您的MCP工作階段的任何登入Adobe身分或OAuth/IMS持有者權杖都是​ 絕不會轉送到Content AI,而且對於您可以搜尋的來源沒有影響。 ​只有公開、唯讀的來源可透過此伺服器搜尋,無論您的登入身分的其他許可權為何。

新增Content AI MCP伺服器

Adobe CX Coworker連線至Content AI MCP伺服器,然後執行以下案例。

讓我們在Adobe CX Coworker中設定Content AI MCP伺服器,步驟如下。

  1. 登入Adobe CX Coworker。

    Adobe CX Coworker登入 {modal="regular"}

  2. 從側邊欄按一下​MCP伺服器

    MCP伺服器側邊欄 {modal="regular"}

  3. 按一下​新增MCP伺服器

    新增MCP伺服器 {modal="regular"}

  4. 在​ 新增MCP伺服器 ​對話方塊中,輸入下列詳細資料:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    欄位
    伺服器名稱 content-ai-mcp
    MCP URL https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai
    連線型別 HTTP
    驗證型別 Passthrough

    新增MCP伺服器對話方塊 {modal="regular"}

    note
    NOTE
    驗證型別​已設定為Passthrough,因此CX Coworker會將您登入的Adobe身分識別轉送至MCP伺服器。 此身分識別不用於Content AI來源存取(請參閱工具和存取),因此您不需要個別登入或OAuth步驟來搜尋本身。
  5. 按一下​ 新增標題 ​並新增:

    table 0-row-2 1-row-2 2-row-2
    頁首
    X-Api-Key 您的Content AI API金鑰。 必填 — 拒絕沒有它的搜尋。
    x-content-ai-mcp-routing (選擇性)​環境/路由資訊,例如tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example
    note
    NOTE
    如果您未設定x-content-ai-mcp-routing標頭,伺服器會在您第一次執行工具時要求您的環境(tierbucket),然後自動重試。
    natural_language_search需要超過其他五個工具:除了tierbucket之外,它還需要路由中的​**cluster​和​namespace**。 如果其中一個遺失,工具會傳回missing_nls_routing錯誤 — 以遺失的值回覆,且伺服器會自動重試。
  6. 按一下​「新增」content-ai-mcp​伺服器現在會出現在您的MCP伺服器清單中。

    已列出Content AI MCP伺服器 {modal="regular"}

  7. 按一下​ 新增聊天 ​以開始使用Content AI MCP伺服器。

    新交談 {modal="regular"}

搜尋公用來源

透過此伺服器公開的Content AI來源為​public:唯讀,且適用於公開的、不敏感的內容。 擁有有效API金鑰的任何人都可以搜尋。

使用此伺服器時:

  • 您想要搜尋公開可用的內容(例如公開檔案或示範目錄)。
  • 您不需要每個使用者、許可權範圍內的結果。
  • 您想要的簡單設定只需要API金鑰。

新增Content AI MCP伺服器中所述,透過伺服器連線,直接從聊天室探索及搜尋來源。

  1. 在CX Coworker中,開啟新聊天並列出您的API金鑰可用來源:

    code language-text
    List all Content AI sources available in my environment.
    

    伺服器會傳回符合您路由/環境的公用來源。

恭喜!

您可以在Adobe CX Coworker中設定Content AI MCP伺服器,並使用它來搜尋Content AI來源。 您找到可用的來源,並以自然語言搜尋它們,包括關鍵字、語意、混合和自然語言搜尋。 您也瞭解到,此伺服器僅透過API金鑰搜尋​公開來源,以及如何透過選取欄位來縮小回應大小。 您可以使用來自CX Coworker的相同簡單方法來搜尋和分析Content AI來源,而不需要切換到UI或編寫低階搜尋API程式碼。

recommendation-more-help
experience-manager-learn-help-cloud-service