DocumentazioneAEMTutorial su AEM as a Cloud Service

Cercare contenuti AEM utilizzando il server MCP di IA per la gestione dei contenuti

Ultimo aggiornamento: 23 luglio 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 di Adobe CX Coworker per cercare e analizzare gli indici di IA per la gestione dei contenuti in linguaggio naturale, senza codice API di basso livello o navigazione nell’interfaccia utente.

In questa esercitazione individua indici disponibili, esegui ricerche per parole chiave, semantiche e ricerche ibride e utilizza ricerche in linguaggio naturale per esprimere intenti complessi, il tutto da Adobe CX Coworker rispetto a un indice di IA per la gestione dei contenuti.

Panoramica

AEM as a Cloud Service fornisce Server MCP per consentire all’app IDE o di chat di funzionare con AEM in modo sicuro. Il server MCP di IA per la gestione dei contenuti espone gli strumenti di ricerca e individuazione sugli indici di IA per la gestione dei contenuti. Per ulteriori informazioni, vedere Server MCP in AEM.

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

Strumento
Scopo
list_indexes
Scopri gli indici disponibili nell’ambiente AEM.
get_index_config
Esamina la configurazione dell’indice 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.
natural_language_search
Esprimi l’intento in un inglese semplice; il server lo traduce in filtri strutturati, intervalli e semantica.

Il server MCP di IA per la gestione dei contenuti supporta due modalità di accesso, selezionate dall’intestazione configurata:

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

Come Possono Utilizzarlo Gli Sviluppatori

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

Configurazione - Server MCP di IA per la gestione dei contenuti in Adobe CX Collaborator

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

  1. Accedere a Adobe CX CoWorker.

    Accesso a Adobe CX Coworker

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

    Barra laterale server MCP

  3. Fare clic su Aggiungi server MCP.

    Aggiungi server MCP

  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

    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 gli indici pubblici (anonimi):

    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 gli indici pubblici.
    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 indici non pubblici (autorizzati):

    table 0-row-2 1-row-2 2-row-2
    Intestazione Valore
    x-content-ai-mcp-api-key Chiave API da Adobe Developer Console.
    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 negli indici pubblici. 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 negli indici autorizzati.
    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.

  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

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

    Nuova chat

Ricerca di indici pubblici

Alcuni indici IA per la gestione dei contenuti sono contrassegnati come pubblici e possono essere cercati in modo anonimo senza un’identità autorizzata. Gli indici pubblici sono di sola lettura e sono destinati a contenuti aperti e non sensibili. Chiunque disponga della chiave API pubblica può effettuare ricerche.

Utilizza questa modalità 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 negli indici pubblici, aggiungi il server MCP di IA per l’analisi dei contenuti in CX Coworker esattamente come descritto in Configurazione - Server MCP di IA per l’analisi dei contenuti in Adobe CX Coworker, ma nel passaggio Aggiungi intestazioni aggiungi 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 negli indici pubblici. Qualsiasi identità di accesso viene ignorata. Non utilizzare X-Api-Key quando si intende effettuare una ricerca negli indici autorizzati, utilizzare invece x-content-ai-mcp-api-key.

Con il server connesso, individuare ed eseguire ricerche negli indici pubblici allo stesso modo degli indici autenticati.

  1. In CX Collaborator, apri una nuova chat ed elenca gli indici pubblici disponibili per la tua chiave API:

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

    Il server cerca solo gli indici pubblici per questa richiesta e restituisce i risultati corrispondenti.

Il server MCP di AEM Content AI è stato configurato in Adobe CX Collaborator e utilizzato per eseguire ricerche negli indici di IA per la gestione dei contenuti. Hai scoperto gli indici disponibili e li hai cercati nel linguaggio naturale, utilizzando parole chiave, semantica, ibrida e ricerca nel linguaggio naturale. Hai anche imparato a cercare indici pubblici in modo anonimo con una chiave API e a ridurre la dimensione della risposta con la selezione del campo. Puoi utilizzare lo stesso flusso incentrato sull’uomo da CX Coworker per cercare e analizzare gli indici di IA per la gestione 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