DocumentazioneCommerceAdobe Commerce as a Cloud Service

[Solo SaaS]{class="badge positive" title="Applicabile solo ai progetti Adobe Commerce as a Cloud Service e Adobe Commerce Optimizer (infrastruttura SaaS gestita da Adobe)."}

Strumenti per gli sviluppatori di codifica AI per Adobe Commerce App Builder

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

Creato per:

  • Intermedio
  • Sviluppatore

Durante la migrazione a Adobe Commerce as a Cloud Service, è possibile utilizzare gli strumenti di codifica AI per convertire le estensioni PHP Adobe Commerce esistenti in applicazioni Adobe Developer App Builder. È inoltre possibile utilizzare questi strumenti per creare nuove applicazioni di App Builder.

Gli strumenti di codifica IA offrono i seguenti vantaggi:

  • Flusso di lavoro di sviluppo avanzato: strumenti di sviluppo Adobe Commerce integrati.
  • Assistenza basata su IA: generazione e debug del codice in base al contesto.
  • Funzioni specifiche di Commerce: strumenti specializzati per lo sviluppo Adobe Commerce App Builder.
  • Flussi di lavoro automatizzati: processi di sviluppo e distribuzione semplificati.

Installando gli strumenti di codifica AI, puoi accedere a:

  • Competenze: un set di competenze specifiche per Adobe Commerce e App Builder progettate per guidare e informare lo sviluppo delle applicazioni.
  • Server MCP per sviluppatori
  • Server App Builder MCP

Aggiornamento alla versione più recente

Dopo l'installazione di strumenti per sviluppatori di codifica AI, è possibile eseguire l'aggiornamento alla versione più recente eseguendo il comando seguente:

aio commerce extensibility tools-setup

Gli strumenti verranno aggiornati alla versione più recente.

Prerequisiti

Installazione

NOTE
Se desideri installare solo il servizio RAG Documentazione e non l'intero pacchetto degli strumenti di codifica AI, consulta Servizio RAG Documentazione.

  1. Installa la Adobe I/O CLI più recente a livello globale:

    code language-bash 
    npm install -g @adobe/aio-cli

  2. Installa i seguenti plug-in:

    code language-bash 
    aio plugins:install https://github.com/adobe-commerce/aio-cli-plugin-commerce @adobe/aio-cli-plugin-app-dev @adobe/aio-cli-plugin-runtime

  3. Clona uno dei seguenti elementi:

    • kit di avvio per l'integrazione di Commerce - per la creazione di integrazioni back-office.

      code language-bash 
      git clone git@github.com:adobe/commerce-integration-starter-kit.git

    • Commerce kit di avvio per l'estrazione per la creazione o l'estensione dell'esperienza di estrazione, inclusi pagamenti, spedizione e imposte.

      code language-bash 
      git clone git@github.com:adobe/commerce-checkout-starter-kit.git

  4. Passare alla directory del kit di avvio:

    code language-bash 
    cd commerce-integration-starter-kit

  5. Installare gli strumenti di estensibilità di Commerce AI eseguendo il comando di installazione interattivo:

    code language-bash 
    aio commerce extensibility tools-setup

    Il processo di configurazione richiede di specificare le opzioni di configurazione. Seguire le istruzioni per completare l'installazione. Gli strumenti verranno installati nella directory selezionata.

    • Selezionare il kit di avvio da utilizzare per il progetto.

      code language-shell-session 
      ? Which starter kit would you like to use?
❯ Integration starter kit
   Checkout starter kit

    • Seleziona l’agente di codifica preferito. Sono supportati più di 40 agenti di codifica, ma se l'agente preferito non viene visualizzato, è possibile utilizzare l'opzione Other per installare abilità per qualsiasi agente di codifica. Per istruzioni su come configurare le abilità, consulta la documentazione dell’agente di codifica.

      code language-shell-session 
      ? Which coding agent would you like to install skills for?
