Suchen und Analysieren von AEM-Inhalten in natürlicher Sprache

Verwenden Sie den Content AI MCP Server, eine Ergänzung zum AEM MCP Server von Adobe CX Enterprise Coworker, um Content AI-Inhaltsquellen in natürlicher Sprache, ohne API-Code auf niedriger Ebene oder Benutzeroberflächennavigation zu durchsuchen und zu analysieren.

In diesem Tutorial Sie verfügbare Inhaltsquellen, führen Keyword-, semantische- und Hybrid-Suchen aus und verwenden generative Suche, um eine zusammengesetzte Antwort zu erhalten, die alle von Coworker aus einer Content-KI-Inhaltsquelle stammen.

Tools und Zugriff

Der Content AI MCP Server bietet sechs Tools:

Tool
Zweck
list_content_sources
Entdecken Sie verfügbare Inhaltsquellen in Ihrer AEM-Umgebung.
get_content_source_config
Überprüfen Sie die Konfiguration der Rohinhaltsquelle und die Metadaten.
fulltext_search
Keyword-basierte Suche mit Fuzzy Matching und Feldauswahl.
semantic_search
Vektorbasierte Ähnlichkeitssuche für konzeptionelle Abfragen.
hybrid_search
Kombinierte Keyword- und semantische Suche für den besten Allzweck-Recall.
gen_search
Generieren Sie aus übereinstimmenden Inhalten eine synthetische Antwort, anstatt Rohdokumente zurückzugeben.

Der Content AI-MCP-Server ist nur öffentliche Quelle: Der X-Api-Key-Header gewährt Quellzugriff. Ein API-Schlüssel ist erforderlich. Eine Anfrage ohne ihn wird abgelehnt.

  • Öffentlich (anonym): Suchen Sie mithilfe des X-Api-Key-Headers nach öffentlichen, schreibgeschützten Inhaltsquellen. Verwenden Sie diese Option für offen verfügbare, nicht vertrauliche Inhalte. Siehe Suchen nach öffentlichen Inhaltsquellen.
  • Authentifiziert: Suchen Sie mithilfe des x-content-ai-mcp-api-key-Headers und Ihrer angemeldeten Adobe-Identität nach berechtigten oder zugriffsgesteuerten Inhaltsquellen (durch CX Coworker übergeben). Die Ergebnisse berücksichtigen Ihre Berechtigungen.

Hinzufügen des Content AI MCP-Servers

Verbinden Sie Adobe CX Enterprise Coworker mit dem Content AI MCP-Server und führen Sie das folgende Szenario aus.

Mit diesen Schritten richten wir den Content AI-MCP-Server in Coworker ein.

  1. Melden Sie sich bei einem Kollegen an.

    Adobe CX Coworker-Anmeldung {modal="regular"}

  2. Klicken Sie in der Seitenleiste auf MCP-Server.

    MCP-Server-Seitenleiste {modal="regular"}

  3. Klicken Sie MCP-Server hinzufügen.

    MCP-Server hinzufügen {modal="regular"}

  4. Geben im Dialogfeld MCP-Server hinzufügen“ die folgenden Details ein:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Feld Wert
    Server-Name content-ai-mcp
    MCP-URL https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai
    Verbindungstyp HTTP
    Authentifizierungstyp Passthrough

    Dialogfeld „MCP-Server hinzufügen“ {modal="regular"}

    note
    NOTE
    Authentifizierungstyp ist auf Passthrough festgelegt, sodass Coworker Ihre angemeldete Adobe-Identität an den MCP-Server weiterleitet. Sie benötigen keinen separaten Anmelde- oder OAuth-Schritt.
  5. Klicken Sie Kopfzeilen hinzufügen und fügen Sie die Kopfzeilen für den benötigten Zugriffsmodus hinzu:

    Für öffentliche Inhaltsquellen (anonym):

    table 0-row-2 1-row-2 2-row-2
    Kopfzeile Wert
    X-Api-Key Ihr öffentlicher API-Schlüssel. Zeigen Sie diese Kopfzeile an, wenn Sie nur nach öffentlichen Inhaltsquellen suchen möchten.
    x-content-ai-mcp-routing (Optional) Umgebung/Routing-Informationen, z. B. tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.

    Für nicht öffentliche (berechtigte) Inhaltsquellen:

    table 0-row-2 1-row-2 2-row-2
    Kopfzeile Wert
    X-Api-Key Ihr Content-API-Schlüssel. Erforderlich - Suchvorgänge werden ohne zurückgewiesen.
    x-content-ai-mcp-routing (Optional) Umgebung/Routing-Informationen, z. B. tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.
    note important
    IMPORTANT
    Wenn der X-Api-Key-Header vorhanden ist, behandelt der Server die Anfrage als anonym und sucht nur öffentliche Inhaltsquellen. Jede angemeldete Identität wird ignoriert, sodass es keine versehentliche Eskalation zum authentifizierten Zugriff gibt. Verwenden Sie x-content-ai-mcp-api-key (nicht X-Api-Key), wenn Sie nach Inhaltsquellen mit Titeln suchen möchten.
    note
    NOTE
    Wenn Sie den x-content-ai-mcp-routing-Header nicht festlegen, fragt der Server beim ersten Ausführen eines Tools nach Ihrer Umgebung (tier und bucket) im Chat und versucht es dann automatisch erneut.
    natural_language_search benötigt mehr als die anderen fünf Tools: Es erfordert cluster und namespace beim Routing, zusätzlich zu tier und bucket. Wenn einer der Werte fehlt, gibt das Tool einen missing_nls_routing Fehler zurück — antwortet mit den fehlenden Werten und der Server versucht es automatisch erneut.
  6. Klicken Sie auf Hinzufügen. Der content-ai-mcp-Server wird jetzt in der Liste der MCP-Server angezeigt.

    Content AI-MCP-Server aufgelistet {modal="regular"}

  7. Klicken Sie auf Neuer Chat, um den Content AI MCP Server zu verwenden.

    Neuer Chat {modal="regular"}

