DocumentazioneCommerceAdobe Commerce as a Cloud Service

Esercitazione sull’estensione delle valutazioni

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

Creato per:

  • Intermedio
  • Sviluppatore

Questa esercitazione ti guida attraverso la creazione di un'estensione di valutazione del prodotto per Adobe Commerce as a Cloud Service utilizzando Adobe App Builder e strumenti di sviluppo assistiti da IA.

Prima di iniziare, completa i prerequisiti.

Verificare i prerequisiti

Verifica che siano installati i seguenti prerequisiti:

# 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 uno dei comandi precedenti non restituisce i risultati previsti, consultare i prerequisiti.

Sviluppo delle estensioni

Questa sezione ti guida attraverso lo sviluppo di un’estensione di valutazione per Adobe Commerce as a Cloud Service utilizzando strumenti di sviluppo assistiti da intelligenza artificiale.

  1. Passare a Cursor > Settings > Cursor Settings > Tools & MCP e verificare che il set di strumenti commerce-extensibility sia abilitato senza errori. Se vengono visualizzati degli errori, disattiva e attiva la serie di strumenti.

    Impostazioni IDE cursore che mostrano il set di strumenti di estendibilità e commerce MCP abilitato {width="600" modal="regular"}

    note note
    NOTE
    Quando si lavora con strumenti di sviluppo assistiti da intelligenza artificiale, è probabile che il codice e le risposte generate dall’agente presentino variazioni naturali.
    In caso di problemi con il codice, puoi sempre chiedere all'agente di aiutarti a eseguire il debug.

  2. Se hai aggiunto della documentazione al contesto del cursore, disattivala:

    • Passa a Cursore > Impostazioni > Impostazioni cursore > Indicizzazione e documenti ed elimina la documentazione elencata.

    L'indicizzazione del cursore e le impostazioni dei documenti con l'elenco della documentazione sono vuoti {width="600" modal="regular"}

  3. Genera il codice per un’estensione di valutazione del prodotto:

    • Dalla finestra di chat del cursore, selezionare la modalità Agente.
    • Immetti il seguente prompt:
    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
    Se l’agente richiede di cercare nella documentazione, consenti.

  4. Rispondi alle domande dell'agente esattamente per aiutarlo a generare il codice migliore.

    Finestra di chat del cursore in modalità agente con richiesta di estensione immessa {width="600" modal="regular"} Agente di IA che pone domande chiarificatrici sui requisiti dell'estensione {width="600" modal="regular"}

  5. Utilizza il testo di esempio seguente per rispondere alle domande dell’agente per impostare dati di valutazione randomizzati:

    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.

    L'agente crea un file requirements.md che funge da origine di verità per l'implementazione.

    File Requirements.md creato dall'agente di IA con dettagli di implementazione {width="600" modal="regular"}

  6. Esaminare il file requirements.md e verificare il piano.

    Se tutto sembra corretto, indicare all'agente di passare alla Fase 2 - Pianificazione architettura.

  7. Rivedi il piano dell’architettura.

  8. Indica all'agente di procedere con la generazione del codice.

    L'agente genera il codice necessario e fornisce un riepilogo dettagliato con i passaggi successivi.

    Piano dell'architettura dell'agente di IA di fase 2 per l'API di valutazione {width="600" modal="regular"} Riepilogo dei file di codice e della struttura generati {width="600" modal="regular"} Agente di IA che fornisce i passaggi successivi per il test e la distribuzione {width="600" modal="regular"}

Test locale

  1. Chiedi all'agente di aiutarti a testare il codice localmente.

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

  2. Segui le istruzioni dell’agente e verifica che l’API funzioni localmente.

    Istruzioni agente IA per test API locali {width="600" modal="regular"} Terminale che mostra i risultati dei test API locali con cURL {width="600" modal="regular"}

Distribuire l’estensione

  1. Dopo aver verificato il codice generato, distribuisci l’estensione utilizzando il seguente prompt:

    code language-shell-session 
    Deploy the ratings API.

    Prima della distribuzione, l'agente esegue una valutazione di fattibilità pre-distribuzione.

    Elenco di controllo per la valutazione dell'idoneità dell'agente di IA pre-distribuzione {width="600" modal="regular"}

  2. Quando sei sicuro dei risultati della valutazione, indica all’agente di procedere con la distribuzione.

    L’agente utilizza il toolkit MCP per verificare, generare e distribuire automaticamente.

    Processo di compilazione e distribuzione del toolkit MCP {width="600" modal="regular"}

Post-distribuzione

Puoi testare l’API prima di integrarla nella vetrina. L’agente deve fornire la posizione della nuova azione e una strategia di test.

Strategia di test dell'agente di IA con URL azione distribuito e comandi di test {width="600" modal="regular"}

Puoi anche testare manualmente l’API utilizzando cURL in un terminale:

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

Terminale che mostra il test cURL dell'API di classificazione distribuita {width="600" modal="regular"} riuscito

Integrare con Edge Delivery Services

Per integrare l'API di valutazione con una vetrina Adobe Commerce con tecnologia Edge Delivery Services, chiedere all'agente di creare un contratto di servizio con i requisiti per l'API di valutazione:

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

Agente di IA che crea il file del contratto di servizio per l'integrazione storefront {width="600" modal="regular"}

File markdown del contratto API delle valutazioni con dettagli dell'endpoint e della risposta {width="600" modal="regular"}

Passaggi successivi

Ora che hai il contratto API di valutazione, puoi iniziare a creare la porzione vetrina (front-end) dell’estensione di valutazione.

recommendation-more-help
8562d99f-dbeb-485e-bae7-5e82fa87f463