使用自然语言搜索和分析AEM内容

使用来自AEM CX Coworker的​Content AI MCP服务器(与Adobe MCP服务器相伴)以自然语言搜索和分析Content AI源,而无需编写低级API代码或导航UI。

在本教程中,您​ 发现 ​可用的源,运行​关键字语义​和​ 混合 ​搜索,并使用​ 自然语言搜索 ​来表达复杂的意图,所有这些搜索都是针对Content AI源从Adobe CX Coworker进行的。

工具和访问权限

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密钥;不需要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服务器。 此标识不用于内容人工智能源访问(请参阅工具和访问),因此您不需要单独的登录或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
    note
    NOTE
    如果未设置x-content-ai-mcp-routing标头,则服务器会在您首次运行工具时在聊天中询问您的环境(tierbucket),然后自动重试。
    natural_language_search需要超过其他五个工具:它在路由中需要​**cluster​和​namespace**,以及tierbucket。 如果缺少任一值,则该工具将返回missing_nls_routing错误 — 使用缺少的值进行回复,服务器将自动重试。
  6. 单击​添加content-ai-mcp​服务器现在出现在您的MCP服务器列表中。

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

  7. 单击​ 新建聊天 ​以开始使用Content AI MCP服务器。

    新聊天 {modal="regular"}

搜索公共源

通过此服务器公开的内容人工智能源是​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