Documentatie Commerce Adobe Commerce as a Cloud Service

Zelfstudie over het verlengen van beoordelingen

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

Onderwerpen:
App Builder
Cloud

Gemaakt voor:

tussenpersoon
Ontwikkelaar

Deze zelfstudie begeleidt u bij het maken van een productrating-extensie voor Adobe Commerce as a Cloud Service gebruik van Adobe App Builder - en AI-ontwikkelingsprogramma's.

Alvorens u begint, voltooi de eerste vereisten .

Voorwaarden verifiëren

Controleer of de volgende voorwaarden zijn geïnstalleerd:

# 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

Als om het even welke voorafgaande bevelen niet de verwachte resultaten terugkeren, verwijs naar de eerste vereisten voor begeleiding.

Uitbreiding

In deze sectie vindt u instructies voor het ontwikkelen van een extensie voor beoordelingen voor Adobe Commerce as a Cloud Service met behulp van ontwikkelingstools voor AI.

Navigeer naar Cursor > Settings > Cursor Settings > Tools & MCP en controleer of de gereedschapset commerce-extensibility zonder fouten is ingeschakeld. Als er fouten optreden, schakelt u de gereedschapset in en uit.

de montages van winde van de Curseur die MCP handel-rekbaarheid toegelaten toolset tonen {width="600" modal="regular"}

note note
NOTE
Als u werkt met ontwikkelprogramma's voor AI, verwacht u natuurlijke variaties in de code en reacties die door de agent worden gegenereerd. Als u om het even welke kwesties met uw code ontmoet, kunt u altijd de agent vragen om u te helpen het zuiveren.

Als u documentatie hebt toegevoegd aan de context van de Cursor, maak het onbruikbaar:
- Navigeer aan Curseur > Montages > de Montages van de Curseur > Indexeren & Dokken en schrap om het even welke vermelde documentatie.
{width="600" modal="regular"}

Code genereren voor een extensie voor productbeoordelingen:

Van het venster van het het praatje van de Curseur, uitgezochte wijze van de Agent van 0}.
Voer de volgende vraag in:

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
Als de agent om de documentatie verzoekt te zoeken, sta het toe.

Beantwoord de vragen van de agent precies om het te helpen de beste code produceren.

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

Gebruik de volgende voorbeeldtekst om de vragen van de agent aan opstellings willekeurig gevormde classificatiegegevens te beantwoorden:

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.

De agent maakt een requirements.md -bestand dat als bron van waarheid voor de implementatie fungeert.

Requirements.md- dossier dat door AI agent met implementatiedetails {width="600" modal="regular"} wordt gecreeerd

Controleer het requirements.md -bestand en verifieer het plan.

Als alles correct kijkt, instrueer de agent om zich aan Fase 2 te bewegen - de Planning van de Architectuur.
Controleer het architectuurplan.
Geef de agent de opdracht om door te gaan met het genereren van code.

De agent produceert de noodzakelijke code en verstrekt een gedetailleerde samenvatting met uw volgende stappen.

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

Lokale tests

Vraag de agent om u te helpen de code plaatselijk testen.

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

Volg de instructies van de agent en bevestig dat de API lokaal werkt.

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

De extensie implementeren

Na het verifiëren van de geproduceerde code, stel de uitbreiding op gebruikend de volgende herinnering:

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

De agent voert een pre-plaatsingsklaar beoordeling uit alvorens op te stellen.

AI agent pre-plaatsing controlelist van de de hulpmiddelenbeoordeling {width="600" modal="regular"}

Wanneer u met de beoordelingsresultaten vertrouwd bent, instrueer de agent om met plaatsing te werk te gaan.

De agent gebruikt toolkit MCP om, automatisch te verifiëren en op te stellen.

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

Post-implementatie

U kunt de API testen voordat u deze integreert in de winkel. De agent moet de locatie van de nieuwe actie en een teststrategie opgeven.

AI agent testende strategie met opgestelde actie URL en testbevelen {width="600" modal="regular"}

U kunt de API ook handmatig testen met cURL in een terminal:

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

Eind die succesvolle cURL test van opgestelde classificaties API tonen {width="600" modal="regular"}

Integreren met Edge Delivery Services

Als u de API voor classificaties wilt integreren met een Adobe Commerce storefront die wordt aangestuurd door Edge Delivery Services , vraagt u de agent een servicecontract te maken met de vereisten voor de API voor classificaties:

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

AI agent die het dossier van het de dienstcontract voor storefront integratie creeert {width="600" modal="regular"}

het contractonderdrukkingsdossier van de Verlagingen API met eindpunt en reactiedetails {width="600" modal="regular"}

Volgende stappen

Nu u het bevoegdheids-API-contract hebt, kunt u beginnen met het bouwen van het storefront-gedeelte (frontend) van de bevoegdheidsuitbreiding.

recommendation-more-help

2824e4b9-25f8-4682-bbf4-e4304bd8facf