DokumentationCommerceAdobe Commerce as a Cloud Service

Förutsättningar

Last update: Fri Mar 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Mellanliggande
  • Utvecklare

På den här sidan visas förutsättningarna och konfigurationsstegen för Adobe Commerce as a Cloud Service-självstudiekurser, t.ex. självstudiekursen för klassificeringstillägg och självstudiekursen för leveransmetodtillägg.

Allmänna krav

Följande verktyg krävs för både tillägg och butiksutveckling i den här självstudiekursen.

  • Node.js (version 22.x.x) och npm (9.0.0 eller senare): Verifiera installationen med följande kommando:

    code language-bash 
    node --version
npm --version

  • Installera Git - Verifiera installationen:

    code language-bash 
    git --version

  • Bash-skal

  • Hämta en AI-assisterad IDE, till exempel Markör (rekommenderas). Även andra utvecklingsmiljöer, som Claude Code, Gemini CLI och Copilot, stöds, men kan kräva ändringar av instruktioner och andra steg i självstudiekursen.

Krav för Adobe Commerce as a Cloud Service

  • Installera Adobe I/O CLI

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

  • Installera plugin-programmen Adobe I/O CLI Commerce, ​ Adobe I/O CLI Runtime och 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

Krav för Adobe Developer Console

Konfigurera ett projekt i Adobe Developer Console med de nödvändiga API:erna och autentiseringsuppgifterna.

  1. Gå till Adobe Developer Console.
  2. Logga in med din e-postadress och ditt lösenord.

Skapa ett nytt projekt

Skapa ett App Builder-projekt i Adobe Developer Console som värd för ditt tillägg.

  1. Navigera till Adobe Developer Console.

  2. Klicka på Create project from a template.

  3. Välj mallen App Builder.

  4. Ange Project Title och App Name.

  5. Kontrollera att kryssrutan Include Runtime är markerad.

    Skapa Adobe Developer Console-projekt med en App Builder-mall vald {width="600" modal="regular"}

  6. Klicka på Save.

Lägg till API:er på arbetsytan

Lägg till nödvändiga API:er på scenarbetsytan för händelsehantering och integrering med Commerce.

  1. Klicka på arbetsytan Stage och upprepa sedan följande steg för varje API.

    Scenarbetsyta med alternativet Lägg till tjänst för API:er {width="600" modal="regular"}

  2. Klicka på Add Service och välj API.

  3. Välj någon av följande API:er. Upprepa den här processen för varje API som visas nedan:

    • Adobe Services-filter:

      • I/O Management API
      • API för I/O Events

    • Experience Cloud-filter:

      • API för Adobe I/O Events for Adobe Commerce

  4. Klicka på Next.

  5. Klicka på Save configured API.

  6. Upprepa föregående steg tills du lägger till alla API:er på arbetsytan.

    Workspace visar alla nödvändiga API:er som lagts till {width="600" modal="regular"}

Konfigurera Adobe I/O CLI

Anslut Adobe I/O CLI till din organisation, ditt projekt och din arbetsyta.

  1. Rensa befintlig konfiguration:

    code language-bash 
    aio config clear

  2. Logga in med Adobe I/O CLI:

    code language-bash 
    aio auth login -f

  3. Välj organisation, projekt och arbetsyta med hjälp av följande kommandon:

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

    Terminal som visar Adobe I/O CLI-organisationsprojekt och val av arbetsyta {width="600" modal="regular"}

Klona startkit

Klona en av följande Commerce startkit-databaser för det tillägg du håller på att bygga och förbereda ditt projekt:

Startpaket för integrering:

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

Startpaket för kassan:

git clone https://github.com/adobe/commerce-checkout-starter-kit.git extension
cd extension
Startpaket för integrering

Skapa en .env-fil

Skapa din miljökonfigurationsfil:

code language-bash 
cp env.dist .env

Öppna filen .env i en textredigerare och lägg till följande OAuth-autentiseringsuppgifter:

code language-bash 
OAUTH_CLIENT_ID=
OAUTH_CLIENT_SECRET=
OAUTH_TECHNICAL_ACCOUNT_ID=
OAUTH_TECHNICAL_ACCOUNT_EMAIL=
OAUTH_ORG_ID=

Kopiera dessa värden från sidan Credential details i Developer Console genom att klicka på fliken OAuth Server-to-Server på arbetsytan.

