[Nur SaaS]{class="badge positive" title="Gilt nur für Adobe Commerce as a Cloud Service- und Adobe Commerce Optimizer-Projekte (von Adobe verwaltete SaaS-Infrastruktur)."}

Dokumentations-RAG-Service (Beta)

Der Dokumentations-RAG-Service (Retrieval-Augmented Generation) bietet KI-gestützte semantische Suchfunktionen für die entsprechende Dokumentation zu Adobe Commerce und App Builder.

Dieses ARG bietet eine IDE-Oberfläche für Fragen zu Adobe Commerce und kann Sie bei Best Practices für die Entwicklung von Anwendungen und anderen Migrationsaufgaben beraten.

Der RAG-Service ist Teil des MCP-Servers (Model Context Protocol) ​ ​Commerce-Erweiterungstools, der mit Cursor und anderen MCP-kompatiblen KI-Assistenten integriert wird.

Verfügbare Dokumentation

In der folgenden Tabelle wird beschrieben, welche Dokumentation derzeit vom RAG-Service indiziert wird, und welche Keywords Sie verwenden können, um den zugehörigen Trigger zu durchsuchen. Die enthaltene Dokumentation wird mit der Entwicklung des RAG-Service weiter erweitert.

Weitere Informationen zur Indexauswahl finden Sie unter Automatische Indexauswahl und Explizite Indexauswahl.

Ausführliche Informationen zur Dokumentation, die in den einzelnen Indizes enthalten ist, finden Sie in der Liste der aufgenommenen Quellen.

Sicherheit und Datenschutz

Der Produktions-Endpunkt ist durch Azure Front Door geschützt, die die folgenden Schutzmaßnahmen umfasst:

Für verschiedene Sicherheitsanforderungen können Sie einen benutzerdefinierten Endpunkt verwenden. Weitere Informationen ​ Sie unter ​-Endpunkt für benutzerdefinierte Fronttüren .

Voraussetzungen

Stellen Sie vor der Installation Folgendes sicher:

Installation

Nutzung

Nach der Installation können Sie die Indizes () ​ explizit aufrufen. Sie können auch den Befehl /search-commerce-docs verwenden.

Automatische Indexauswahl (empfohlen)

Indem Sie Fragen in natürlicher Sprache zu Ihrem Commerce-Projekt stellen, durchsucht das Tool automatisch den entsprechenden Dokumentationsindex und stellt relevante Informationen bereit:

Die folgende Eingabeaufforderung wählt automatisch den commerce-storefront-docs aus:

"How do I use Edge Delivery Services drop-ins for product listing?"

Die folgende Eingabeaufforderung wählt automatisch den commerce-extensibility-docs aus:

"How do I create a webhook in Adobe Commerce?"

Die folgende Eingabeaufforderung wählt automatisch den commerce-core-docs aus:

"How to configure product catalog settings?"

Die folgende Eingabeaufforderung wählt automatisch den app-builder-docs aus:

"What are App Builder runtime action best practices?"

Explizite Indexauswahl

Sie können auch den Index angeben, den Sie in der Eingabeaufforderung verwenden möchten.

Search commerce-storefront-docs for authentication drop-in

Using app-builder-docs, how do I deploy runtime actions?

Befehlsbasierte Suche

Wenn Sie sicherstellen möchten, dass der RAG-Service verwendet wird, können Sie den /search-commerce-docs Cursor-Befehl manuell aufrufen, um die Dokumentation an Ihrer Eingabeaufforderung zu durchsuchen:

/search-commerce-docs "How do I subscribe to Commerce events?"

Benutzerdefinierter Endpunkt der Fronttür

Standardmäßig verwendet die Dokumentationssuche den Produktions-Endpunkt Azure Front Door mit WAF-Schutz. Zu Test- oder Entwicklungszwecken können Sie dies mit der Umgebungsvariablen FRONT_DOOR_URL überschreiben.

Um einen benutzerdefinierten Endpunkt zu verwenden, fügen Sie ihn Ihrer Cursor-MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "commerce-extensibility-tools": {
      "command": "node",
      "args": ["/<your-project-directory>/commerce-extensibility-tools/index.js"],
      "env": {
        "NODE_ENV": "production",
        "FRONT_DOOR_URL": "https://<custom-endpoint>.azurefd.net"
      }
    }
  }
}

Fehlerbehebung

In den folgenden Abschnitten finden Sie Tipps zur Fehlerbehebung bei häufigen Problemen, die bei der Verwendung des Dokumentations-RAG-Service auftreten können.

Authentifizierungsfehler

Das Dokumentationssuch-Tool erfordert die Adobe IMS-Authentifizierung. Wenn Authentifizierungsfehler auftreten, führen Sie die folgenden Schritte aus, um das Problem zu beheben.

MCP-Server wird nicht geladen

Wenn der MCP-Server keine Verbindung herstellt oder Ihr Agent sagt, dass er keine Verbindung zum RAG herstellen kann, führen Sie die folgenden Schritte aus, um das Problem zu beheben.

Tool nicht gefunden

Pfadprobleme (Windows)

Verwenden Sie unter Windows Schrägstriche / oder umgekehrte Schrägstriche mit Escape-Zeichen \\:

{
  "args": ["C:/Users/yourname/projects/commerce-extensibility-tools/index.js"]
}

{
  "args": ["C:\\Users\\yourname\\projects\\commerce-extensibility-tools\\index.js"]
}

Zusätzliche Ressourcen