Voorwaarden voor zelfstudie

Deze pagina maakt een lijst van de eerste vereisten en opstellingsstappen voor Adobe Commerce as a Cloud Service leerprogramma's, zoals het ​ leerprogramma van de classificatieuitbreiding ​ en het ​ verschepen zelfstudie van de methodeuitbreiding ​.

Adobe Commerce as a Cloud Service-voorwaarden

  • De Adobe I/O CLI installeren

    code language-bash
    npm install -g @adobe/aio-cli
    
  • Installeer ​ Adobe I/O CLI Commerce ​, ​ Adobe I/O CLI Runtime ​, en ​ App Builder CLI ​ stoppen:

    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
    
  • Download AI-bijgewoonde winde, zoals ​ Cursor ​ (geadviseerd), andere IDEs, zoals de Code van Claude, Gemini CLI, of Copilot wordt ook gesteund, maar kon wijzigingen in de herinneringen en andere stappen in het leerprogramma vereisen.

Adobe Developer Console-voorwaarden

  1. Navigeer aan ​ Adobe Developer Console ​.
  2. Meld u aan met uw e-mail en wachtwoord.

Een nieuw project maken

  1. Navigeer aan ​ Adobe Developer Console ​.

  2. Klik creeer project van een malplaatje.

  3. Selecteer het App Builder malplaatje.

  4. Ga Titel van het a Project in en App Naam.

  5. Controleer of het selectievakje Include Runtime is gemarkeerd.

    ​ Adobe Developer Console project verwezenlijking met het geselecteerde malplaatje van App Builder ​ {width="600" modal="regular"}

  6. Klik sparen.

API's toevoegen aan de werkruimte

  1. Klik de werkruimte van het Stadium en herhaal dan de volgende stappen voor elke API.

    ​ werkruimte van het Stadium met Add de optie van de Dienst voor APIs ​ {width="600" modal="regular"}

  2. Klik toevoegen de Dienst en selecteren API.

  3. Selecteer een van de volgende API's. U moet dit proces voor elke API herhalen die hieronder wordt vermeld:

    • filter van de Diensten van 0} Adobe {:

      • I/O Beheer API
      • I/O Gebeurtenissen API
    • Experience Cloud filter:

      • Adobe I/O Events voor Adobe Commerce API
  4. Klik daarna.

  5. Klik sparen gevormde API.

  6. Herhaal de vorige stappen totdat alle API's zijn toegevoegd aan de werkruimte.

    ​ Workspace die alle vereiste met succes toegevoegde APIs tonen ​ {width="600" modal="regular"}

De Adobe I/O CLI configureren

  1. Wis om het even welke bestaande configuratie:

    code language-bash
    aio config clear
    

    Meld u aan met Adobe I/O CLI :

    code language-bash
    aio auth login -f
    
  2. Selecteer uw organisatie, project, en werkruimte, gebruikend elk van de volgende bevelen:

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

    ​ Eind die Adobe I/O CLI organisatieproject en werkruimteselectie tonen ​ {width="600" modal="regular"}

De startkits klonen

Kloont een van de volgende Commerce starter kit repositories voor de extensie die u bouwt en bereidt uw project voor:

Integratiestartkit:

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

Uitchecken startkit:

git clone https://github.com/adobe/commerce-checkout-starter-kit.git extension
cd extension
Startuitrusting van de Integratie

Een .env-bestand maken

Maak uw configuratiebestand voor de omgeving:

code language-bash
cp env.dist .env

Open het bestand .env in een teksteditor en voeg de volgende OAuth-referenties toe:

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

U kunt deze waarden van de Credential details pagina in ​ Developer Console ​ kopiëren door het OAuth Server-to-Server lusje op uw werkruimte te klikken.

​ OAuth Server-aan-Server geloofsbrieven pagina in Adobe Developer Console ​ {width="600" modal="regular"}

De Commerce-configuratie toevoegen

Voeg de volgende Commerce-instantiedetails toe aan uw .env -bestand:

code language-shell-session
COMMERCE_BASE_URL=
COMMERCE_GRAPHQL_ENDPOINT=

U kunt als volgt de volgende waarden vinden:

  1. Navigeer aan ​ instanties van de Dienst van Commerce Cloud ​.
  2. Klik op het informatiepictogram naast de instantie.
  3. Kopieer het REST-eindpunt als COMMERCE_BASE_URL .
  4. Kopieer het GraphQL-eindpunt als COMMERCE_GRAPHQL_ENDPOINT .

Gebeurtenisvoorvoegsel instellen

Stel een tijdelijke waarde in voor het voorvoegsel van de gebeurtenis:

code language-shell-session
EVENT_PREFIX=test

Configuratie van werkruimte downloaden

Voer de volgende opdracht uit om het configuratiebestand van de werkruimte te downloaden:

code language-bash
aio console workspace download workspace.json

Kopieer het configuratiebestand van de werkruimte naar de map scripts :

code language-bash
cp workspace.json scripts/

Lokale werkruimte verbinden met externe werkruimte

Koppel uw lokale project aan de externe werkruimte:

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

​ Eind die succesvolle werkruimteverbinding tonen met het bevel van het de toepassingsgebruik van de lucht ​ {width="600" modal="regular"}

Uitchecken starter kit

Lokale werkruimte verbinden met externe werkruimte

Koppel uw lokale project aan de externe werkruimte. Voer vanuit de hoofdmap van het project (de map extension ):

code language-bash
aio app use --merge

Wanneer ertoe aangezet, kies de optie die de organisatie, het project, en de werkruimte gebruikt u selecteerde toen het vormen van Adobe I/O CLI. Hiermee schrijft u de werkruimteconfiguratie naar uw app, zodat deze werkruimte wordt gebruikt bij de implementatie en lokale ontwikkeling.

​ Eind die succesvolle werkruimteverbinding tonen met het bevel van het de toepassingsgebruik van de lucht ​ {width="600" modal="regular"}

Uitbreidbare AI-gereedschappen installeren

Dit proces leidt tot de configuratie MCP (.<agent>/mcp.json), de vaardigheidsfolder (.<agent>/skills/), en voegt AGENTS.md aan de projectwortel toe. U wordt gevraagd een startkit, coderingsagent en pakketbeheer te kiezen.

  1. Stel de ontwikkelprogramma's voor AI-toepassingen in de map extension in met behulp van de volgende opdrachten:

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

    ​ Eind die AI de output van het bevel van de de opstellingsbevelopstelling van uitbreidingshulpmiddelen tonen ​ {width="600" modal="regular"}

  2. Nadat de opstelling voltooit, nieuw begin uw coderingsagent om het toe te staan om de nieuwe hulpmiddelen MCP en vaardigheden te laden. De Commerce App Builder-tools zijn nu beschikbaar in uw omgeving.

    note note
    NOTE
    Als u een waarschuwing ziet dat er geen vaardigheden zijn gevonden voor de startkit, is er iets fout gegaan, vaak omdat de installatie in een andere map dan waar de startkit is gekloond, is uitgevoerd. Voer aio commerce extensibility tools-setup uit vanuit de map extension (de hoofdmap van het startkit-project) en selecteer de juiste startkit wanneer hierom wordt gevraagd.

    ​ Eind die AI de opstelling van rekbaarheidshulpmiddelen met geselecteerde kweekstarterkit tonen ​ {width="600" modal="regular"}

recommendation-more-help
2824e4b9-25f8-4682-bbf4-e4304bd8facf