❯ Cursor
   Claude Code
   GithubCopilot
   Windsurf
   Gemini CLI
   OpenAI Codex
   Cline
   ...

    • Il programma di installazione rileverà se è installato NPM o Yarn e effettuerà automaticamente la selezione appropriata. Tuttavia, se non hai installato nessuno dei due, ti verrà richiesto di selezionare il gestore di pacchetti; Adobe consiglia di utilizzare npm per coerenza:

      code language-shell-session 
      ? Which package manager would you like to use?
❯ npm
   yarn

  6. Dopo aver installato correttamente gli strumenti di codifica, il processo di installazione configura:

    • Integrazione del server MCP per lo sviluppo Adobe Commerce
    • Abilità agente per esperienza di sviluppo avanzata
    • Strumenti di sviluppo e flussi di lavoro specifici per Commerce

    Sono ora installati gli strumenti skill e MCP. Se non trovi le abilità e gli strumenti MCP, riavvia l’agente di codifica.

NOTE
Prima di distribuire il progetto, è necessario completare le seguenti attività di configurazione:
Puoi completare questi passaggi di configurazione manualmente o sfruttare gli strumenti di codifica IA per guidarti nel processo. Per istruzioni di configurazione dettagliate, consulta Creare un'integrazione.

Configurazione post-installazione

Accedi a Adobe I/O CLI

Dopo aver installato Adobe I/O CLI, è necessario accedere in qualsiasi momento per utilizzare il server MCP.

aio auth login

Per verificare di aver eseguito l'accesso, eseguire il comando seguente:

aio where

In caso di problemi, disconnettersi e accedere nuovamente:

aio auth logout
aio auth login
NOTE
Alcune funzionalità del server MCP funzioneranno senza effettuare l’accesso, ma il servizio RAG (Retrieval-Augmented Generation) non funzionerà. Il servizio RAG fornisce all’agente di codifica AI l’accesso in tempo reale al set completo della documentazione di Adobe Commerce, consentendogli di rispondere alle domande e generare il codice in base alle procedure di sviluppo Commerce, alle API e ai pattern architetturali correnti.
Per installare il servizio RAG in modo indipendente, vedere Servizio RAG documentazione.

Cursore

  1. Riavvia l’IDE cursore per caricare i nuovi strumenti e la nuova configurazione MCP.

  2. Verificare l'installazione confermando che le abilità sono presenti nella cartella .cursor/skills/.

  3. Attiva il server MCP:

    • Apri le impostazioni MCP del cursore utilizzando Cmd+Maiusc+P (macOS) o Ctrl+Maiusc+P (Windows e Linux).
    • Tipo Visualizza: apri impostazioni MCP
    • Individua Commerce-Extensibility MCP Server nell'elenco
    • Attiva/disattiva il server ON per abilitare gli strumenti di codifica

  4. Verifica dello stato del server: il server MCP di estensibilità di Commerce deve essere visualizzato come:

    code language-shell-session 
    Status: Connected/Active
Server: commerce-extensibility
Configuration: Automatically configured via .cursor/mcp.json

  5. Utilizza il seguente prompt per verificare se l’agente utilizza il server MCP. In caso contrario, chiedi esplicitamente all’agente di utilizzare gli strumenti MCP disponibili.

    code language-shell-session 
    What are the differences between Adobe Commerce PaaS and Adobe Commerce as a Cloud Service when configuring a webhook that activates an App Builder runtime action?

Copilota

  1. Riavviare Visual Studio Code per caricare i nuovi strumenti e la nuova configurazione MCP.

  2. Verificare l'installazione confermando che il file copilot-instructions.md esiste nella cartella .github.

  3. Attiva il server MCP:

    • Apri il pannello Estensioni facendo clic sull'icona Estensioni nella barra attività a sinistra oppure utilizzando Cmd+Maiusc+X (macOs) o Ctrl+Maiusc+X (Windows e Linux).
    • Fare clic su SERVER MCP - INSTALLATI.
    • Fare clic sull'icona a forma di ingranaggio accanto a Commerce-extensibility MCP Server e selezionare Avvia server, se il server è arrestato.
    • Fare di nuovo clic sull'icona a forma di ingranaggio e selezionare Mostra output.

  4. Verificare lo stato del server. L'output MCP:commerce-extensibility deve corrispondere al seguente:

    code language-shell-session 
    2025-11-13 12:58:50.652 [info] Starting server commerce-extensibility
