Buscar y analizar contenido de AEM con lenguaje natural

Use Content AI MCP Server, un complemento de AEM MCP Server, de Adobe CX Coworker para buscar y analizar las fuentes de contenido de Content AI en lenguaje natural, sin código de API de bajo nivel ni navegación por la interfaz de usuario.

En este tutorial, descubrirá fuentes de contenido disponibles, ejecutará las búsquedas de keyword, semantic e hybrid, y usará la búsqueda generative search para obtener una respuesta sintetizada, todo desde Adobe CX Coworker con una fuente de contenido de inteligencia artificial aplicada al contenido.

Herramientas y acceso

El servidor MCP de Content AI proporciona seis herramientas:

Herramienta
Función
list_content_sources
Descubra las fuentes de contenido disponibles en su entorno de AEM.
get_content_source_config
Inspeccione la configuración y los metadatos del origen de contenido sin procesar.
fulltext_search
Búsqueda basada en palabras clave con coincidencia aproximada y selección de campos.
semantic_search
Búsqueda de similitudes basada en vectores para consultas conceptuales.
hybrid_search
Palabra clave combinada + búsqueda semántica para el mejor recuerdo de uso general.
gen_search
Genere una respuesta sintetizada a partir de contenido coincidente, en lugar de devolver documentos sin procesar.

El servidor MCP de inteligencia artificial aplicada al contenido es solo de origen público: el encabezado X-Api-Key concede acceso al origen. Se requiere una clave de API y se rechaza una solicitud sin ella.

  • Público (anónimo): busque orígenes de contenido públicos y de solo lectura usando el encabezado X-Api-Key. Utilice esto para contenido no confidencial y abiertamente disponible. Consulte Búsqueda de fuentes de contenido público.
  • Autenticado: busque fuentes de contenido con derecho o de acceso controlado usando el encabezado x-content-ai-mcp-api-key junto con su identidad de Adobe iniciada (pasada a través de CX Coworker). Los resultados respetan sus permisos.

Añadir el servidor MCP de la inteligencia artificial aplicada al contenido

Conecte Adobe CX Coworker al servidor MCP de inteligencia artificial aplicada al contenido y ejecute el siguiente escenario.

Vamos a configurar el servidor MCP de inteligencia artificial aplicada al contenido en Adobe CX Coworker siguiendo estos pasos.

  1. Inicie sesión en Adobe CX Coworker.

    Inicio de sesión en Adobe CX Coworker {modal="regular"}

  2. En el carril lateral, haga clic en Servidores MCP.

    Carril lateral del servidor MCP {modal="regular"}

  3. Haga clic en Agregar servidor MCP.

    Agregar servidor MCP {modal="regular"}

  4. En el cuadro de diálogo Agregar servidor MCP, escriba los siguientes detalles:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Campo Valor
    Nombre de servidor content-ai-mcp
    URL de MCP https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai
    Tipo de conexión HTTP
    Tipo de autenticación Passthrough

    Cuadro de diálogo Agregar servidor MCP {modal="regular"}

    note
    NOTE
    El tipo de autenticación está establecido en Passthrough, por lo que CX Coworker reenvía su identidad de Adobe con sesión iniciada al servidor MCP. No necesita un inicio de sesión o un paso de OAuth independiente.
  5. Haga clic en Agregar encabezados y agregue los encabezados para el modo de acceso que necesita:

    Para orígenes de contenido público (anónimos):

    table 0-row-2 1-row-2 2-row-2
    Encabezado Value
    X-Api-Key Su clave API pública. Presente este encabezado cuando solo desee buscar fuentes de contenido públicas.
    x-content-ai-mcp-routing (Opcional) Información de entorno/enrutamiento, por ejemplo tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.

    Para orígenes de contenido no públicos (con derecho):

    table 0-row-2 1-row-2 2-row-2
    Encabezado Value
    X-Api-Key Su clave de API de inteligencia artificial aplicada al contenido. Obligatorio: las búsquedas se rechazan sin él.
    x-content-ai-mcp-routing (Opcional) Información de entorno/enrutamiento, por ejemplo tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.
    note important
    IMPORTANT
    Cuando el encabezado X-Api-Key está presente, el servidor trata la solicitud como anónima y solo busca orígenes de contenido público. Se ignora cualquier identidad iniciada, por lo que no hay escalación accidental al acceso autenticado. Use x-content-ai-mcp-api-key (no X-Api-Key) cuando quiera buscar orígenes de contenido con derechos.
    note
    NOTE
    Si no establece el encabezado x-content-ai-mcp-routing, el servidor solicitará el entorno (tier y bucket) en el chat la primera vez que ejecute una herramienta y, a continuación, volverá a intentarlo automáticamente.
    natural_language_search necesita más que las otras cinco herramientas: requiere cluster y namespace en el enrutamiento, además de tier y bucket. Si falta alguno de los dos, la herramienta devuelve un error missing_nls_routing: responda con los valores que faltan y el servidor reintentará automáticamente.
  6. Haga clic en Agregar. El servidor content-ai-mcp aparece ahora en su lista de servidores MCP.

    Servidor MCP de inteligencia artificial aplicada al contenido enumerado {modal="regular"}

  7. Haga clic en Nuevo chat para empezar a usar el servidor MCP de inteligencia artificial aplicada al contenido.

    Nuevo chat {modal="regular"}