Suchen nach öffentlichen Inhaltsquellen

Einige Content-KI-Inhaltsquellen sind als öffentlich gekennzeichnet und können anonym ohne berechtigte Identität durchsucht werden. Öffentliche Inhaltsquellen sind schreibgeschützt und für offen verfügbare, nicht vertrauliche Inhalte vorgesehen. Jeder Benutzer mit dem öffentlichen API-Schlüssel kann danach suchen.

Verwenden Sie diesen Server, wenn:

  • Sie möchten offen verfügbare Inhalte durchsuchen (z. B. öffentliche Dokumentation oder einen Demokatalog).
  • Sie benötigen keine Ergebnisse für einzelne Benutzer bzw. für einzelne Berechtigungen.
  • Sie möchten eine einfache Einrichtung, für die nur ein API-Schlüssel erforderlich ist.

Um öffentliche Inhaltsquellen zu durchsuchen, fügen Sie den MCP-Server für die Inhalts-KI in Coworker genau wie in Hinzufügen des MCP-Servers für die Inhalts-KI beschrieben hinzu, fügen Sie jedoch im Schritt Kopfzeilen hinzufügen nur den X-Api-Key-Header (plus einen optionalen x-content-ai-mcp-routing für die Umgebung) hinzu:

Kopfzeile
Wert
X-Api-Key
Ihr öffentlicher API-Schlüssel.
x-content-ai-mcp-routing
(Optional) Umgebung/Routing-Informationen, z. B. tier=publish,bucket=p12345-e67890.
IMPORTANT
Wenn der X-Api-Key-Header vorhanden ist, behandelt der Server die Anfrage als anonym und sucht nur öffentliche Inhaltsquellen. Jede angemeldete Identität wird ignoriert. Verwenden Sie X-Api-Key nicht, wenn Sie nach Inhaltsquellen mit dem Titel suchen möchten, sondern verwenden Sie stattdessen x-content-ai-mcp-api-key.

Wenn der Server verbunden ist, finden und durchsuchen Sie öffentliche Inhaltsquellen auf die gleiche Weise wie authentifizierte Inhaltsquellen.

  1. Öffnen Sie in der -Arbeitskollegin einen neuen Chat und listen Sie die öffentlichen Inhaltsquellen auf, die für Ihren API-Schlüssel verfügbar sind:

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

    Der Server sucht nur öffentliche Inhaltsquellen für diese Anfrage und gibt übereinstimmende Ergebnisse zurück.

    Der Server gibt die öffentlichen Quellen zurück, die mit Ihrem Routing/Ihrer Umgebung übereinstimmen.

Sie haben den Content AI MCP Server in Coworker eingerichtet und ihn verwendet, um Content AI-Inhaltsquellen zu durchsuchen. Sie haben verfügbare Inhaltsquellen entdeckt und sie in natürlicher Sprache mit Keyword-, semantischer, hybrider und generativer Suche durchsucht. Außerdem haben Sie gelernt, wie Sie öffentliche Inhaltsquellen anonym mit einem API-Schlüssel suchen und die Antwortgröße durch die Feldauswahl reduzieren können. Sie können den gleichen am Menschen orientierten Fluss von einem Kollegen verwenden, um Content-KI-Inhaltsquellen zu suchen und zu analysieren, ohne zu einer Benutzeroberfläche zu wechseln oder API-Code für die Suche auf niedriger Ebene zu schreiben.

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