2025-11-13 12:58:50.652 [info] Connection state: Starting
2025-11-13 12:58:50.652 [info] Starting server from LocalProcess extension host
2025-11-13 12:58:50.657 [info] Connection state: Starting
2025-11-13 12:58:50.657 [info] Connection state: Running

(...)

2025-11-13 12:58:50.753 [info] Discovered 10 tools

  5. Utilizza il seguente prompt per verificare se l’agente utilizza il server MCP. In caso contrario, chiedi esplicitamente all’agente di utilizzare gli strumenti MCP disponibili.

    code language-shell-session 
    What are the differences between Adobe Commerce PaaS and SaaS when configuring a webhook that activates an App Builder runtime action?

Richiesta di esempio

Il seguente prompt di esempio utilizza il kit di avvio dell’integrazione per creare un’applicazione con cui inviare notifiche quando viene effettuato un ordine.

Implement an Adobe Commerce SaaS application that will send an ERP notification when a customer places an order. The ERP notification must be sent as a POST HTTP call to <ERP URL> with the following details in the request JSON body:

Order ID -> orderID
Order Total -> total
Customer Email ID -> emailID
Payment Type -> pType

Il seguente prompt di esempio utilizza il kit di avvio per l'estrazione per creare un'applicazione che fornisce metodi di spedizione personalizzati.

Implement an Adobe Commerce SaaS application that provides custom shipping methods.
The extension should:
1. Return shipping options based on the destination postal code
2. If postal code is in California, add an "Express California" option for $15
3. If postal code is outside US, add an "International Standard" option for $25
4. The carrier code should be "MYSHIP"

Comandi Prompt

Oltre a richiedere conferma, è possibile utilizzare il comando /search-commerce-docs per eseguire ricerche nella documentazione nelle conversazioni con l'agente. Ad esempio:

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

Abilità

Anche se le abilità verranno richiamate automaticamente quando si chatta con l'agente di codifica, è possibile richiamarle manualmente utilizzando i seguenti comandi:

  • /architect - Progetta l'architettura per le estensioni Adobe Commerce utilizzando App Builder e il kit di avvio selezionato. Da utilizzare per pianificare integrazioni, selezionare eventi, progettare flussi di dati o prendere decisioni architettoniche.
  • /developer - Implementa le estensioni Adobe Commerce seguendo i pattern App Builder e la struttura del file. Utilizza quando generi codice, aggiorni i file di configurazione o implementi azioni di runtime.
  • /devops-engineer - Distribuisce e gestisce App Builder estensioni. Da utilizzare per la distribuzione di applicazioni, la configurazione di ambienti, la risoluzione di problemi di distribuzione, la configurazione di CI/CD o la risoluzione di errori di onboarding.
  • /product-manager - Raccoglie e documenta i requisiti per le estensioni Adobe Commerce. Utilizzare quando si avvia un nuovo progetto, si definiscono i criteri di accettazione, si chiariscono gli obiettivi aziendali o si crea la documentazione REQUIREMENTS.md.
  • /technical-writer - Crea una documentazione completa per le applicazioni App Builder. Usare per scrivere README.md, guide utente, documentazione API, registri delle modifiche o per garantire la completezza della documentazione.
  • /tester - Crea test completi per le applicazioni App Builder. Da utilizzare per la scrittura di unit test, test di integrazione, la convalida della sicurezza o la garanzia della qualità e della copertura del codice.
  • /tutor (sperimentale) - Insegna i concetti di sviluppo delle applicazioni Adobe Commerce con spiegazioni ed esempi chiari. Utilizzare per apprendere App Builder, comprendere gli eventi o richiedere indicazioni sui modelli di sviluppo.

Best practice

Adobe consiglia di seguire le seguenti best practice durante l’utilizzo degli strumenti di codifica IA:

Modalità pianificazione

Durante la chat con il tuo agente di codifica, devi selezionare la modalità Piano per creare un piano di implementazione dettagliato per il progetto.