Autentiseringssidan för OAuth Server-till-Server i Adobe Developer Console {width="600" modal="regular"}

Lägg till Commerce-konfigurationen

Lägg till följande Commerce-instansinformation i din .env-fil:

code language-bash 
COMMERCE_BASE_URL=
COMMERCE_GRAPHQL_ENDPOINT=

Så här hittar du dessa värden:

  1. Navigera till Commerce Cloud Service-instanser.
  2. Klicka på informationsikonen bredvid instansen.
  3. Kopiera REST-slutpunkten som COMMERCE_BASE_URL.
  4. Kopiera GraphQL-slutpunkten som COMMERCE_GRAPHQL_ENDPOINT.

Ange händelseprefix

Ange ett tillfälligt värde för händelseprefixet:

code language-bash 
EVENT_PREFIX=test

Hämta arbetsytans konfiguration

Kör följande kommando för att hämta arbetsytans konfigurationsfil:

code language-bash 
aio console workspace download workspace.json

Kopiera arbetsytans konfigurationsfil till katalogen scripts:

code language-bash 
cp workspace.json scripts/

Ansluta den lokala arbetsytan till fjärrarbetsytan

Länka ditt lokala projekt till den fjärranslutna arbetsytan:

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

Terminalen visar en lyckad arbetsyteanslutning med AIR-appkommandot ​ {width="600" modal="regular"}

Startpaket för utcheckning

Ansluta den lokala arbetsytan till fjärrarbetsytan

Länka det lokala projektet till fjärrarbetsytan. Kör från projektets rot (mappen extension):

code language-bash 
aio app use --merge

När du uppmanas till det väljer du det alternativ som använder den organisation, det projekt och den arbetsyta du valde när du konfigurerade Adobe I/O CLI. Detta skriver arbetsytans konfiguration i programmet så att den arbetsytan används vid distributionen och den lokala utvecklingen.

Terminalen visar en lyckad arbetsyteanslutning med AIR-appkommandot ​ {width="600" modal="regular"}

Installera AI-verktygen för utökningsbarhet

Den här processen skapar MCP-konfigurationen (.<agent>/mcp.json), kompetenskatalogen (.<agent>/skills/) och lägger till AGENTS.md i projektets rot. Du uppmanas att välja ett startpaket, en kodningsagent och en pakethanterare.

  1. Konfigurera AI-stödda utvecklingsverktyg i mappen extension med följande kommandon:

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

    Terminal som visar AI-verktyg för utökningsverktyg för att konfigurera utdata {width="600" modal="regular"}

  2. När installationen är klar startar du om kodningsagenten så att den kan läsa in de nya MCP-verktygen och -kunskaperna. Commerce App Builder-verktygen finns nu i din miljö.

    note note
    NOTE
    Om du ser ett varningsmeddelande om att inga kunskaper hittades för startpaketet gick något fel. Det beror ofta på att konfigurationen kördes i en annan mapp än där startsatsen klonades. Kör aio commerce extensibility tools-setup från mappen extension (startkit-projektroten) och välj rätt startkit när du uppmanas till detta.

    Terminal som visar konfiguration av AI-utökningsverktyg med utcheckningsstartsverktyget valt {width="600" modal="regular"}

Krav för Storefront

Följande objekt krävs för att slutföra avsnittet storefront i självstudiekursen Ratings extension och visa produktbetyg i din butik.

Klona butiksarkivet

Öppna terminalen och klona databasen:

git clone --branch agentic-dev https://github.com/hlxsites/aem-boilerplate-commerce.git storefront
cd storefront

Installera beroenden

Installera projektberoenden:

npm install

Installera storefront AI-verktygen

Konfigurera AI-stödda utvecklingsverktyg i mappen storefront. Kör följande kommando från roten i mallprojektet:

aio commerce extensibility tools-setup

Kommandot visar två instruktioner:

  1. Välj ett startpaket - Välj AEM-standardpaket för Commerce.

  2. Välj din kodningsagent - Välj din agent i listan med agenter som stöds.

Kommandot installerar @adobe-commerce/commerce-extensibility-tools-paketet som ett dev-beroende, kopierar kunskapsfilerna till din agentes kunskapsregister och konfigurerar MCP (Model Context Protocol) så att din agent får tillgång till sökverktygen i Commerce-dokumentationen.

recommendation-more-help
0961bf7c-1df8-4da1-8be1-cb5465eed8fb