DocumentaçãoAEMTutoriais do AEM as a Cloud Service

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

Última atualização: 10 de outubro de 2026
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Beginner
  • Leader
  • User
  • Developer

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 de conteúdo da IA de Conteúdo em linguagem natural, sem código de API de baixo nível ou navegação pela interface.

Neste tutorial, você descobre fontes de conteúdo disponíveis, executa pesquisas de palavra-chave, semântica e híbridas e usa a pesquisa gerativa para obter uma resposta sintetizada, tudo do Adobe CX Coworker em relação a uma fonte de conteúdo da IA de conteúdo.

Ferramentas e acesso

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

Ferramenta
Propósito
list_content_sources
Descubra fontes de conteúdo disponíveis em seu ambiente do AEM.
get_content_source_config
Inspecione a configuração e os metadados da fonte de conteúdo 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.
gen_search
Gerar uma resposta sintetizada a partir do conteúdo correspondente, em vez de retornar documentos brutos.

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.

  • Público (anônimo): pesquisa fontes de conteúdo públicas, somente leitura, usando o cabeçalho X-Api-Key. Use-a para conteúdo não confidencial abertamente disponível. Consulte Pesquisa de fontes de conteúdo público.
  • Autenticado: pesquise fontes de conteúdo qualificadas ou controladas por acesso usando o cabeçalho x-content-ai-mcp-api-key junto com sua identidade de Adobe conectada (passada pela CX Coworker). Os resultados respeitam suas permissões.

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
    O Tipo de autenticação está definido como Passthrough, portanto a CX Coworker encaminha sua identidade Adobe de entrada para o Servidor MCP. Você não precisa de uma etapa de logon ou OAuth separada.

  5. Clique em Adicionar cabeçalhos e adicione os cabeçalhos para o modo de acesso necessário:

    Para fontes de conteúdo públicas (anônimas):

    table 0-row-2 1-row-2 2-row-2
    Cabeçalho Valor
    X-Api-Key Sua chave de API pública. Apresente este cabeçalho quando quiser pesquisar apenas em fontes de conteúdo públicas.
    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.

    Para fontes de conteúdo não públicas (autorizadas):

    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 important
    IMPORTANT
    Quando o cabeçalho X-Api-Key está presente, o servidor trata a solicitação como anônima e pesquisa somente fontes de conteúdo públicas. Qualquer identidade conectada é ignorada, portanto, não há escalonamento acidental para o acesso autenticado. Use x-content-ai-mcp-api-key (não X-Api-Key) quando pretender pesquisar fontes de conteúdo autorizadas.
    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"}

Pesquisar fontes de conteúdo públicas

Algumas fontes de conteúdo da IA de conteúdo estão marcadas como públicas e podem ser pesquisadas anonimamente, sem uma identidade qualificada. As fontes de conteúdo público são somente leitura e destinam-se a conteúdo não confidencial abertamente disponível. Qualquer pessoa com a chave de API pública 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.

Para pesquisar fontes de conteúdo públicas, adicione o Servidor MCP de IA de Conteúdo no CX Coworker exatamente como descrito em Adicionar o Servidor MCP de IA de Conteúdo, mas na etapa Adicionar cabeçalhos, adicione apenas o cabeçalho X-Api-Key (além de um cabeçalho x-content-ai-mcp-routing opcional para o ambiente):

Cabeçalho
Valor
X-Api-Key
Sua chave de API pública.
x-content-ai-mcp-routing
(Opcional) Informações de ambiente/roteamento, por exemplo tier=publish,bucket=p12345-e67890.
IMPORTANT
Quando o cabeçalho X-Api-Key está presente, o servidor trata a solicitação como anônima e pesquisa somente fontes de conteúdo públicas. Qualquer identidade conectada é ignorada. Não use X-Api-Key quando pretender pesquisar fontes de conteúdo autorizadas, use x-content-ai-mcp-api-key.

Com o servidor conectado, descubra e pesquise fontes de conteúdo públicas da mesma forma que as fontes de conteúdo autenticadas.

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

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

    O servidor pesquisa apenas fontes de conteúdo públicas para esta solicitação e retorna resultados correspondentes.

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

Você configurou o Servidor MCP da IA de conteúdo no Adobe CX Coworker e o usou para pesquisar fontes de conteúdo da IA de conteúdo. Você descobriu as fontes de conteúdo disponíveis e as pesquisou em linguagem natural, com palavras-chave, semântica, híbrida e pesquisa gerativa. Você também aprendeu a pesquisar fontes de conteúdo público anonimamente com uma chave de API e a reduzir o tamanho da resposta com a seleção de campo. Você pode usar o mesmo fluxo centrado no ser humano do CX Coworker para pesquisar e analisar fontes de conteúdo da IA de conteúdo sem alternar para uma interface do usuário ou gravar um código de API de pesquisa de baixo nível.

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