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:
list_content_sourcesget_content_source_configfulltext_searchsemantic_searchhybrid_searchgen_searchDer 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.
-
Melden Sie sich bei einem Kollegen an.
{modal="regular"}
-
Klicken Sie in der Seitenleiste auf MCP-Server.
{modal="regular"}
-
Klicken Sie MCP-Server hinzufügen.
{modal="regular"}
-
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-mcpMCP-URL https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-aiVerbindungstyp HTTPAuthentifizierungstyp Passthrough {modal="regular"}
note NOTE Authentifizierungstyp ist auf Passthroughfestgelegt, sodass Coworker Ihre angemeldete Adobe-Identität an den MCP-Server weiterleitet. Sie benötigen keinen separaten Anmelde- oder OAuth-Schritt. -
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-KeyIhr ö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-KeyIhr 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 Siex-content-ai-mcp-api-key(nichtX-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 (tierundbucket) im Chat und versucht es dann automatisch erneut.natural_language_searchbenötigt mehr als die anderen fünf Tools: Es erfordertclusterundnamespacebeim Routing, zusätzlich zutierundbucket. Wenn einer der Werte fehlt, gibt das Tool einenmissing_nls_routingFehler zurück — antwortet mit den fehlenden Werten und der Server versucht es automatisch erneut. -
Klicken Sie auf Hinzufügen. Der content-ai-mcp-Server wird jetzt in der Liste der MCP-Server angezeigt.
{modal="regular"}
-
Klicken Sie auf Neuer Chat, um den Content AI MCP Server zu verwenden.
{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:
X-Api-Keyx-content-ai-mcp-routingtier=publish,bucket=p12345-e67890.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.
-
Ö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.