DocumentaciónCommerceAdobe Commerce as a Cloud Service

Tutorial de extensión de clasificaciones

Last update: Wed Feb 25 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Intermedio
  • Desarrollador

Este tutorial lo guiará a través del proceso de creación de una extensión de clasificaciones de productos para Adobe Commerce as a Cloud Service mediante Adobe App Builder y las herramientas de desarrollo asistido por IA.

Antes de empezar, complete requisitos previos.

Comprobar requisitos previos

Compruebe que están instalados los siguientes requisitos previos:

# Check Node.js version (should be 22.x.x)
node --version

# Check npm version (should be 9.0.0 or higher)
npm --version

# Check Git installation
git --version

# Check Bash shell installation
bash --version

Si alguno de los comandos anteriores no devuelve los resultados esperados, consulte los requisitos previos para obtener instrucciones.

Desarrollo de extensiones

Esta sección le guía a través del desarrollo de una extensión de clasificación para Adobe Commerce as a Cloud Service mediante herramientas de desarrollo asistido por IA.

  1. Vaya a Cursor > Settings > Cursor Settings > Tools & MCP y compruebe que el conjunto de herramientas commerce-extensibility esté habilitado sin errores. Si hay errores, active o desactive el conjunto de herramientas.

    Configuración del IDE de cursor que muestra el conjunto de herramientas de extensibilidad comercial MCP habilitado {width="600" modal="regular"}

    note note
    NOTE
    Cuando trabaje con herramientas de desarrollo asistido por IA, espere variaciones naturales en el código y las respuestas generadas por el agente.
    Si tiene algún problema con el código, siempre puede pedir al agente que le ayude a depurarlo.

  2. Si se ha añadido documentación al contexto del cursor, desactívela:

    • Vaya a Cursor > Configuración > Configuración del cursor > Indexación y documentos y elimine cualquier documentación enumerada.

    Indexación de cursor y configuración de documentos con lista de documentación vacía {width="600" modal="regular"}

  3. Genere un código para una extensión de clasificación de productos:

    • En la ventana de conversación Cursor, seleccione el modo Agente.
    • Introduzca la siguiente solicitud:
    code language-shell-session 
    Implement an Adobe Commerce as a Cloud Service extension to handle Product Ratings.

Implement a REST API to handle GET ratings requests.

GET requests will have to support the following query parameters:

sku -> product SKU
    note note
    NOTE
    Si el agente solicita buscar en la documentación, permita.

  4. Responda las preguntas del agente con precisión para ayudarle a generar el mejor código.

    Ventana de chat del cursor en el modo Agente con el mensaje de extensión ingresado {width="600" modal="regular"} Agente de IA haciendo preguntas aclaratorias sobre los requisitos de extensión {width="600" modal="regular"}

  5. Utilice el siguiente texto de ejemplo para responder a las preguntas del agente con el fin de configurar datos de clasificación aleatorios:

    code language-shell-session 
    Yes, this headless extension is for Adobe Commerce as a Cloud Service storefront,
but we do not need any authentication for the GET API because guest users should be able to use it on the storefront.

This extension is called directly from the storefront, no async invocation, such as events or webhooks, is required.

Start with just the GET API for now, we will implement other CRUD operations at a later time.

We do not need a DB or storage mechanism right now, just return random ratings data between 1 and 5 and a ratings count between 1 and 1000.

The API should only return the average rating for the product and the total number of ratings.
We do not need to add tests right now.

    El agente crea un archivo de requirements.md que sirve como origen de la verdad para la implementación.

    Archivo Requirements.md creado por un agente de IA con detalles de implementación {width="600" modal="regular"}

  6. Revise el archivo requirements.md y compruebe el plan.

    Si todo parece correcto, indique al agente que pase a Phase 2 - Architecture Planning.

  7. Revise el plan de arquitectura.

  8. Indique al agente que continúe con la generación de código.

    El agente genera el código necesario y proporciona un resumen detallado de los pasos siguientes.

    Plan de arquitectura de fase 2 del agente de IA para la API de clasificaciones {width="600" modal="regular"} Resumen de archivos y estructura de código generados {width="600" modal="regular"} Agente de IA que proporciona los siguientes pasos para la prueba y la implementación {width="600" modal="regular"}

Pruebas locales

  1. Pida al agente que le ayude a probar el código localmente.

    code language-shell-session 
    Test the ratings API locally on a dev server using cURL.

  2. Siga las instrucciones del agente y confirme que la API funciona localmente.

    Instrucciones del agente de IA para pruebas de API locales {width="600" modal="regular"} El terminal muestra resultados correctos de prueba de API local con cURL {width="600" modal="regular"}

Implementación de la extensión

  1. Después de verificar el código generado, implemente la extensión mediante el siguiente mensaje:

    code language-shell-session 
    Deploy the ratings API.

    El agente realiza una evaluación de la preparación previa al despliegue antes de este.

    lista de comprobación de evaluación de preparación previa al despliegue del agente de IA {width="600" modal="regular"}

  2. Cuando confíe en los resultados de la evaluación, indique al agente que continúe con el despliegue.

    El agente utiliza el kit de herramientas de MCP para verificar, crear e implementar automáticamente.

    Proceso de implementación y compilación del kit de herramientas de MCP {width="600" modal="regular"}

Posterior a la implementación

Puede probar la API antes de integrarla en la tienda. El agente debe proporcionar la ubicación de la nueva acción y una estrategia de prueba.

Estrategia de prueba del agente de IA con URL de acción implementada y comandos de prueba {width="600" modal="regular"}

También puede probar la API manualmente utilizando cURL en un terminal:

curl -s "https://<your-site>.adobeioruntime.net/api/v1/web/ratings/ratings?sku=TEST-SKU-123"

El terminal muestra una prueba de cURL correcta de la API de clasificaciones implementada {width="600" modal="regular"}

Integración con Edge Delivery Services

Para integrar la API de clasificaciones con una tienda Adobe Commerce con tecnología Edge Delivery Services, pídale al agente que cree un contrato de servicio con los requisitos para la API de clasificaciones:

Create a service contract for the ratings api that I can pass on to the storefront agent. Name it RATINGS_API_CONTRACT.md

Agente de IA creando archivo de contrato de servicio para integración de tienda {width="600" modal="regular"}

Clasificaciones del archivo de marcado de contrato de API con detalles de extremo y respuesta {width="600" modal="regular"}

Pasos siguientes

Ahora que tiene el contrato de API de clasificación, puede empezar a crear la parte de tienda (front-end) de la extensión de clasificación.

recommendation-more-help
d201267d-8d61-4d13-b6bb-517a2cbb4981