使用自然语言搜索和分析AEM内容
使用来自AEM CX Coworker的Content AI MCP服务器(与Adobe MCP服务器相伴)以自然语言搜索和分析Content AI源,而无需编写低级API代码或导航UI。
在本教程中,您 发现 可用的源,运行关键字、语义和 混合 搜索,并使用 自然语言搜索 来表达复杂的意图,所有这些搜索都是针对Content AI源从Adobe CX Coworker进行的。
工具和访问权限
Content AI MCP Server提供六种工具:
list_indexesget_index_configfulltext_searchsemantic_searchhybrid_searchnatural_language_searchContent AI MCP服务器是public-source-only: X-Api-Key标头授予源访问权限。 需要API密钥;不需要API密钥的请求会被拒绝。
添加Content AI MCP服务器
将Adobe CX Coworker连接到Content AI MCP服务器并运行以下方案。
让我们按照以下步骤在Adobe CX Coworker中设置Content AI MCP服务器。
-
登录到Adobe CX Coworker。
{modal="regular"}
-
单击侧边栏中的MCP服务器。
{modal="regular"}
-
单击添加MCP服务器。
{modal="regular"}
-
在 添加MCP服务器 对话框中,输入以下详细信息:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 字段 值 服务器名称 content-ai-mcpMCP URL https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai连接类型 HTTP身份验证类型 Passthrough {modal="regular"}
note NOTE 身份验证类型设置为 Passthrough,因此CX Coworker将您的登录Adobe身份转发到MCP服务器。 此标识不用于内容人工智能源访问(请参阅工具和访问),因此您不需要单独的登录或OAuth步骤来进行搜索。 -
单击 添加标头 并添加:
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标头,则服务器会在您首次运行工具时在聊天中询问您的环境(tier和bucket),然后自动重试。natural_language_search需要超过其他五个工具:它在路由中需要**cluster和namespace**,以及tier和bucket。 如果缺少任一值,则该工具将返回missing_nls_routing错误 — 使用缺少的值进行回复,服务器将自动重试。 -
单击添加。 content-ai-mcp服务器现在出现在您的MCP服务器列表中。
{modal="regular"}
-
单击 新建聊天 以开始使用Content AI MCP服务器。
{modal="regular"}
搜索公共源
通过此服务器公开的内容人工智能源是public:只读,用于公开的非敏感内容。 拥有有效API密钥的任何人都可以搜索它们。
在以下情况下使用此服务器:
- 您要搜索公开可用的内容(例如,公共文档或演示目录)。
- 您不需要每个用户、权限范围内的结果。
- 您需要一个仅需要API密钥的简单设置。
如添加Content AI MCP服务器中所述,连接服务器后,直接从聊天中查找和搜索源。
-
在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代码。