Pesquisar e analisar o conteúdo do AEM com linguagem natural

Use o Servidor MCP da IA de Conteúdo (um complemento do Servidor MCP do AEM) do Adobe CX Coworker para pesquisar e analisar fontes da IA de Conteúdo em linguagem natural, sem gravar código de API de baixo nível ou navegar na interface do usuário.

Neste tutorial, você descobre fontes disponíveis, executa pesquisas de palavra-chave, semântica e híbridas e usa a pesquisa natural de linguagem para expressar intenções complexas, tudo do Adobe CX Coworker em relação a uma fonte de IA de conteúdo.

Ferramentas e acesso

O Servidor MCP da IA de conteúdo fornece seis ferramentas:

Ferramenta
Propósito
list_indexes
Descubra os índices disponíveis em seu ambiente do AEM.
get_index_config
Inspecione a configuração e os metadados do índice bruto.
fulltext_search
Pesquisa baseada em palavra-chave com correspondência difusa e seleção de campo.
semantic_search
Pesquisa de similaridade baseada em vetor para consultas conceituais.
hybrid_search
Palavra-chave combinada + pesquisa semântica para a melhor recuperação de uso geral.
natural_language_search
intenção expressa em inglês simples; o servidor a traduz em filtros estruturados, intervalos e semântica.

O Servidor MCP da IA de Conteúdo é public-source-only: o cabeçalho X-Api-Key concede acesso à origem. Uma chave de API é necessária; uma solicitação sem ela é rejeitada.

IMPORTANT
Qualquer identidade de Adobe conectada ou token de portador OAuth/IMS usado para autenticar sua sessão de MCP é nunca encaminhado para a IA de Conteúdo e não tem efeito sobre quais fontes você pode pesquisar. Somente fontes públicas somente leitura podem ser pesquisadas por meio deste servidor, independentemente dos outros direitos da sua identidade conectada.

Adicionar o servidor MCP da IA de conteúdo

Conecte o Adobe CX Coworker ao Servidor MCP da IA de Conteúdo e execute o cenário abaixo.

Vamos configurar o Servidor MCP de IA de conteúdo no Adobe CX Coworker com essas etapas.

  1. Faça logon no Adobe CX Coworker.

    Logon no Adobe CX Coworker {modal="regular"}

  2. No painel lateral, clique em Servidores MCP.

    Painel Lateral dos Servidores MCP {modal="regular"}

  3. Clique em Adicionar Servidor MCP.

    Adicionar Servidor MCP {modal="regular"}

  4. Na caixa de diálogo Adicionar Servidor MCP, insira os seguintes detalhes:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Texto Valor
    Nome do servidor content-ai-mcp
    URL DO MCP https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai
    Tipo de conexão HTTP
    Tipo de autenticação Passthrough

    Adicionar Caixa de Diálogo do Servidor MCP {modal="regular"}

    note
    NOTE
    Tipo de autenticação está definido como Passthrough, portanto, o CX Coworker encaminha sua identidade de Adobe conectada ao Servidor MCP. Essa identidade não é usada para acesso de origem à IA de conteúdo (consulte Ferramentas e acesso), portanto, você não precisa de uma entrada separada ou etapa OAuth para pesquisar a si mesmo.
  5. Clique em Adicionar cabeçalhos e adicione:

    table 0-row-2 1-row-2 2-row-2
    Cabeçalho Valor
    X-Api-Key Sua chave da API da IA de conteúdo. Obrigatório — as pesquisas são rejeitadas sem ela.
    x-content-ai-mcp-routing (Opcional) Informações de ambiente/roteamento, por exemplo tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.
    note
    NOTE
    Se você não definir o cabeçalho do x-content-ai-mcp-routing, o servidor solicitará seu ambiente (tier e bucket) no chat na primeira vez que você executar uma ferramenta e, em seguida, tentará novamente automaticamente.
    natural_language_search precisa de mais do que as outras cinco ferramentas: requer cluster e namespace em roteamento, além de tier e bucket. Se algum deles estiver ausente, a ferramenta retornará um erro missing_nls_routing — responda com o(s) valor(es) ausente(s) e o servidor tentará novamente automaticamente.
  6. Clique em Adicionar. O servidor content-ai-mcp agora aparece na sua lista de Servidores MCP.

    Servidor MCP de IA de Conteúdo Listado {modal="regular"}

  7. Clique em Novo chat para começar a usar o Servidor MCP de IA de Conteúdo.

    Novo Chat {modal="regular"}

Pesquisando fontes públicas

As fontes de IA de conteúdo expostas por meio deste servidor são públicas: somente leitura e destinadas a conteúdo não confidencial abertamente disponível. Qualquer pessoa com uma chave de API válida pode pesquisá-las.

Usar este servidor quando:

  • Você deseja pesquisar conteúdo disponível abertamente (por exemplo, documentação pública ou um catálogo de demonstração).
  • Você não precisa de resultados com escopo de permissão por usuário.
  • Você deseja uma configuração simples que exija apenas uma chave de API.

Com o servidor conectado conforme descrito em Adicionar o Servidor MCP da IA de Conteúdo, descubra e pesquise fontes diretamente no chat.

  1. No CX Coworker, abra um novo chat e liste as fontes disponíveis para sua chave de API:

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

    O servidor retorna as fontes públicas correspondentes ao seu roteamento/ambiente.

Parabéns!

Você configurou o servidor MCP da IA de conteúdo no Adobe CX Coworker e o usou para pesquisar fontes de IA de conteúdo. Você descobriu as fontes disponíveis e as pesquisou em linguagem natural, com pesquisa de palavra-chave, semântica, híbrida e linguagem natural. Você também descobriu que este servidor pesquisa somente fontes públicas por meio de uma chave de API e como reduzir o tamanho da resposta com a seleção de campo. Você pode usar a mesma abordagem simples do CX Coworker para pesquisar e analisar fontes de IA de conteúdo sem alternar para uma interface do usuário ou gravar o código de API de pesquisa de baixo nível.

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