Il metodo di selezione della modalità Piano varia a seconda dell'agente utilizzato. Per le istruzioni relative, consulta la documentazione dell’agente. Ad esempio:

Elenco di controllo

Prima di iniziare una sessione di sviluppo:

  • Controlla REQUIREMENTS.md
  • Verificare che gli strumenti MCP funzionino
  • Rivedi la fase corrente e gli obiettivi
  • Inizia con codice di esempio o progetti su scaffolding

Durante lo sviluppo:

  • Considera attendibile il protocollo in quattro fasi
  • Richiedi piani di implementazione per lo sviluppo complesso
  • Utilizzare gli strumenti MCP quando disponibili
  • Test di ogni funzione dopo l’implementazione
  • Esegui prima il test in locale, quindi distribuiscilo e ripetilo
  • Utilizzo degli strumenti di codifica per testare il supporto
  • Mettere in dubbio la complessità inutile
  • Implementazione incrementale per uno sviluppo più rapido

All'avvio di una nuova chat:

  • Fornire un handoff di sessione corretto
  • Fai riferimento ai file chiave con @
  • Imposta obiettivi chiari per la sessione
  • Usa limiti basati su fasi

Flusso di lavoro

Durante lo sviluppo con gli strumenti di codifica AI, inizia con un codice di esempio o progetti su scaffolding. Questo approccio ti assicura di basarti su basi solide anziché partire dal nulla, ottimizzando al contempo il flusso di lavoro di sviluppo dell’intelligenza artificiale.

Questo consente anche di sfruttare i modelli di Adobe e di basarsi su modelli e architetture collaudate, mantenendo al contempo strutture e convenzioni di directory consolidate.

Consulta le seguenti risorse per iniziare:

Perché utilizzare queste risorse

  • Modelli comprovati: i kit di avvio incorporano le best practice e le decisioni di architettura di Adobe
  • Sviluppo più rapido: riduce il tempo impiegato per il boilerplate e la configurazione
  • Coerenza: garantisce che l'applicazione segua le convenzioni stabilite
  • Manutenzione: più semplice da mantenere e aggiornare con i seguenti modelli standard
  • Documentazione: gli starter kit includono esempi e documentazione
  • Supporto community: è più semplice ottenere assistenza quando si utilizzano approcci standard
  • Efficienza del contesto AI: utilizza modelli e strutture familiari con cui lavorare, riducendo la necessità di spiegazioni approfondite e migliorando la precisione della generazione del codice
  • Utilizzo token ridotto: fai riferimento a modelli esistenti invece di generare tutto da zero, per conversazioni più efficienti e meno riepiloghi di contesto

Protocollo

Il seguente protocollo in quattro fasi viene applicato automaticamente dalle abilità installate. Gli strumenti devono seguire questo protocollo automaticamente durante lo sviluppo di applicazioni:

  • Fase 1: analisi dei requisiti e chiarimento
    • Quando ti vengono poste domande chiarificatrici, fornisci risposte complete.
  • Fase 2: pianificazione architetturale e approvazione degli utenti
    • Quando viene presentato un piano, rivederlo attentamente prima di approvarlo.
  • Fase 3: Generazione e implementazione del codice
  • Fase 4: Documentazione e convalida

Richiedi piani di implementazione per lo sviluppo complesso

Per uno sviluppo complesso che coinvolge più azioni di runtime, punti di contatto o integrazioni, richiedi esplicitamente che gli strumenti di intelligenza artificiale creino un piano di implementazione dettagliato. Quando in Fase 2 viene visualizzato un piano di alto livello che coinvolge più componenti, richiedere un piano di implementazione dettagliato per suddividerlo in attività gestibili:

Create a detailed implementation plan for this complex development.

Le applicazioni Adobe Commerce complesse spesso richiedono:

  • Più azioni di runtime
  • Configurazione dell’evento in più punti di contatto
  • Integrazione con sistemi esterni
  • Requisiti di gestione dello stato
  • Test su più componenti

Utilizzare gli strumenti MCP

NOTE
Prima di utilizzare gli strumenti MCP, assicurati di aver effettuato l'accesso a Adobe I/O CLI.

