Recherche et analyse de contenu AEM en langage naturel

Utilisez le serveur de MCP IA dédiée au contenu, qui accompagne le serveur de MCP AEM, depuis Adobe CX Enterprise Coworker pour rechercher et analyser les sources de contenu IA dédiée au contenu en langage naturel, sans code d’API de bas niveau ni navigation dans l’interface utilisateur.

Dans ce tutoriel, vous découvrez les sources de contenu disponibles, exécutez des recherches par mot-clé, sémantiques et hybrides et utilisez recherche générative pour obtenir une réponse synthétisée, le tout à partir de Coworker par rapport à une source de contenu Content AI.

Outils et accès

Le serveur MCP IA dédiée au contenu propose six outils :

Outil
Objectif
list_content_sources
Découvrez les sources de contenu disponibles dans votre environnement AEM.
get_content_source_config
Inspectez la configuration et les métadonnées de la source de contenu brut.
fulltext_search
Recherche par mot-clé avec correspondance approximative et sélection de champ.
semantic_search
Recherche par analogie vectorielle de requêtes conceptuelles.
hybrid_search
Mot-clé combiné + recherche sémantique pour le meilleur rappel d’usage général.
gen_search
Générez une réponse synthétisée à partir du contenu correspondant, au lieu de renvoyer des documents bruts.

Le serveur MCP IA dédiée au contenu est public-source-uniquement : l’en-tête X-Api-Key accorde l’accès à la source. Une clé API est requise ; une requête sans clé API est rejetée.

  • Public (anonyme) : recherchez des sources de contenu publiques et en lecture seule à l’aide de l’en-tête X-Api-Key. Utilisez cette option pour le contenu non sensible et disponible ouvertement. Voir Recherche de sources de contenu publiques.
  • Authentifié : recherchez des sources de contenu dont l’accès est contrôlé ou autorisé à l’aide de l’en-tête x-content-ai-mcp-api-key avec votre identité Adobe connectée (transmise par CX Coworker). Les résultats respectent vos autorisations.

Ajouter le serveur MCP IA dédiée au contenu

Connectez 🔗 au serveur MCP IA dédiée au contenu et exécutez le scénario ci-dessous.

Configurez le serveur MCP IA dédiée au contenu dans Coworker selon ces étapes.

  1. Connectez-vous à un collègue.

    Connexion à Adobe CX Coworker {modal="regular"}

  2. Dans le rail latéral, cliquez sur Serveurs MCP.

    ​ Rail latéral des serveurs MCP ​ {modal="regular"}

  3. Cliquez sur Ajouter un serveur MCP.

    Ajouter un serveur MCP {modal="regular"}

  4. Dans la boîte de dialogue Ajouter un serveur MCP, saisissez les informations suivantes :

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Champ Valeur
    Nom du serveur content-ai-mcp
    URL MCP https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai
    Type de connexion HTTP
    Type d’authentification Passthrough

    ​ Boîte de dialogue Ajouter un serveur MCP ​ {modal="regular"}

    note
    NOTE
    Le type d’authentification est défini sur Passthrough afin que Coworker transfère votre identité Adobe connectée au serveur MCP. Vous n’avez pas besoin d’une connexion distincte ni d’une étape OAuth.
  5. Cliquez sur Ajouter des en-têtes et ajoutez les en-têtes pour le mode d’accès dont vous avez besoin :

    Pour les sources de contenu public (anonyme) :

    table 0-row-2 1-row-2 2-row-2
    En-tête Valeur
    X-Api-Key Votre clé API publique. Présentez cet en-tête lorsque vous souhaitez uniquement rechercher des sources de contenu publiques.
    x-content-ai-mcp-routing (Facultatif) Informations sur l’environnement/le routage, par exemple tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.

    Pour les sources de contenu non publiques (autorisées) :

    table 0-row-2 1-row-2 2-row-2
    En-tête Valeur
    X-Api-Key Votre clé API IA dédiée au contenu. Obligatoire — Les recherches sont rejetées sans cela.
    x-content-ai-mcp-routing (Facultatif) Informations sur l’environnement/le routage, par exemple tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.
    note important
    IMPORTANT
    Lorsque l’en-tête X-Api-Key est présent, le serveur traite la requête comme anonyme et ne recherche que les sources de contenu publiques. Toute identité de connexion est ignorée, il n’y a donc aucune réaffectation accidentelle vers l’accès authentifié. Utilisez x-content-ai-mcp-api-key (non X-Api-Key) lorsque vous avez l’intention de rechercher des sources de contenu autorisées.
    note
    NOTE
    Si vous ne définissez pas l’en-tête x-content-ai-mcp-routing, le serveur demande votre environnement (tier et bucket) dans le chat la première fois que vous exécutez un outil, puis réessaie automatiquement.
    natural_language_search a besoin de plus que les cinq autres outils : il nécessite cluster et namespace dans le routage, en plus de tier et de bucket. Si l’une d’elles est manquante, l’outil renvoie une erreur missing_nls_routing — répondez avec la ou les valeurs manquantes et le serveur réessaye automatiquement.
  6. Cliquez sur Ajouter. Le serveur content-ai-mcp apparaît désormais dans la liste des serveurs MCP.

    Content AI MCP Server répertorié {modal="regular"}

  7. Cliquez sur Nouvelle conversation pour commencer à utiliser le serveur MCP IA dédiée au contenu.

    Nouvelle conversation {modal="regular"}

