Verktyg för AI-kodningsutvecklare för Adobe Commerce App Builder
När du migrerar till Adobe Commerce as a Cloud Service kan du använda AI-kodningsverktygen för att konvertera befintliga Adobe Commerce PHP-tillägg till Adobe Developer App Builder-program. Du kan också använda de här verktygen för att skapa nya App Builder-program.
AI-kodningsverktygen ger följande fördelar:
- Förbättrat utvecklingsarbetsflöde: Integrerade Adobe Commerce-utvecklingsverktyg.
- AI-baserad hjälp: Kontextmedveten kodgenerering och felsökning.
- Commerce-specifika funktioner: Specialiserade verktyg för Adobe Commerce App Builder-utveckling.
- Automatiska arbetsflöden: Effektivare utvecklings- och distributionsprocesser.
Genom att installera AI-kodningsverktygen får du tillgång till:
- Kompetens - En Adobe Commerce- och App Builder-specifik färdighetsuppsättning som är utformad för att vägleda och informera programutvecklingen.
- Developer MCP Server
- App Builder MCP Server
Uppdaterar till den senaste versionen
När du har installerat utvecklingsverktyget för AI-kodning kan du uppdatera till den senaste versionen genom att köra följande kommando:
aio commerce extensibility tools-setup
Verktygen uppdateras till den senaste versionen.
Förutsättningar
-
Alla kodningsagenter som stöder agentfärdigheter, till exempel:
-
Node.js: LTS-version
-
Git: För databaskloning och versionskontroll
Installation
-
Installera den senaste Adobe I/O CLI globalt:
code language-bash npm install -g @adobe/aio-cli -
Installera följande plugin-program:
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 -
Klona något av följande:
-
Commerce integreringsstartkit - för att skapa integration med andra avdelningar.
code language-bash git clone git@github.com:adobe/commerce-integration-starter-kit.git -
Commerce startpaket för utcheckning för att skapa eller utöka utcheckningsupplevelsen, inklusive betalningar, frakt och skatter.
code language-bash git clone git@github.com:adobe/commerce-checkout-starter-kit.git
-
-
Gå till startpaketkatalogen:
code language-bash cd commerce-integration-starter-kit -
Installera Commerce AI-utökningsverktygen genom att köra det interaktiva installationskommandot:
code language-bash aio commerce extensibility tools-setupInstallationsprocessen uppmanar dig med konfigurationsalternativ. Följ anvisningarna för att slutföra installationen. Verktygen installeras i den valda katalogen.
-
Välj det startpaket som du vill använda för ditt projekt.
code language-shell-session ? Which starter kit would you like to use? ❯ Integration starter kit Checkout starter kit -
Välj den kodningsagent du vill använda. Mer än 40 kodningsagenter stöds, men om du inte ser din favoritagent kan du använda alternativet
Otherför att installera kunskaper för alla kodningsagenter. I dokumentationen för kodningsagenten finns instruktioner om hur du konfigurerar kunskaperna.code language-shell-session ? Which coding agent would you like to install skills for? ❯ Cursor Claude Code GithubCopilot Windsurf Gemini CLI OpenAI Codex Cline ... -
Installationsprogrammet identifierar om du har installerat NPM eller Garn och gör rätt val automatiskt. Om du inte har installerat någon av dem uppmanas du att välja en pakethanterare. Adobe rekommenderar att du använder
npmför att få en konsekvent inställning:code language-shell-session ? Which package manager would you like to use? ❯ npm yarn
-
-
När kodningsverktygen har installerats konfigureras följande under installationen:
- MCP-serverintegration för Adobe Commerce-utveckling
- Agentfärdigheter för förbättrad utvecklingsupplevelse
- Commerce-specifika utvecklingsverktyg och arbetsflöden
Kunskaps- och MCP-verktygen är nu installerade. Om du inte ser kunskaperna och MCP-verktygen startar du om kodningsagenten.
- Logga in på Adobe Developer Console med Adobe I/O CLI.
- Skapa ett App Builder-projekt (se Projektinställningar).
- Konfigurera miljövariabler i en
.env-fil.
Konfiguration efter installation
Logga in på Adobe I/O CLI
När du har installerat Adobe I/O CLI måste du logga in när du vill använda MCP-servern.
aio auth login
Kör följande kommando för att verifiera att du är inloggad:
aio where
Om du råkar ut för problem provar du med att logga ut och logga in igen:
aio auth logout
aio auth login
Markör
-
Starta om markörutvecklingsmiljön för att läsa in de nya MCP-verktygen och konfigurationen.
-
Verifiera installationen genom att bekräfta att det finns kunskaper i mappen
.cursor/skills/. -
Aktivera MCP-servern:
- Öppna MCP-inställningarna för markören med Cmd+Skift+P (macOS) eller Ctrl+Skift+P (Windows och Linux).
- Typ Visa: Öppna MCP-inställningar
- Leta upp Commerce-extensibility MCP Server i listan
- Aktivera kodningsverktygen genom att växla servern PÅ
-
Kontrollera serverstatusen - Commerce Extensibility MCP Server ska visas som:
code language-shell-session Status: Connected/Active Server: commerce-extensibility Configuration: Automatically configured via .cursor/mcp.json -
Använd följande uppmaning för att se om agenten använder MCP-servern. Om så inte är fallet ber du agenten uttryckligen att använda de tillgängliga MCP-verktygen.
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?
Copilot
-
Starta om Visual Studio Code för att läsa in de nya MCP-verktygen och konfigurationen.
-
Kontrollera installationen genom att bekräfta att filen
copilot-instructions.mdfinns i mappen.github. -
Aktivera MCP-servern:
- Öppna panelen Tillägg genom att klicka på ikonen Tillägg i aktivitetsfältet till vänster eller genom att använda Cmd+Skift+X (macOS) eller Ctrl+Skift+X (Windows och Linux).
- Klicka på MCP-SERVRAR - INSTALLERADE.
- Klicka på kugghjulsikonen bredvid Commerce-extensibility MCP Server och välj Start Server om servern stoppas.
- Klicka på kugghjulsikonen igen och välj Visa utdata.
-
Kontrollera serverstatusen.
MCP:commerce-extensibility-utdata ska matcha följande: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 -
Använd följande uppmaning för att se om agenten använder MCP-servern. Om så inte är fallet ber du agenten uttryckligen att använda de tillgängliga MCP-verktygen.
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?
Exempelfråga
I följande exempelfråga används startsatsen för integrering för att skapa ett program som skickar meddelanden när en beställning görs.
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
I följande exempelfråga används startsatsen för utcheckning för att skapa ett program med anpassade leveransmetoder.
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"
Fråga om kommandon
Förutom att fråga kan du använda kommandot /search-commerce-docs för att söka efter dokumentation i konversationer med din agent. Exempel:
/search-commerce-docs "How do I subscribe to Commerce events?"
Kompetens
Kunskaperna anropas automatiskt när du chattar med din kodningsagent, men du kan även anropa dem manuellt med följande kommandon:
/architect- Designar arkitektur för Adobe Commerce-tillägg med App Builder och det valda startpaketet. Använd när du planerar integreringar, väljer händelser, utformar dataflöden eller fattar arkitektoniska beslut./developer- Implementerar Adobe Commerce-tillägg efter App Builder mönster och filstrukturen. Använd detta när du genererar kod, uppdaterar konfigurationsfiler eller implementerar körningsåtgärder./devops-engineer- Distribuerar och kör App Builder tillägg. Använd detta när du distribuerar program, konfigurerar miljöer, felsöker installationsproblem, konfigurerar CI/CD eller åtgärdar introduktionsfel./product-manager- Samlar in dokumentkrav för Adobe Commerce-tillägg. Använd när du startar ett nytt projekt, definierar acceptanskriterier, förtydligar affärsmål eller skaparREQUIREMENTS.md-dokumentation./technical-writer- Skapar omfattande dokumentation för App Builder-program. Använd när du skriverREADME.md, användarhandböcker, API-dokumentation, ändringsloggar eller säkerställer att dokumentationen är fullständig./tester- Skapar omfattande tester för App Builder program. Använd när du skriver enhetstester, integrationstester, validerar säkerheten eller säkerställer kodkvalitet och täckning./tutor(experimentellt) - Undervisar Adobe Commerce programutvecklingskoncept med tydliga förklaringar och exempel. Använd när du lär dig App Builder, förstår händelser eller behöver vägledning om utvecklingsmönster.
Bästa praxis
Adobe rekommenderar att du följer följande metodtips när du använder AI-kodningsverktygen:
Planeringsläge
När du chattar med din kodningsagent bör du välja läget Planera för att skapa en detaljerad implementeringsplan för ditt projekt.
Metoden för att välja Planera-läge varierar beroende på vilken agent du använder. Instruktioner finns i agentens dokumentation. Exempel:
Checklista
Innan du startar en utvecklingssession:
- Sök efter
REQUIREMENTS.md - Kontrollera att MCP-verktygen fungerar
- Granska den aktuella fasen och målen
- Börja med exempelkod eller skräddarsydda projekt
Under utvecklingen:
- Lita på det fyrfasade protokollet
- Begär implementeringsplaner för komplex utveckling
- Använd MCP-verktyg när de är tillgängliga
- Testa varje funktion efter implementering
- Testa lokalt först, distribuera och testa igen
- Utnyttja kodningsverktygen för att testa stödet
- Onödig komplexitet
- Driftsätt stegvis för snabbare utveckling
När du startar en ny chatt:
- Ge rätt sessionsöverlämning
- Referensnyckelfiler med
@ - Ange tydliga mål för sessionen
- Använd fasbaserade gränser
Arbetsflöde
När du utvecklar med AI-kodningsverktygen börjar du med exempelkod eller med skräddarsydda projekt. Med den här metoden kan du bygga på en stabil grund i stället för att börja från ingenting, samtidigt som du optimerar arbetsflödet för AI-utveckling.
På så sätt kan du också utnyttja Adobe mallar och bygga vidare på beprövade mönster och arkitekturer, samtidigt som du behåller etablerade katalogstrukturer och konventioner.
Se följande resurser för att komma igång:
Därför bör du använda dessa resurser
- Beprövade mönster: Startpaket innehåller Adobe bästa praxis och arkitektoniska beslut
- Snabbare utveckling: Minskar tiden för mallplåt och konfiguration
- Konsekvens: Ser till att programmet följer etablerade konventioner
- Underhållbarhet: Enklare att underhålla och uppdatera när du följer standardmönster
- Dokumentation: Startpaket innehåller exempel och dokumentation
- Community-stöd: Det är enklare att få hjälp när du använder standardstrategier
- AI-kontexteffektivitet: Använd välbekanta mönster och strukturer för att arbeta med, minska behovet av omfattande förklaringar och förbättra exaktheten vid kodgenerering
- Minskad tokenanvändning: Referera till befintliga mönster i stället för att generera allt från början, vilket leder till effektivare konversationer och färre kontextsammanfattningar
Protokoll
Följande fyrfasprotokoll används automatiskt av de installerade kunskaperna. Verktygen bör följa detta protokoll automatiskt när de utvecklar program:
- Fas 1: Analys och förtydligande av kraven
- Lämna fullständiga svar när ni får frågan om hur ni ska klargöra frågorna.
- Fas 2: Arkitekturplanering och användargodkännande
- Granska planen noggrant innan du godkänner den.
- Fas 3: Kodgenerering och implementering
- Fas 4: Dokumentation och validering
Begär implementeringsplaner för komplex utveckling
För komplex utveckling som innefattar flera runtime-åtgärder, kontaktytor eller integreringar, krävs uttryckligen att AI-verktygen skapar en detaljerad implementeringsplan. När du ser en plan på hög nivå i fas 2 som omfattar flera komponenter ber du om en detaljerad implementeringsplan för att dela upp den i hanterbara uppgifter:
Create a detailed implementation plan for this complex development.
Komplexa Adobe Commerce-program omfattar ofta:
- Flera körningsåtgärder
- Händelsekonfiguration över flera kontaktytor
- Integrering med externa system
- Krav på statshantering
- Testa i flera komponenter
Använd MCP-verktyg
Som standard används MCP-verktyg, men i vissa fall kan CLI-kommandon användas. För att vara säker på att MCP-verktygen används, begär du dem uttryckligen i uppmaningen.
Om CLI-kommandon används och du vill använda MCP-verktygen i stället, ska du göra så här:
Use only MCP tools and not CLI commands
- MCP-verktyg: aio-app-deploy, aio-app-dev, aio-dev-invoke
- CLI-kommandon: aio app deployment, aio app dev
CLI-kommandon kan användas för följande scenarier:
- Komplexa driftsättningsscenarier
- Felsöka specifika problem
- När MCP-verktyg har begränsningar
- Engångsoperationer som inte drar nytta av MCP-integrering
Utveckling
Frågar onödig komplexitet som skapats med AI-verktygen.
När onödiga filer läggs till (validator.js, transformer.js, sender.js) för enkla skrivskyddade slutpunkter ska du följa följande anvisningar:
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
Testning
Använd följande metodtips vid testning:
Testa varje funktion efter implementering
När du är klar med utvecklingen av en funktion i din implementeringsplan ska du testa den omedelbart. Tidig testning förhindrar sammansatta problem och gör felsökningen enklare.
- Vänta inte tills alla funktioner har slutförts
- Testa stegvis för att fånga upp problem tidigt
- Validera funktionaliteten innan du går till nästa funktion
Testa lokalt först
Testa alltid lokalt först med verktyget aio-app-dev. Detta ger omedelbar feedback och möjliggör snabbare iterationscykler, enklare felsökning och inga driftsättningsförluster.
-
Starta lokal utvecklingsserver:
code language-bash aio-app-dev -
Testa åtgärder lokalt:
code language-bash aio-dev-invoke action-name --parameters '{"test": "data"}'
Distribuera och testa igen
När den lokala testningen har slutförts distribueras och testas den i körningsmiljön. Körningsmiljöer kan ha andra beteenden än lokal utveckling.
-
Distribuera till körningsversion:
code language-bash aio-app-deploy -
Testa distribuerade åtgärder
-
Använd webbläsare eller direkt HTTP-begäran
-
Kontrollera aktiveringsloggar för felsökning
Utnyttja kodningsverktygen för att testa stödet
Be om hjälp med testning. Verktygen kan hjälpa dig med felsökning, logganalys och att skapa lämpliga testdata för specifika körningsåtgärder.
Testa körningsåtgärder:
Help me test the customer-created runtime action running locally
Felsökning:
Why did the subscription-updated runtime action activation fail?
Kontrollera loggar:
Help me check the logs for the last stock-monitoring runtime action invocation
Skapa testnyttolaster:
Generate test data for this Commerce event
Create a test payload for the customer_save_after event
Sök efter körningsslutpunkter:
What's the URL for this deployed action?
Hantera autentisering:
How do I authenticate with this external API?
Felsök:
Help me debug why this action is returning 500 errors
Felsökning
Stoppa och utvärdera när saker och ting går fel. Om du stöter på problem:
- Stoppa och utvärdera - Fortsätt inte i ett brutet läge
- Kontrollera loggar - Använd aktiveringsloggar för att identifiera problem
- Förenkla - Ta bort komplexitet för att isolera problem
- Testa stegvis - Åtgärda ett problem i taget
- Validera - Testa varje korrigering innan du fortsätter
Distribution
Använd följande metodtips vid distribution:
Driftsätt stegvis
Driftsätt endast ändrade åtgärder för att snabba upp utvecklingen. Detta minskar risken för att befintliga funktioner bryts och ger snabbare feedback på ändringar.
-
Använd MCP-verktyg för att distribuera specifika åtgärder
code language-bash aio-app-deploy --actions action-name -
Distribuera enskilda åtgärder efter lokal testning
-
Driftsätt stegvis och undvik fullständig driftsättning under utvecklingen
Rensning vid körning
Efter större förändringar kan du använda verktygen för att rensa bort överblivna händelser. Låt AI-verktygen hantera rensningsprocessen systematiskt. Programmet kan effektivt identifiera överblivna åtgärder, verifiera deras status och säkert ta bort dem utan manuell åtgärd.
Help me identify and clean up orphaned runtime actions
Begär AI-verktygen för att lista distribuerade åtgärder och identifiera oanvända åtgärder
List all deployed actions and identify which ones are no longer needed
Låt AI-verktygen ta bort överblivna åtgärder med lämpliga kommandon
Remove the orphaned actions that are no longer part of the current implementation
Övervakning
Använd följande metodtips när du övervakar programmet:
Håll utkik efter sammanhangsbaserade kvalitetsindikatorer
- Bra kontext: AI kommer ihåg senaste beslut, refererar till korrekta filer
- Dålig kontext: AI frågar efter tidigare tillhandahållen information, upprepar lösta problem
Spåra utvecklingshastighet
- Hög hastighet: Tydliga framsteg, minimalt klargörande krävs
- Låg hastighet: Upprepade förklaringar, AI-förvirring, långsamma förlopp
Övervaka kostnadseffektivitet
Spåra användningsmönster för token:
- Effektiv: Låg tokenanvändning, få kontextsammanfattningar
- Ineffektiv: Hög tokenanvändning, flera sammanfattningar, upprepat arbete
Vad du ska undvika
Undvik följande mönster när du använder AI-kodningsverktygen:
- Hoppa inte över klargörandefasen - Se alltid till att fas 1 slutförs före implementeringen.
- Hoppa inte över testning efter varje funktion - Testa stegvis, vänta inte tills allt är klart.
- Komplexitet behöver inte läggas till utan rotorsaksanalys - Fråga om onödiga filtillägg och begär en korrekt utredning.
- Deklarera inte lyckade utan riktig datatestning - Testa alltid med verkliga data, inte bara kantfall.
- Glöm inte rensning vid körning - Rensa alltid bort överblivna åtgärder efter större ändringar.
Ge feedback
Utvecklare som är intresserade av att lämna feedback om AI-kodningsverktygen kan använda kommandot /feedback.
Med det här kommandot kan du ge feedback och skicka loggar till Adobe. Alla loggar du skickar saneras för att ta bort privat eller personlig information.
-
Skriv
/feedbacki din agent och välj kommandotcommerce-extensibility/feedback. -
Ge din feedback för verktygen i fältet Feedback som visas högst upp i IDE och tryck på Retur .
{width="600" modal="regular"}
-
I fältet Spara lokalt skriver du antingen
yesellernooch trycker på Retur för att ange om du vill spara en lokal kopia av loggarna. {width="600" modal="regular"}
Om du har valt Ja kan du granska loggarna i mappen
chatsnär du har skickat din feedback. -
Kommandot
commerce-extensibility/feedbackvisas i agentens chattinmatningsfält. Tryck på Enter eller klicka på Skicka för att skicka din feedback till Adobe.
/feedback kan du behöva uppdatera till den senaste versionen.