Documentazione AEM Tutorial su AEM as a Cloud Service

Ricerca e analisi di contenuti AEM con linguaggio naturale

Ultimo aggiornamento: 23 settembre 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) di Adobe CX Coworker per cercare e analizzare le origini di IA per la gestione dei contenuti in linguaggio naturale, senza scrivere codice API di basso livello o esplorare l’interfaccia utente.

In questo tutorial individua le origini disponibili, esegui ricerche per parole chiave, semantiche e ibride e utilizza ricerche in linguaggio naturale per esprimere intenti complessi, il tutto da Adobe CX Coworker rispetto a un’origine di 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_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 è public-source-only: l’intestazione X-Api-Key concede l’accesso all’origine. È necessaria una chiave API; una richiesta senza di essa viene rifiutata.

IMPORTANT

Qualsiasi identità Adobe o token Bearer OAuth/IMS connesso utilizzato per autenticare la sessione MCP è mai inoltrato a IA per la gestione dei contenuti e non ha alcun effetto sulle origini in cui è possibile eseguire ricerche. Solo le origini pubbliche di sola lettura possono essere cercate tramite questo server, indipendentemente dagli altri diritti dell'identità di accesso.

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 Collaborator con questi passaggi.

Accedere a Adobe CX CoWorker.

{modal="regular"}
Dalla barra laterale, fare clic su Server MCP.

{modal="regular"}
Fare clic su Aggiungi server MCP.

{modal="regular"}

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. Questa identità non viene utilizzata per l'accesso all'origine di IA per la gestione dei contenuti (consulta Strumenti e accesso), pertanto non è necessario un passaggio di accesso o OAuth separato per la ricerca stessa.

Fai clic su Aggiungi intestazioni e aggiungi:

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
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.

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

{modal="regular"}
Fare clic su Nuova chat per iniziare a utilizzare il server MCP di IA per la gestione dei contenuti.

{modal="regular"}

Ricerca in origini pubbliche

Le origini di IA per la gestione dei contenuti esposte tramite questo server sono pubbliche: di sola lettura e destinate a contenuto non sensibile e disponibile. Chiunque abbia una chiave API valida 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.

Con il server connesso come descritto in Aggiungere il server MCP di IA per l’analisi dei contenuti, individuare e cercare le origini direttamente dalla chat.

In CX Coworker, apri una nuova chat ed elenca le sorgenti disponibili per la tua chiave API:

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

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

Congratulazioni.

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 IA per la gestione dei contenuti. Hai scoperto le fonti disponibili e le hai cercate nel linguaggio naturale, con parole chiave, semantica, ibrida e ricerca nel linguaggio naturale. Hai anche appreso che questo server esegue ricerche in origini pubbliche tramite una chiave API e come ridurre le dimensioni della risposta con la selezione del campo. Puoi utilizzare lo stesso semplice approccio di CX Coworker per cercare e analizzare le origini di IA per la gestione dei contenuti senza passare a un’interfaccia utente o scrivere un codice API di ricerca di basso livello.

recommendation-more-help

experience-manager-learn-help-cloud-service