[SaaS only]{class="badge positive" title="Applies to Adobe Commerce as a Cloud Service and Adobe Commerce Optimizer projects only (Adobe-managed SaaS infrastructure)."}

Documentation RAG service (Beta)

The documentation RAG (Retrieval-Augmented Generation) service provides AI-powered semantic search capabilities across relevant Adobe Commerce and App Builder documentation.

This RAG provides an IDE interface for asking questions about Adobe Commerce and can advise you on best practices for developing applications and other migration tasks.

The RAG service is part of the Commerce extensibility tools MCP (Model Context Protocol) server, which integrates with Cursor and other MCP-compatible AI assistants.

Available documentation

The following table describes what documentation is currently indexed by the RAG service, and the keywords you can use to trigger searching the associated index. The documentation included will continue to expand as we develop the RAG service.

For more information on index selection, refer to Automatic index selection and Explicit index selection.

For detailed information on the documentation included in each index, refer to the ingested source list.

Security and privacy

The production endpoint is protected by Azure Front Door, which includes the following protections:

For different security requirements, you can use a custom endpoint. See Custom Front Door endpoint for more information.

Prerequisites

Before installing, make sure you have:

Installation

Usage

Once installed, you can call the indexes automatically or explicitly. You can also use the /search-commerce-docs command.

Automatic index selection (recommended)

By asking natural language questions about your Commerce project, the tool will automatically search the appropriate documentation index and provide relevant information:

The following prompt automatically selects the commerce-storefront-docs index:

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

The following prompt automatically selects the commerce-extensibility-docs index:

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

The following prompt automatically selects the commerce-core-docs index:

"How to configure product catalog settings?"

The following prompt automatically selects the app-builder-docs index:

"What are App Builder runtime action best practices?"

Explicit index selection

Alternatively, you can specify the index you want to use in your prompt.

Search commerce-storefront-docs for authentication drop-in

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

Command-based search

If you want to ensure the RAG service is used, you can manually invoke the /search-commerce-docs Cursor command to search documentation with your prompt:

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

Custom Front Door endpoint

By default, the documentation search uses the production Azure Front Door endpoint with WAF protection. For testing or development purposes, you can override this with the FRONT_DOOR_URL environment variable.

To use a custom endpoint, add it to your Cursor MCP configuration:

{
  "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"
      }
    }
  }
}

Troubleshooting

The following sections provide troubleshooting tips for common issues you could encounter when using the documentation RAG service.

Authentication errors

The documentation search tool requires Adobe IMS authentication. If you encounter authentication errors, use the following steps to troubleshoot and resolve the issue.

MCP server not loading

If the MCP server is not connecting, or your agent says it cannot connect to the RAG, use the following steps to troubleshoot and resolve the issue.

Tool not found

Path issues (Windows)

On Windows, use forward slashes / or escaped backslashes \\:

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

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

Additional resources