文件AEMAEM as a Cloud Service 教學課程

使用Content AI MCP伺服器搜尋AEM內容

最後更新： 2026年7月23日
  • 適用對象：
  • Experience Manager as a Cloud Service

建立對象：

  • Beginner
  • Leader
  • User
  • Developer

使用來自Adobe CX Co-worker的​Content AI MCP伺服器，以自然語言（沒有低階API程式碼或UI導覽）搜尋和分析Content AI索引。

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

概觀

AEM as a Cloud Service提供​MCP伺服器，讓您的IDE或聊天應用程式可以安全地與AEM搭配使用。 Content AI MCP伺服器​會透過Content AI索引公開搜尋和探索工具。 如需詳細資訊，請參閱AEM🔗中的MCP伺服器。

Content AI MCP Server提供六種工具：

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

Content AI MCP Server支援兩種存取模式，依您設定的標題選取：

  • 公用（匿名） — 使用X-Api-Key標頭搜尋公用、唯讀索引。 將此用於公開可用的、非敏感的內容。 請參閱搜尋公用索引。
  • 已驗證 — 使用x-content-ai-mcp-api-key標頭搭配您登入的Adobe身分識別（由CX Co-worker傳遞）來搜尋授權或存取控制的索引。 結果會遵循您的許可權。

開發人員可如何加以使用

將Adobe CX Co-worker連線至Content AI MCP伺服器並執行下列情境。

設定 — Adobe CX Co-worker中的Content AI MCP Server

讓我們在Adobe CX Co-worker中設定Content AI MCP Server，步驟如下。

  1. 登入Adobe CX Co-worker。

    Adobe CX Co-worker登入

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

    MCP伺服器側邊欄

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

    新增MCP伺服器

  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伺服器對話方塊

    note
    NOTE
    驗證型別​已設為Passthrough，因此CX Co-worker會將您登入的Adobe身分識別轉送至MCP伺服器。 您不需要個別的登入或OAuth步驟。

  5. 按一下「新增標頭」並新增您需要的存取模式標頭：

    對於公用索引（匿名）：

    table 0-row-2 1-row-2 2-row-2
    頁首 值
    X-Api-Key 您的公開API金鑰。 當您只想搜尋公用索引時，請顯示此標題。
    x-content-ai-mcp-routing （選擇性）​環境/路由資訊，例如tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example。

    非公用（已授權）索引：

    table 0-row-2 1-row-2 2-row-2
    頁首 值
    x-content-ai-mcp-api-key 來自Adobe Developer Console的API金鑰。
    x-content-ai-mcp-routing （選擇性）​環境/路由資訊，例如tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example。
    note important
    IMPORTANT
    當X-Api-Key標頭出現時，伺服器會將要求視為​匿名，並只搜尋公用索引。 任何登入的身分都會被忽略，因此不會意外升級至已驗證的存取。 當您要搜尋已授權的索引時，請使用x-content-ai-mcp-api-key （不是X-Api-Key）。
    note
    NOTE
    如果您未設定x-content-ai-mcp-routing標頭，伺服器會在您第一次執行工具時要求您的環境（tier和bucket），然後自動重試。

  6. 按一下​「新增」。 content-ai-mcp​伺服器現在會出現在您的MCP伺服器清單中。

    已列出Content AI MCP伺服器

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

    新交談

搜尋公用索引

部分Content AI索引標示為​public，可以匿名搜尋，沒有授權的身分。 公用索引是唯讀的，其用途是供公開使用且非敏感的內容。 擁有公開API金鑰的任何人都可以搜尋。

在下列情況下使用此模式：

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

若要搜尋公用索引，請完全按照Adobe CX Co-worker中的設定 — Content AI MCP Server中的說明在CX Co-worker中新增Content AI MCP Server，但在​ 新增標頭 ​步驟中僅新增X-Api-Key標頭（加上環境的可選x-content-ai-mcp-routing標頭）：

頁首
值
X-Api-Key
您的公開API金鑰。
x-content-ai-mcp-routing
（選擇性）​環境/路由資訊，例如tier=publish,bucket=p12345-e67890。
IMPORTANT
當X-Api-Key標頭出現時，伺服器會將要求視為​匿名，並只搜尋公用索引。 任何登入的身分都會被忽略。 當您要搜尋已授權的索引時，請勿使用X-Api-Key，請改用x-content-ai-mcp-api-key。

在伺服器連線後，探索和搜尋公用索引的方式與已驗證的索引相同。

  1. 在CX Co-worker中，開啟新聊天並列出您的API金鑰可用的公開索引：

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

    伺服器只會搜尋此要求的公用索引，並傳回相符的結果。

摘要

您可以在Adobe CX Co-worker中設定AEM Content AI MCP伺服器，並使用它來搜尋Content AI索引。 您使用關鍵字、語意、混合和自然語言搜尋，發現可用的索引並以自然語言搜尋它們。 您也學習了如何使用API金鑰匿名搜尋​公用索引，以及如何使用欄位選取來縮小回應大小。 您可以使用來自CX Co-worker的相同以人為中心的流程來搜尋和分析Content AI索引，而無需切換至UI或撰寫低階搜尋API程式碼。

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