Documentação Commerce Adobe Commerce as a Cloud Service

Tutorial da extensão de classificações

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

Criado para:

Intermediário
Desenvolvedor

Este tutorial o orienta por meio da criação de uma extensão de classificações de produto para o Adobe Commerce as a Cloud Service usando o Adobe App Builder e ferramentas de desenvolvimento assistido por IA.

Antes de começar, conclua os pré-requisitos.

Verificar pré-requisitos

Verifique se os seguintes pré-requisitos estão instalados:

# 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

Se qualquer um dos comandos anteriores não retornar os resultados esperados, consulte os pré-requisitos para obter orientação.

Desenvolvimento de extensão

Esta seção orienta você no desenvolvimento de uma extensão de classificações para o Adobe Commerce as a Cloud Service usando ferramentas de desenvolvimento assistido por IA.

Navegue até Cursor > Settings > Cursor Settings > Tools & MCP e verifique se o conjunto de ferramentas commerce-extensibility está habilitado sem erros. Se você vir erros, desligue e ligue o conjunto de ferramentas.

Configurações do IDE de cursor mostrando o conjunto de ferramentas de extensibilidade de comércio do MCP habilitado {width="600" modal="regular"}

note note
NOTE
Ao trabalhar com ferramentas de desenvolvimento assistidas por IA, espere variações naturais no código e nas respostas geradas pelo agente. Se encontrar problemas com o código, você sempre poderá pedir ao agente para ajudá-lo a depurá-lo.

Se você tiver alguma documentação adicionada ao contexto do cursor, desative-a:
- Navegue até Cursor > Configurações > Configurações do cursor > Indexação e documentos e exclua toda a documentação listada.
{width="600" modal="regular"}

Gerar código para uma extensão de classificações de produto:

Na janela de chat Cursor, selecione o modo Agente.
Digite o seguinte prompt:

code language-shell-session

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`

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
Se o agente solicitar a pesquisa na documentação, permita.

Responda às perguntas do agente com precisão para ajudá-lo a gerar o melhor código.

{width="600" modal="regular"} {width="600" modal="regular"}

Use o seguinte texto de exemplo para responder às perguntas do agente para configurar dados de classificações aleatórias:

code language-shell-session

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.

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.

O agente cria um arquivo requirements.md que serve como a fonte da verdade para a implementação.

Arquivo Requirements.md criado pelo agente de IA com detalhes de implementação {width="600" modal="regular"}

Revise o arquivo requirements.md e verifique o plano.

Se tudo estiver correto, instrua o agente a migrar para a Fase 2 - Planejamento de Arquitetura.
Revise o plano de arquitetura.
Instrua o agente a prosseguir com a geração de código.

O agente gera o código necessário e fornece um resumo detalhado com as próximas etapas.

{width="600" modal="regular"} {width="600" modal="regular"} {width="600" modal="regular"}

Teste local

Peça ao agente para ajudá-lo a testar o código localmente.

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

Siga as instruções do agente e confirme se a API está funcionando localmente.

{width="600" modal="regular"} {width="600" modal="regular"}

Implantar a extensão

Depois de verificar o código gerado, implante a extensão usando o seguinte prompt:

code language-shell-session
`Deploy the ratings API.`

O agente realiza uma avaliação de prontidão antes da implantação.

Lista de verificação de avaliação de preparação de pré-implantação do agente de IA {width="600" modal="regular"}

Quando estiver confiante nos resultados da avaliação, instrua o agente a prosseguir com a implantação.

O agente usa o kit de ferramentas MCP para verificar, compilar e implantar automaticamente.

{width="600" modal="regular"}

Pós-implantação

Você pode testar a API antes de integrá-la à loja. O agente deve fornecer o local da nova ação e uma estratégia de teste.

Estratégia de teste de agente de IA com URL de ação implantada e comandos de teste {width="600" modal="regular"}

Também é possível testar a API manualmente usando o cURL em um terminal:

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

Terminal mostrando teste cURL bem-sucedido da API de classificações implantada {width="600" modal="regular"}

Integrar ao Edge Delivery Services

Para integrar a API de classificações a uma loja Adobe Commerce da plataforma Edge Delivery Services, peça ao agente que crie um contrato de serviço com requisitos para a API de classificação:

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

O agente de IA está criando o arquivo de contrato de serviço para integração com a loja {width="600" modal="regular"}

Arquivo de markdown do contrato de API de classificações com detalhes de resposta e ponto de extremidade {width="600" modal="regular"}

Próximas etapas

Agora que você tem o contrato de API de classificação, pode começar a criar a parte da loja (front-end) da extensão de classificação.

recommendation-more-help

0519caf3-99f4-44ba-8e03-411a5b7764c8