Per impostazione predefinita, gli strumenti sono strumenti MCP, ma in determinate circostanze possono essere utilizzati i comandi CLI. Per garantire l’utilizzo dello strumento MCP, richiedilo esplicitamente nel prompt.

Se sono presenti comandi CLI in uso e si desidera utilizzare gli strumenti MCP, utilizzare il seguente prompt:

Use only MCP tools and not CLI commands
  • Strumenti MCP: aio-app-deploy, aio-app-dev, aio-dev-invoke
  • Comandi CLI: distribuzione app aio, sviluppo app aio

I comandi CLI possono essere utilizzati per i seguenti scenari:

  • Scenari di distribuzione complessi
  • Problemi specifici di debug
  • Quando gli strumenti MCP hanno limitazioni
  • Operazioni una tantum che non beneficiano dell'integrazione MCP

Sviluppo

Mettere in dubbio la complessità non necessaria creata dagli strumenti di intelligenza artificiale.

Quando si aggiungono file non necessari (validator.js, transformer.js, sender.js) per endpoint di sola lettura semplici, utilizzare i prompt seguenti:

Why do we need these files for a simple read-only endpoint?
Perform a root cause analysis before adding complexity
Verify if simpler solutions exist

Test

Utilizza le seguenti best practice durante il test:

Test di ogni funzione dopo l’implementazione

Dopo aver completato lo sviluppo di una funzione nel piano di implementazione, testala immediatamente. I test preliminari evitano i problemi composti e semplificano il debug.

  • Non attendere il completamento di tutte le funzionalità
  • Esegui il test in modo incrementale per rilevare i problemi in anticipo
  • Convalida la funzionalità prima di passare alla funzionalità successiva

Esegui prima il test locale

Eseguire sempre il test prima localmente utilizzando lo strumento aio-app-dev. Questo offre un feedback immediato e consente cicli di iterazione più rapidi, debug più semplice e nessun sovraccarico di distribuzione.

  1. Avvia server di sviluppo locale:

    code language-bash 
    aio-app-dev

  2. Test delle azioni in locale:

    code language-bash 
    aio-dev-invoke action-name --parameters '{"test": "data"}'

Distribuisci e verifica di nuovo

Una volta che il test locale ha avuto esito positivo, distribuisci e verifica nell’ambiente di runtime. Gli ambienti di runtime possono avere un comportamento diverso rispetto allo sviluppo locale.

  1. Distribuisci in fase di esecuzione:

    code language-bash 
    aio-app-deploy

  2. Test delle azioni distribuite

  3. Utilizzare il browser web o le richieste HTTP dirette

  4. Controlla i registri di attivazione per il debug

Utilizzo degli strumenti di codifica per testare il supporto

Chiedi assistenza per i test. Gli strumenti possono essere utili per il debug, l’analisi dei registri e la creazione di dati di test appropriati per azioni di runtime specifiche.

Azioni runtime di test:

Help me test the customer-created runtime action running locally

Errori di debug:

Why did the subscription-updated runtime action activation fail?

Registri di controllo:

Help me check the logs for the last stock-monitoring runtime action invocation

Crea payload di test:

Generate test data for this Commerce event

Create a test payload for the customer_save_after event

Trova endpoint di runtime:

What's the URL for this deployed action?

Gestisci autenticazione:

How do I authenticate with this external API?

Risoluzione dei problemi:

Help me debug why this action is returning 500 errors

Debug

Fermatevi e valutate quando le cose vanno male. In caso di problemi:

  • Interrompi e valuta - Non continuare in uno stato interrotto
  • Registri di controllo: utilizza i registri di attivazione per identificare i problemi
  • Semplificare: rimuovere la complessità per isolare i problemi
  • Test incrementale: correggi un problema alla volta
  • Convalida: verifica di ogni correzione prima di procedere

Distribuzione

Utilizza le seguenti best practice durante la distribuzione:

Implementare in modo incrementale