Recherche de sources de contenu publiques

Certaines sources de contenu de l’IA dédiée au contenu sont marquées publiques et peuvent faire l’objet de recherches anonymes, sans identité autorisée. Les sources de contenu public sont en lecture seule et sont destinées à un contenu ouvert et non sensible. Toute personne disposant de la clé API publique peut effectuer une recherche.

Utilisez ce serveur lorsque :

  • Vous souhaitez rechercher du contenu ouvert disponible (par exemple, de la documentation publique ou un catalogue de démonstration).
  • Vous n’avez pas besoin de résultats par utilisateur avec une étendue d’autorisation.
  • Vous avez besoin d’une configuration simple qui ne nécessite qu’une clé API.

Pour rechercher des sources de contenu publiques, ajoutez le serveur MCP IA dédiée au contenu dans Coworker, exactement comme décrit dans Ajouter le serveur MCP IA dédiée au contenu, mais à l’étape Ajouter des en-têtes ajoutez uniquement l’en-tête X-Api-Key (plus un en-tête x-content-ai-mcp-routing facultatif pour l’environnement) :

En-tête
Valeur
X-Api-Key
Votre clé API publique.
x-content-ai-mcp-routing
(Facultatif) Informations sur l’environnement/le routage, par exemple tier=publish,bucket=p12345-e67890.
IMPORTANT
Lorsque l’en-tête X-Api-Key est présent, le serveur traite la requête comme anonyme et ne recherche que les sources de contenu publiques. Toute identité de connexion est ignorée. N’utilisez pas X-Api-Key lorsque vous avez l’intention de rechercher des sources de contenu intitulées, utilisez plutôt x-content-ai-mcp-api-key.

Une fois le serveur connecté, découvrez et recherchez des sources de contenu public de la même manière que les sources de contenu authentifiées.

  1. Dans Coworker, ouvrez une nouvelle conversation et répertoriez les sources de contenu publiques disponibles pour votre clé API :

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

    Le serveur recherche uniquement des sources de contenu publiques pour cette requête et renvoie les résultats correspondants.

    Le serveur renvoie les sources publiques correspondant à votre routage/environnement.

Vous configurez Content AI MCP Server dans Coworker et l’utilisez pour rechercher des sources de contenu Content AI. Vous avez découvert les sources de contenu disponibles et les avez recherchées en langage naturel, avec la recherche par mot-clé, sémantique, hybride et générative. Vous avez également appris à rechercher anonymement des sources de contenu publiques avec une clé API et à réduire la taille de la réponse à l’aide de la sélection de champ. Vous pouvez utiliser le même flux pour des intervenants humains de Coworker pour rechercher et analyser les sources de contenu de l’IA dédiée au contenu sans passer par une interface utilisateur ou écrire du code d’API de recherche de bas niveau.

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