Búsqueda de fuentes de contenido público

Algunas fuentes de contenido de inteligencia artificial aplicada al contenido están marcadas como públicas y se pueden buscar de forma anónima, sin una identidad con derecho. Las fuentes de contenido públicas son de solo lectura y están pensadas para contenido no confidencial disponible abiertamente. Cualquier persona con la clave API pública puede buscarlos.

Utilice este servidor cuando:

  • Desea buscar contenido disponible abiertamente (por ejemplo, documentación pública o un catálogo de demostración).
  • No necesita resultados con ámbito de permisos de cada usuario.
  • Desea una configuración sencilla que solo requiera una clave de API.

Para buscar fuentes de contenido públicas, agregue Content AI MCP Server en CX Coworker exactamente como se describe en Agregar Content AI MCP Server, pero en el paso Agregar encabezados agregue solo el encabezado X-Api-Key (además de un encabezado x-content-ai-mcp-routing opcional para el entorno):

Encabezado
Value
X-Api-Key
Su clave API pública.
x-content-ai-mcp-routing
(Opcional) Información de entorno/enrutamiento, por ejemplo tier=publish,bucket=p12345-e67890.
IMPORTANT
Cuando el encabezado X-Api-Key está presente, el servidor trata la solicitud como anónima y solo busca orígenes de contenido público. Se ignorará cualquier identidad con sesión iniciada. No use X-Api-Key cuando quiera buscar orígenes de contenido con derechos, use x-content-ai-mcp-api-key.

Con el servidor conectado, descubra y busque fuentes de contenido públicas del mismo modo que las fuentes de contenido autenticadas.

  1. En CX Coworker, abra un nuevo chat y enumere las fuentes de contenido público disponibles para su clave de API:

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

    El servidor solo busca fuentes de contenido público para esta solicitud y devuelve resultados coincidentes.

    El servidor devuelve los orígenes públicos que coinciden con el entorno o el enrutamiento.

Ha configurado el servidor MCP de inteligencia artificial aplicada al contenido en Adobe CX Coworker y lo ha utilizado para buscar fuentes de contenido de inteligencia artificial aplicada al contenido. Ha descubierto fuentes de contenido disponibles y las ha buscado en lenguaje natural, con búsqueda de palabras clave, semántica, híbrida y generativa. También aprendió a buscar fuentes de contenido público de forma anónima con una clave de API y a reducir el tamaño de la respuesta al seleccionar los campos. Puede utilizar el mismo flujo centrado en las personas desde CX Coworker para buscar y analizar fuentes de contenido de inteligencia artificial aplicada al contenido sin cambiar a una interfaz de usuario ni escribir un código de API de búsqueda de bajo nivel.

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