Distribuisci solo le azioni modificate per accelerare lo sviluppo. Questo approccio riduce il rischio di interrompere le funzionalità esistenti e fornisce un feedback più rapido sulle modifiche.

  • Utilizzare gli strumenti MCP per distribuire azioni specifiche

    code language-bash 
    aio-app-deploy --actions action-name

  • Distribuire singole azioni dopo il test locale

  • Distribuzione incrementale ed evitare l'installazione completa delle applicazioni durante lo sviluppo

Pulizia runtime

Dopo modifiche importanti, utilizza gli strumenti per pulire le azioni orfane. Consenti agli strumenti di intelligenza artificiale di gestire il processo di pulizia in modo sistematico. È in grado di identificare in modo efficiente le azioni orfane, verificarne lo stato e rimuoverle in modo sicuro senza intervento manuale.

Help me identify and clean up orphaned runtime actions

Richiedi agli strumenti di intelligenza artificiale di elencare le azioni distribuite e identificare quelle non utilizzate

List all deployed actions and identify which ones are no longer needed

Richiedere agli strumenti di intelligenza artificiale di rimuovere le azioni orfane utilizzando i comandi appropriati

Remove the orphaned actions that are no longer part of the current implementation

Monitorare

Utilizza le seguenti best practice per monitorare l’applicazione:

Controlla gli indicatori di qualità del contesto

  • Buon contesto: IA ricorda le decisioni recenti e fa riferimento a file corretti
  • Contesto non valido: l'IA richiede le informazioni fornite in precedenza e ripete i problemi risolti

Tracciare la velocità di sviluppo

  • Alta velocità: chiaro progresso, è necessaria una chiarificazione minima
  • Bassa velocità: spiegazioni ripetute, confusione IA, avanzamento lento

Monitorare l'efficienza dei costi

Tracciare i pattern di utilizzo dei token:

  • Efficiente: utilizzo dei token ridotto, pochi riepiloghi di contesto
  • Inefficiente: utilizzo token elevato, più riepiloghi, lavoro ripetuto

Cosa evitare

Evita i seguenti anti-pattern quando utilizzi gli strumenti di codifica AI:

  • Non saltare la fase di chiarificazione. Assicurarsi sempre che la fase 1 sia completata prima dell'implementazione.
  • Non saltare i test dopo ogni funzionalità. Esegui il test in modo incrementale, non attendere il completamento di tutto.
  • Non aggiungere complessità senza l'analisi della causa principale. Contattare i file aggiunti non necessari e richiedere indagini appropriate.
  • Non dichiarare l'esito positivo senza test dei dati reali - Verifica sempre con i dati effettivi, non solo con i casi limite.
  • Non dimenticare la pulizia in fase di esecuzione. Eliminare sempre le azioni orfane dopo modifiche importanti.

Invio di feedback

Gli sviluppatori interessati a fornire feedback sugli strumenti di codifica AI possono utilizzare il comando /feedback.

Questo comando consente di fornire un feedback testuale e di inviare i registri ad Adobe. Tutti i registri inviati saranno bonificati per rimuovere eventuali informazioni private o personali.

TIP
L’esperienza utente varia leggermente a seconda dell’IDE in uso. Il processo seguente descrive l’esperienza in Cursore.

  1. Nell'agente digitare /feedback e selezionare il comando commerce-extensibility/feedback.

  2. Fornisci il tuo feedback per gli strumenti nel campo Feedback che viene visualizzato nella parte superiore dell'IDE e premi il tasto Invio.

    Campo di input comando feedback cursore {width="600" modal="regular"}

  3. Nel campo Salva localmente, digitare yes o no e premere Invio per indicare se si desidera salvare una copia locale dei registri.

    Il comando di feedback del cursore salva il campo localmente {width="600" modal="regular"}

    Se hai selezionato Sì, puoi esaminare i registri nella cartella chats dopo aver inviato il tuo feedback.

  4. Il comando commerce-extensibility/feedback viene visualizzato nel campo di input della chat dell'agente. Premi Invio o fai clic su Invia per inviare il tuo feedback ad Adobe.

NOTE
Se il comando /feedback non viene visualizzato, potrebbe essere necessario aggiornare alla versione più recente.
recommendation-more-help
8562d99f-dbeb-485e-bae7-5e82fa87f463