DocumentazioneCommerceAdobe Commerce as a Cloud Service

Prerequisiti del tutorial

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

Creato per:

  • Intermedio
  • Sviluppatore

In questa pagina sono elencati i prerequisiti e i passaggi di configurazione per le esercitazioni di Adobe Commerce as a Cloud Service, ad esempio l'esercitazione sull'estensione delle classificazioni e l'esercitazione sull'estensione del metodo di spedizione.

Prerequisiti per Adobe Commerce as a Cloud Service

  • Installa Adobe I/O CLI

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

  • Installa i plug-in Adobe I/O CLI Commerce, Adobe I/O CLI Runtime e App Builder CLI:

    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

  • Scaricare un IDE basato sull'intelligenza artificiale, ad esempio Cursor (scelta consigliata), sono supportati anche altri IDE, come Claude Code, Gemini CLI o Copilot, ma potrebbero essere necessarie modifiche ai prompt e ad altri passaggi dell'esercitazione.

Prerequisiti di Adobe Developer Console

  1. Passa a Adobe Developer Console.
  2. Accedi utilizzando l’e-mail e la password.

Crea un nuovo progetto

  1. Passa a Adobe Developer Console.

  2. Fai clic su Crea progetto da un modello.

  3. Seleziona il modello App Builder.

  4. Immetti un Titolo progetto e un Nome app.

  5. Verificare che la casella di controllo Include Runtime sia contrassegnata.

    Creazione di un progetto Adobe Developer Console con modello App Builder selezionato {width="600" modal="regular"}

  6. Fai clic su Salva.

Aggiungere API all’area di lavoro

  1. Fare clic sull'area di lavoro Stage e quindi ripetere i passaggi seguenti per ogni API.

    Area di lavoro di staging con opzione Aggiungi servizio per API {width="600" modal="regular"}

  2. Fai clic su Aggiungi servizio e seleziona API.

  3. Seleziona una delle seguenti API. Dovrai ripetere questo processo per ogni API elencata di seguito:

    • Filtro Adobe Services:

      • API di gestione I/O
      • Eventi I/O API

    • Filtro Experience Cloud:

      • API Adobe I/O Events per Adobe Commerce

  4. Fai clic su Avanti.

  5. Fai clic su Salva API configurata.

  6. Ripeti i passaggi precedenti fino a quando tutte le API non vengono aggiunte all’area di lavoro.

    Workspace con tutte le API richieste aggiunte {width="600" modal="regular"}

Configurare Adobe I/O CLI

  1. Cancella eventuali configurazioni esistenti:

    code language-bash 
    aio config clear

    Accedi utilizzando Adobe I/O CLI:

    code language-bash 
    aio auth login -f

  2. Seleziona l’organizzazione, il progetto e l’area di lavoro utilizzando ciascuno dei seguenti comandi:

    code language-bash 
    aio console org select
    code language-bash 
    aio console project select
    code language-bash 
    aio console workspace select

    Terminale che mostra la selezione del progetto e dell'area di lavoro dell'organizzazione CLI di Adobe I/O {width="600" modal="regular"}

Clonare i kit di avvio

Clona uno dei seguenti archivi di Commerce Starter Kit per l’estensione che stai creando e prepara il progetto:

Kit di avvio dell’integrazione:

git clone https://github.com/adobe/commerce-integration-starter-kit.git extension
cd extension

Kit di avvio per il pagamento:

git clone https://github.com/adobe/commerce-checkout-starter-kit.git extension
cd extension
Kit di avvio dell'integrazione

Creare un file .env

Creare il file di configurazione dell’ambiente:

code language-bash 
cp env.dist .env

Apri il file .env in un editor di testo e aggiungi le seguenti credenziali OAuth:

code language-shell-session 
OAUTH_CLIENT_ID=
OAUTH_CLIENT_SECRET=
OAUTH_TECHNICAL_ACCOUNT_ID=
OAUTH_TECHNICAL_ACCOUNT_EMAIL=
OAUTH_ORG_ID=

È possibile copiare questi valori dalla pagina Credential details in Developer Console facendo clic sulla scheda OAuth Server-to-Server nell'area di lavoro.

Pagina credenziali server-to-server OAuth in Adobe Developer Console {width="600" modal="regular"}

Aggiungere la configurazione Commerce

Aggiungi i seguenti dettagli dell'istanza di Commerce al file .env:

code language-shell-session 
COMMERCE_BASE_URL=
COMMERCE_GRAPHQL_ENDPOINT=

Per trovare questi valori:

  1. Passa a istanze del servizio Commerce Cloud.
  2. Fai clic sull’icona delle informazioni accanto all’istanza.
  3. Copiare l'endpoint REST come COMMERCE_BASE_URL.
  4. Copiare l'endpoint GraphQL come COMMERCE_GRAPHQL_ENDPOINT.

Imposta prefisso evento

Imposta un valore temporaneo per il prefisso dell'evento:

code language-shell-session 
EVENT_PREFIX=test

Scarica configurazione area di lavoro

Esegui il comando seguente per scaricare il file di configurazione dell’area di lavoro:

code language-bash 
aio console workspace download workspace.json

Copiare il file di configurazione dell'area di lavoro nella directory scripts:

code language-bash 
cp workspace.json scripts/

Connetti area di lavoro locale a area di lavoro remota

Collega il progetto locale all’area di lavoro remota:

code language-bash 
aio app use workspace.json -m

Terminale che mostra la connessione all'area di lavoro riuscita con il comando aio app use {width="600" modal="regular"}

Kit di avvio estrazione

Connetti area di lavoro locale a area di lavoro remota

Collega il progetto locale all’area di lavoro remota. Dalla directory principale del progetto (la cartella extension), eseguire:

code language-bash 
aio app use --merge

Quando richiesto, scegli l’opzione che utilizza l’organizzazione, il progetto e l’area di lavoro selezionati durante la configurazione di Adobe I/O CLI. In questo modo la configurazione dell’area di lavoro viene scritta nell’app in modo che l’area di lavoro venga utilizzata sia per la distribuzione che per lo sviluppo locale.

Terminale che mostra la connessione all'area di lavoro riuscita con il comando aio app use {width="600" modal="regular"}

Installare gli strumenti di IA per l’estensibilità

Questo processo crea la configurazione MCP (.<agent>/mcp.json), la directory delle abilità (.<agent>/skills/) e aggiunge AGENTS.md alla directory principale del progetto. Verrà richiesto di scegliere un kit di avvio, un agente di codifica e un gestore di pacchetti.

  1. Impostare gli strumenti di sviluppo assistito da IA nella cartella extension utilizzando i seguenti comandi:

    code language-bash 
    cd extension
    code language-bash 
    aio commerce extensibility tools-setup

    Terminale che mostra l'output del comando di installazione degli strumenti di estensibilità AI {width="600" modal="regular"}

  2. Al termine dell’installazione, riavvia l’agente di codifica per consentirgli di caricare i nuovi strumenti e le nuove competenze MCP. Gli strumenti Commerce App Builder sono ora disponibili nel tuo ambiente.

    note note
    NOTE
    Se viene visualizzato un avviso che indica che non sono state trovate abilità per il kit di avvio, si è verificato un errore, spesso perché la configurazione veniva eseguita in una cartella diversa da quella in cui è stato clonato il kit di avvio. Eseguire aio commerce extensibility tools-setup dalla cartella extension (radice del progetto del kit di avvio) e selezionare il kit di avvio appropriato quando richiesto.

    Terminale che mostra la configurazione degli strumenti di estensibilità AI con il kit di avvio selezionato {width="600" modal="regular"}

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