[Solo SaaS]{class="badge positive" title="Solo se aplica a los proyectos de Adobe Commerce as a Cloud Service y Adobe Commerce Optimizer (infraestructura de SaaS administrada por Adobe)."}

Servicio de documentación de RAG (Beta)

El servicio de documentación RAG (Retrieval-Augmented Generation) proporciona funciones de búsqueda semánticas basadas en IA para la documentación de Adobe Commerce y App Builder.

Este RAG proporciona una interfaz IDE para hacer preguntas sobre Adobe Commerce y puede aconsejarle sobre las prácticas recomendadas para desarrollar aplicaciones y otras tareas de migración.

El servicio RAG forma parte del servidor Commerce extensibility tools MCP (Model Context Protocol), que se integra con el cursor y otros asistentes de IA compatibles con MCP.

Documentación disponible

En la tabla siguiente se describe qué documentación está indexada actualmente por el servicio RAG y las palabras clave que puede utilizar para almacenar en déclencheur la búsqueda en el índice asociado. La documentación incluida seguirá ampliándose a medida que desarrollemos el servicio RAG.

Para obtener más información sobre la selección de índices, consulte Selección automática de índices y Selección explícita de índices.

Para obtener información detallada sobre la documentación incluida en cada índice, consulte la lista de fuentes ingeridas.

Seguridad y privacidad

El extremo de producción está protegido por Azure Front Door, que incluye las siguientes protecciones:

Para diferentes requisitos de seguridad, puede utilizar un punto de conexión personalizado. Consulte Extremo personalizado de la puerta principal para obtener más información.

Requisitos previos

Antes de instalar, asegúrese de que dispone de lo siguiente:

Instalación

Uso

Una vez instalado, puede llamar a los índices automáticamente o explícitamente. También puede usar el comando /search-commerce-docs ​.

Selección automática de índices (recomendado)

Al hacer preguntas en lenguaje natural sobre su proyecto de Commerce, la herramienta buscará automáticamente el índice de documentación adecuado y proporcionará información relevante:

El siguiente mensaje selecciona automáticamente el índice commerce-storefront-docs:

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

El siguiente mensaje selecciona automáticamente el índice commerce-extensibility-docs:

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

El siguiente mensaje selecciona automáticamente el índice commerce-core-docs:

"How to configure product catalog settings?"

El siguiente mensaje selecciona automáticamente el índice app-builder-docs:

"What are App Builder runtime action best practices?"

Selección de índice explícita

También puede especificar el índice que desee utilizar en el mensaje.

Search commerce-storefront-docs for authentication drop-in

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

Búsqueda basada en comandos

Si desea asegurarse de que se utiliza el servicio RAG, puede invocar manualmente el comando Cursor /search-commerce-docs para buscar documentación con el símbolo del sistema:

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

Extremo personalizado de la puerta delantera

De manera predeterminada, la búsqueda de documentación usa el extremo de producción Azure Front Door con protección WAF. Para fines de prueba o desarrollo, puede anular esto con la variable de entorno FRONT_DOOR_URL.

Para utilizar un punto de conexión personalizado, agréguelo a la configuración de MCP de cursor:

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

Resolución de problemas

En las siguientes secciones se proporcionan sugerencias para la resolución de problemas comunes que podrían producirse al utilizar el servicio RAG de documentación.

Errores de autenticación

La herramienta de búsqueda de documentación requiere la autenticación IMS de Adobe. Si encuentra errores de autenticación, siga los siguientes pasos para solucionar el problema.

El servidor MCP no se carga

Si el servidor MCP no se está conectando, o si el agente indica que no se puede conectar al RAG, siga los siguientes pasos para solucionar el problema.

Herramienta no encontrada

Problemas de ruta (Windows)

En Windows, use las barras diagonales / o las barras invertidas de escape \\:

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

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

Recursos adicionales