DocumentazioneAEMTutorial su AEM as a Cloud Service

Ricerca e analisi di contenuti AEM con linguaggio naturale

Ultimo aggiornamento: 10 ottobre 2026
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Beginner
  • Leader
  • User
  • Developer

Utilizza il server MCP di IA per la gestione dei contenuti, un componente aggiuntivo del server MCP di AEM, da Adobe CX Coworker per cercare e analizzare le origini di contenuto di IA per la gestione dei contenuti in linguaggio naturale, senza codice API di basso livello o navigazione nell’interfaccia utente.

In questo tutorial individua le origini di contenuto disponibili, esegui ricerche per parole chiave, semantiche e ricerche ibride e utilizza ricerche generative per ottenere una risposta sintetizzata, il tutto da Adobe CX Coworker rispetto a un’origine di contenuto IA per la gestione dei contenuti.

Strumenti e accesso

Il server MCP di IA per la gestione dei contenuti fornisce sei strumenti:

Strumento
Scopo
list_content_sources
Scopri le origini di contenuto disponibili nel tuo ambiente AEM.
get_content_source_config
Esamina la configurazione dell’origine di contenuto non elaborato e i metadati.
fulltext_search
Ricerca basata su parole chiave con corrispondenza fuzzy e selezione dei campi.
semantic_search
Ricerca di similarità basata su vettori per query concettuali.
hybrid_search
Parola chiave combinata + ricerca semantica per il miglior richiamo generico.
gen_search
Genera una risposta sintetizzata dal contenuto corrispondente, invece di restituire documenti non elaborati.

Il server MCP di IA per la gestione dei contenuti è public-source-only: l’intestazione X-Api-Key concede l’accesso all’origine. È necessaria una chiave API; una richiesta senza di essa viene rifiutata.

  • Pubblico (anonimo): cerca in origini di contenuto pubbliche e di sola lettura utilizzando l’intestazione X-Api-Key. Utilizza questa opzione per i contenuti non sensibili e apertamente disponibili. Consulta Ricerca nelle origini di contenuto pubblico.
  • Autenticato: cerca le origini di contenuto con diritto o con controllo di accesso utilizzando l’intestazione x-content-ai-mcp-api-key insieme all’identità Adobe (trasmessa da CX Coworker). I risultati rispettano le tue autorizzazioni.

Aggiungere il server MCP di IA per la gestione dei contenuti

Connetti Adobe CX Coworker al server MCP di IA per la gestione dei contenuti ed esegui lo scenario seguente.

Configuriamo il server MCP di IA per la gestione dei contenuti in Adobe CX Coworker con questi passaggi.

  1. Accedi ad Adobe CX Coworker.

    Accesso ad Adobe CX Coworker {modal="regular"}

  2. Dalla barra laterale, fare clic su Server MCP.

    Barra laterale server MCP {modal="regular"}

  3. Fare clic su Aggiungi server MCP.

    Aggiungi server MCP {modal="regular"}

  4. Nella finestra di dialogo Aggiungi server MCP, immettere i dettagli seguenti:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Campo Valore
    Nome server content-ai-mcp
    URL MCP https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai
    Tipo di connessione HTTP
    Tipo di autenticazione Passthrough

    Finestra di dialogo Aggiungi server MCP {modal="regular"}

    note
    NOTE
    Il tipo di autenticazione è impostato su Passthrough, pertanto CX Coworker inoltra l'identità Adobe di accesso al server MCP. Non è necessario un passaggio di accesso o OAuth separato.

  5. Fai clic su Aggiungi intestazioni e aggiungi le intestazioni per la modalità di accesso necessaria:

    Per origini di contenuto pubblico (anonimo):

    table 0-row-2 1-row-2 2-row-2
    Intestazione Valore
    X-Api-Key Chiave API pubblica. Presenta questa intestazione quando desideri cercare solo le origini di contenuto pubbliche.
    x-content-ai-mcp-routing (Facoltativo) Informazioni ambiente/routing, ad esempio tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.

    Per origini di contenuto non pubbliche (aventi diritto):

    table 0-row-2 1-row-2 2-row-2
    Intestazione Valore
    X-Api-Key Chiave API di IA per la gestione dei contenuti. Obbligatorio - le ricerche vengono rifiutate senza di esso.
    x-content-ai-mcp-routing (Facoltativo) Informazioni ambiente/routing, ad esempio tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.
    note important
    IMPORTANT
    Quando l'intestazione X-Api-Key è presente, il server tratta la richiesta come anonimo e esegue la ricerca solo nelle origini di contenuto pubbliche. Qualsiasi identità di accesso viene ignorata, quindi non si verifica alcuna escalation accidentale all’accesso autenticato. Utilizzare x-content-ai-mcp-api-key (non X-Api-Key) quando si desidera eseguire ricerche nelle origini di contenuto autorizzate.
    note
    NOTE
    Se non si imposta l'intestazione x-content-ai-mcp-routing, il server richiede l'ambiente (tier e bucket) in chat la prima volta che si esegue uno strumento, quindi tenta automaticamente di nuovo.
    natural_language_search ha bisogno di più degli altri cinque strumenti: richiede cluster e namespace nel routing, oltre a tier e bucket. Se manca una delle due, lo strumento restituisce un errore missing_nls_routing. Rispondere con i valori mancanti e il server ritenta automaticamente.

  6. Fai clic su Aggiungi. Il server content-ai-mcp è ora incluso nell’elenco dei server MCP.

    Server MCP di IA per la gestione dei contenuti elencato {modal="regular"}

  7. Fare clic su Nuova chat per iniziare a utilizzare il server MCP di IA per la gestione dei contenuti.

    Nuova chat {modal="regular"}

Ricerca in origini di contenuto pubblico

Alcune origini di contenuto di IA per la gestione dei contenuti sono contrassegnate public e possono essere cercate in modo anonimo senza un’identità autorizzata. Le origini di contenuto pubblico sono di sola lettura e sono destinate a contenuti aperti e non sensibili. Chiunque disponga della chiave API pubblica può effettuare ricerche.

Usa questo server quando:

  • Desideri cercare contenuti disponibili pubblicamente (ad esempio, documentazione pubblica o un catalogo demo).
  • Non sono necessari risultati per utente con ambito di autorizzazione.
  • Desideri una configurazione semplice che richieda solo una chiave API.

Per eseguire ricerche nelle origini di contenuto pubblico, aggiungere il server MCP di IA per l’analisi dei contenuti in CX Coworker esattamente come descritto in Aggiungere il server MCP di IA per l’analisi dei contenuti, ma nel passaggio Aggiungere intestazioni aggiungere solo l’intestazione X-Api-Key (più un’intestazione x-content-ai-mcp-routing facoltativa per l’ambiente):

Intestazione
Valore
X-Api-Key
Chiave API pubblica.
x-content-ai-mcp-routing
(Facoltativo) Informazioni ambiente/routing, ad esempio tier=publish,bucket=p12345-e67890.
IMPORTANT
Quando l'intestazione X-Api-Key è presente, il server tratta la richiesta come anonimo e esegue la ricerca solo nelle origini di contenuto pubbliche. Qualsiasi identità di accesso viene ignorata. Non utilizzare X-Api-Key quando si intende effettuare una ricerca nelle origini di contenuto autorizzate, utilizzare invece x-content-ai-mcp-api-key.

Con il server connesso, individuare ed eseguire ricerche nelle origini di contenuto pubblico allo stesso modo delle origini di contenuto autenticate.

  1. In CX Coworker, apri una nuova chat ed elenca le origini di contenuto pubblico disponibili per la tua chiave API:

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

    Il server cerca solo le origini di contenuto pubblico per questa richiesta e restituisce i risultati corrispondenti.

    Il server restituisce le origini pubbliche corrispondenti all’ambiente di routing/routing.

Hai configurato il server MCP di IA per la gestione dei contenuti in Adobe CX Coworker e lo hai utilizzato per eseguire ricerche nelle origini di contenuto di IA per la gestione dei contenuti. Hai scoperto le origini di contenuto disponibili e le hai cercate nel linguaggio naturale, con parole chiave, semantica, ibrida e ricerca generativa. Hai anche imparato a cercare origini di contenuto pubbliche in modo anonimo con una chiave API e a ridurre le dimensioni della risposta con la selezione dei campi. Puoi utilizzare lo stesso flusso incentrato sull’uomo da CX Coworker per cercare e analizzare le origini di contenuto di IA per l’analisi dei contenuti senza passare a un’interfaccia utente o scrivere codice API di ricerca di basso livello.

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