Gereedschap voor AI-codeontwikkelaars voor Adobe Commerce App Builder
Wanneer u naar Adobe Commerce as a Cloud Service migreert, kunt u de AI-coderingsgereedschappen gebruiken om bestaande Adobe Commerce PHP-extensies om te zetten in Adobe Developer App Builder -toepassingen. U kunt deze gereedschappen ook gebruiken om nieuwe App Builder -toepassingen te maken.
De AI-coderingsgereedschappen bieden de volgende voordelen:
- Verbeterde ontwikkelingswerkschema: Geïntegreerde de ontwikkelingshulpmiddelen van Adobe Commerce.
- op AI-Gerichte hulp: Contextbewuste codegeneratie en het zuiveren.
- Commerce-specifieke eigenschappen: Gespecialiseerde hulpmiddelen voor de ontwikkeling van Adobe Commerce App Builder.
- Geautomatiseerde werkschema's: Gestroomlijnde ontwikkeling en plaatsingsprocessen.
Als u de AI-coderingsgereedschappen installeert, hebt u toegang tot:
- Vaardigheden - Een specifieke Adobe Commerce- en App Builder-vaardigheden die zijn ontworpen om uw toepassingsontwikkeling te begeleiden en te informeren.
- Developer MCP Server
- App Builder MCP Server
Bijwerken naar de meest recente versie
Na het installeren van het hulpmiddel van de AI codeerontwikkelaar , kunt u aan de recentste versie bijwerken door het volgende bevel in werking te stellen:
aio commerce extensibility tools-setup
Hiermee worden de gereedschappen bijgewerkt naar de nieuwste versie.
Vereisten
-
Om het even welke coderingsagent die agentenvaardigheden steunt, zoals:
-
Node.js : De versie van LTS
-
Git : Voor bewaarplaats het klonen en versiecontrole
Installatie
-
Installeer de recentste CLI van Adobe I/O globaal:
code language-bash npm install -g @adobe/aio-cli -
Installeer de volgende plug-ins:
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 -
Kies een van de volgende opties:
-
Commerce integratiestartkit - voor de bouw van rug-bureau integratie.
code language-bash git clone git@github.com:adobe/commerce-integration-starter-kit.git -
Commerce checkout starter kit voor de bouw van of het uitbreiden van de controleervaring, met inbegrip van betalingen, het verschepen, en belastingen.
code language-bash git clone git@github.com:adobe/commerce-checkout-starter-kit.git
-
-
Navigeer naar de startmap:
code language-bash cd commerce-integration-starter-kit -
Installeer de Commerce AI-uitbreidbaarheidsprogramma's met de interactieve instellingsopdracht:
code language-bash aio commerce extensibility tools-setupHet installatieproces vraagt u om configuratieopties. Volg de aanwijzingen om de installatie te voltooien. De gereedschappen worden in de geselecteerde map geïnstalleerd.
-
Selecteer de startkit die u voor uw project wilt gebruiken.
code language-shell-session ? Which starter kit would you like to use? ❯ Integration starter kit Checkout starter kit -
Selecteer de gewenste coderingsagent. Meer dan 40 coderingsagenten worden gesteund, maar als u uw aangewezen agent niet ziet, kunt u de
Otheroptie gebruiken om vaardigheden voor om het even welke coderingsagent te installeren. Verwijs naar de documentatie van uw coderingsagent voor instructies op hoe te om de vaardigheden te vormen.code language-shell-session ? Which coding agent would you like to install skills for? ❯ Cursor Claude Code GithubCopilot Windsurf Gemini CLI OpenAI Codex Cline ... -
Het installatieprogramma gaat na of NPM of Yarn is geïnstalleerd en selecteert automatisch de gewenste optie. Als u echter geen van beide hebt geïnstalleerd, wordt u gevraagd om uw pakketbeheer te selecteren, raadt Adobe u aan
npmte gebruiken voor consistentie:code language-shell-session ? Which package manager would you like to use? ❯ npm yarn
-
-
Nadat de coderingsgereedschappen zijn geïnstalleerd, wordt het installatieproces geconfigureerd:
- Integratie van MCP-servers voor Adobe Commerce-ontwikkeling
- de vaardigheden van de Agent voor verbeterde ontwikkelingservaring
- Commerce-specifieke ontwikkelingsinstrumenten en -workflows
De vaardigheden en hulpmiddelen MCP zijn nu geïnstalleerd. Als u niet de vaardigheden en hulpmiddelen MCP ziet, begin uw coderingsagent opnieuw.
- Login aan Adobe Developer Console gebruikend Adobe I/O CLI.
- Creeer een project van App Builder (zie de opstelling van het Project ).
- Omgevingsvariabelen instellen in een
.env-bestand.
Configuratie na installatie
Aanmelden bij de Adobe I/O CLI
Nadat u Adobe I/O CLI hebt geïnstalleerd, moet u zich op elk gewenst moment aanmelden bij de MCP-server.
aio auth login
Voer de volgende opdracht uit om te controleren of u bent aangemeld:
aio where
Als u problemen tegenkomt, probeert u zich af te melden en zich weer aan te melden:
aio auth logout
aio auth login
Cursor
-
Begin winde van de Curseur opnieuw om de nieuwe hulpmiddelen MCP en de configuratie te laden.
-
Controleer de installatie door te bevestigen dat de vaardigheden aanwezig zijn in de map
.cursor/skills/. -
Schakel de MCP-server in:
- Open de Montages van de Curseur MCP gebruikend Cmd+Shift+P (macOS) of Ctrl+Shift+P (Vensters en Linux).
- Type Mening: Open Montages MCP
- Plaats handel-rekbaarheid MCP Server in de lijst
- Wissel de server AAN om de coderingshulpmiddelen toe te laten
-
Verifieer de serverstatus - de uitbreidbaarheid MCP van Commerce zou als moeten verschijnen:
code language-shell-session Status: Connected/Active Server: commerce-extensibility Configuration: Automatically configured via .cursor/mcp.json -
Gebruik de volgende herinnering om te zien of gebruikt de agent de server MCP. Als het niet, vraag de agent uitdrukkelijk om de beschikbare hulpmiddelen MCP te gebruiken.
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
-
Start Visual Studio Code opnieuw om de nieuwe MCP-gereedschappen en -configuratie te laden.
-
Controleer de installatie door te bevestigen dat het
copilot-instructions.md-bestand bestaat in de map.github. -
Schakel de MCP-server in:
- Open het Comité van Uitbreidingen door het pictogram van Uitbreidingen in de bar van de Activiteit op linkerzijbalk te klikken of door Cmd+Shift+X (macOs) of Ctrl+Shift+X (Vensters en Linux) te gebruiken.
- Klik MCP SERVERS - GEÏNSTALLEERD.
- Klik het tandwielpictogram naast handel-rekbaarheid MCP Server en selecteer de Server van het Begin, als de server wordt tegengehouden.
- Klik opnieuw het tandwielpictogram, en selecteer tonen Output.
-
Controleer de serverstatus. De uitvoer van
MCP:commerce-extensibilitymoet overeenkomen met het volgende: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 -
Gebruik de volgende herinnering om te zien of gebruikt de agent de server MCP. Als het niet, vraag de agent uitdrukkelijk om de beschikbare hulpmiddelen MCP te gebruiken.
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?
Voorbeeldprompt
De volgende voorbeeldherinnering gebruikt de integratiestartuitrusting om een toepassing tot stand te brengen om berichten te verzenden wanneer een orde wordt geplaatst.
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
In de volgende voorbeeldprompt wordt de startkit voor uitchecken gebruikt om een toepassing te maken die aangepaste verzendmethoden biedt.
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"
Opdrachten Vragen
Naast het vragen, kunt u het /search-commerce-docs bevel gebruiken om documentatie in gesprekken met uw agent te zoeken. Bijvoorbeeld:
/search-commerce-docs "How do I subscribe to Commerce events?"
Vaardigheden
Terwijl de vaardigheden automatisch zullen worden aangehaald wanneer u met uw coderingsagent babbelt, kunt u hen manueel ook aanhalen gebruikend de volgende bevelen:
/architect- Ontwerpen de architectuur voor Adobe Commerce-extensies met behulp van App Builder en de geselecteerde startkit. Gebruik deze optie wanneer u integraties wilt plannen, gebeurtenissen wilt selecteren, gegevensstromen wilt ontwerpen of architecturale beslissingen wilt nemen./developer- Hiermee implementeert u Adobe Commerce-extensies volgens App Builder -patronen en de bestandsstructuur. Gebruik deze optie wanneer u code genereert, configuratiebestanden bijwerkt of runtimehandelingen implementeert./devops-engineer- Implementeert en voert App Builder -extensies uit. Gebruik bij het implementeren van toepassingen, het configureren van omgevingen, het oplossen van problemen met de implementatie, het instellen van CI/CD of het oplossen van instapfouten./product-manager- Verzamelt en documentenvereisten voor Adobe Commerce-extensies. Gebruik deze methode wanneer u een nieuw project start, acceptatiecriteria definieert, bedrijfsdoelstellingen verduidelijkt ofREQUIREMENTS.md-documentatie maakt./technical-writer- Maakt uitgebreide documentatie voor App Builder -toepassingen. Gebruik deze methode wanneer uREADME.mdschrijft, gebruikersgidsen, API-documentatie, wijzigingen of voor de volledigheid van de documentatie./tester- Maakt uitgebreide tests voor App Builder -toepassingen. Gebruik bij het schrijven van eenheidstests, integratietests, het bevestigen van veiligheid, of het verzekeren van codekwaliteit en dekking./tutor(experimenteel) - Leert de ontwikkelingsconcepten van Adobe Commerce -toepassingen met duidelijke uitleg en voorbeelden. Gebruik deze functie wanneer u App Builder leert, gebeurtenissen begrijpt of hulp nodig hebt bij het ontwikkelen van patronen.
Aanbevolen procedures
Adobe raadt u aan de volgende aanbevolen procedures toe te passen wanneer u de AI-coderingsgereedschappen gebruikt:
Abonnementsmodus
Wanneer het babbelen met uw coderende agent, zou u wijze van het Plan moeten selecteren om een gedetailleerd implementatieplan voor uw project tot stand te brengen.
De methode om wijze van het Plan te selecteren varieert afhankelijk van de agent u gebruikt. Raadpleeg de documentatie van uw agent voor instructies. Bijvoorbeeld:
Checklist
Voordat u een ontwikkelingssessie start:
- Controleren op
REQUIREMENTS.md - Controleren of MCP-gereedschappen werken
- Huidige fase en doelstellingen evalueren
- Beginnen met voorbeeldcode of basisprojecten
Tijdens de ontwikkeling:
- Vertrouw het vier-fase protocol
- Implementatieplannen aanvragen voor complexe ontwikkeling
- MCP-gereedschappen gebruiken indien beschikbaar
- Elke functie na implementatie testen
- Eerst lokaal testen, daarna implementeren en opnieuw testen
- Gebruik de coderingsgereedschappen voor testondersteuning
- Vraag om onnodige complexiteit
- Stapsgewijs implementeren voor snellere ontwikkeling
Bij het starten van nieuwe chat:
- Geef de juiste sessieafhandeling op
- Referentiesleutelbestanden met
@ - Duidelijke doelen voor de sessie instellen
- Op fasen gebaseerde grenzen gebruiken
Workflow
Wanneer het ontwikkelen met de AI codeerhulpmiddelen, begin met steekproefcode of gesteven projecten. Deze benadering zorgt ervoor dat u op een stevige stichting bouwt eerder dan van niets te beginnen, terwijl ook het optimaliseren van uw AI ontwikkelingswerkschema.
Hierdoor kunt u ook Adobe-sjablonen gebruiken en bouwen op beproefde patronen en architecturen, terwijl u de bestaande mappenstructuren en conventies behoudt.
Raadpleeg de volgende bronnen om aan de slag te gaan:
Waarom u deze middelen zou moeten gebruiken
- Bewezen patronen: De kits van de aanzet embody Adobe beste praktijken en architecturale besluiten
- Snellere ontwikkeling: Vermindert tijd besteed aan boilerplate en configuratie
- Consistentie: Zorgt ervoor uw toepassing gevestigde overeenkomsten volgt
- Handhaving: Gemakkelijker om te handhaven en bij te werken wanneer het volgen van standaardpatronen
- Documentatie: De kits van de aanzet komen met voorbeelden en documentatie
- Communautaire steun: Gemakkelijker om hulp te krijgen wanneer het gebruiken van standaardbenaderingen
- AI contextefficiency: Gebruik vertrouwde patronen en structuren om met te werken, verminderend de behoefte aan uitgebreide verklaringen en verbeterend de nauwkeurigheid van de codegeneratie
- Verminderd symbolisch gebruik: Verwijzing bestaande patronen in plaats van het produceren van alles van kras, die tot efficiëntere gesprekken en minder contextsamenvattingen leiden
Protocol
Het volgende vierfaseprotocol wordt automatisch afgedwongen door de geïnstalleerde vaardigheden. De hulpmiddelen zouden dit protocol automatisch moeten volgen wanneer het ontwikkelen van toepassingen:
- Fase 1: Analyse en verduidelijking van de eisen
- Geef volledige antwoorden op de gestelde vragen om de vragen te verduidelijken.
- Fase 2: Architectuurplanning en goedkeuring door de gebruiker
- Wanneer u een plan presenteert, moet u het zorgvuldig beoordelen voordat u het goedkeurt.
- Fase 3: Opstellen en uitvoeren van code
- Fase 4: Documentatie en validering
Implementatieplannen aanvragen voor complexe ontwikkeling
Voor complexe ontwikkeling met meerdere runtimeacties, aanraakpunten of integraties, moet u expliciet vragen dat de AI-gereedschappen een gedetailleerd implementatieplan maken. Wanneer u een plan op hoog niveau in Fase 2 ziet dat veelvoudige componenten impliceert, vraag om een gedetailleerd implementatieplan om het in handelbare taken neer te breken:
Create a detailed implementation plan for this complex development.
Complexe Adobe Commerce-toepassingen hebben vaak betrekking op:
- Meerdere runtimeacties
- De configuratie van de gebeurtenis over veelvoudige touchpoints
- Integratie met externe systemen
- Vereisten inzake staatsbeheer
- Testen op meerdere componenten
MCP-gereedschappen gebruiken
Het gereedschap is standaard ingesteld op MCP-gereedschappen, maar in bepaalde omstandigheden kan het in plaats daarvan CLI-opdrachten gebruiken. Om MCP hulpmiddelgebruik te verzekeren, verzoek uitdrukkelijk hen in uw herinnering.
Als u CLI bevelen ziet die en hulpmiddelen MCP in plaats daarvan willen gebruiken, gebruik de volgende herinnering:
Use only MCP tools and not CLI commands
- MCP-gereedschappen: aio-app-opstellen, aio-app-dev, aio-dev-invoke
- CLI-opdrachten: implementatie van een AIR-app, ontwikkelen van een AIR-app
CLI de bevelen kunnen voor de volgende scenario's worden gebruikt:
- Complexe implementatiescenario's
- Fouten opsporen in specifieke problemen
- Wanneer de hulpmiddelen MCP beperkingen hebben
- Eenmalige verrichtingen die niet van integratie MCP profiteren
Ontwikkeling
De onnodige ingewikkeldheid die door de hulpmiddelen van AI wordt gecreeerd.
Wanneer overbodige bestanden worden toegevoegd (validator.js , transformer.js , sender.js ) voor eenvoudige alleen-lezen eindpunten, volgt u de volgende aanwijzingen:
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
Testen
Gebruik de volgende aanbevolen procedures bij het testen:
Elke functie na implementatie testen
Nadat u de ontwikkeling van een functie in uw implementatieplan hebt voltooid, test u deze onmiddellijk. Het vroege testen voorkomt samengestelde kwesties en maakt het zuiveren gemakkelijker.
- Wacht niet tot alle functies zijn voltooid
- Test incrementeel om problemen vroeg op te vangen
- Functionaliteit valideren voordat u naar de volgende functie gaat
Eerst lokaal testen
Altijd eerst lokaal testen met het gereedschap aio-app-dev . Dit verstrekt direct terugkoppelt en staat voor snellere iteratiecycli, gemakkelijker het zuiveren, en geen plaatsingsoverheadkosten toe.
-
Start de lokale ontwikkelingsserver:
code language-bash aio-app-dev -
Handelingen lokaal testen:
code language-bash aio-dev-invoke action-name --parameters '{"test": "data"}'
Implementeren en opnieuw testen
Implementeer en test lokale tests in de runtimeomgeving als het lokale testen is gelukt. Runtimeomgevingen kunnen een ander gedrag hebben dan lokale ontwikkeling.
-
Distribueren naar runtime:
code language-bash aio-app-deploy -
Uitgevoerde acties testen
-
Webbrowser of directe HTTP-aanvragen gebruiken
-
Activeringslogboeken controleren voor foutopsporing
Gebruik de coderingsgereedschappen voor testondersteuning
Vraag om hulp bij het testen. De hulpmiddelen kunnen met het zuiveren, logboekanalyse, en het creëren van aangewezen testgegevens voor uw specifieke runtime acties helpen.
runtime van de Test acties:
Help me test the customer-created runtime action running locally
zuivert mislukkingen:
Why did the subscription-updated runtime action activation fail?
Logboeken van de Controle:
Help me check the logs for the last stock-monitoring runtime action invocation
creeer testlading:
Generate test data for this Commerce event
Create a test payload for the customer_save_after event
vind runtime eindpunten:
What's the URL for this deployed action?
handvatauthentificatie:
How do I authenticate with this external API?
los problemen op:
Help me debug why this action is returning 500 errors
Foutopsporing
Stoppen en beoordelen wanneer dingen fout gaan. Als er problemen optreden:
- Stoppen en beoordelen - Ga niet door in een gebroken toestand
- Logbestanden controleren - Activeringslogboeken gebruiken om problemen op te sporen
- Vereenvoudigen - Complexiteit verwijderen om problemen te isoleren
- Stapsgewijs testen - Eén probleem tegelijk verhelpen
- Valideren - test elke oplossing voordat u verdergaat
Implementatie
Gebruik de volgende beste praktijken wanneer het opstellen:
Stapsgewijs implementeren
Implementeer alleen gewijzigde acties om de ontwikkeling te versnellen. Deze benadering vermindert het risico van het breken van bestaande functionaliteit en verstrekt snellere terugkoppelen op veranderingen.
-
Gebruik hulpmiddelen MCP om specifieke acties op te stellen
code language-bash aio-app-deploy --actions action-name -
Afzonderlijke acties implementeren na lokale tests
-
Stapsgewijs implementeren en volledige implementatie van toepassingen tijdens de ontwikkeling vermijden
Opschonen van runtime
Na grote wijzigingen kunt u de gereedschappen gebruiken om zwevende handelingen op te schonen. De AI-gereedschappen systematisch laten werken met het opschoonproces. Het kan op efficiënte wijze de zwevende handelingen identificeren, hun status controleren en ze veilig verwijderen zonder handmatige tussenkomst.
Help me identify and clean up orphaned runtime actions
Vraag de AI-gereedschappen om geïmplementeerde acties weer te geven en ongebruikte acties te identificeren
List all deployed actions and identify which ones are no longer needed
AI-gereedschappen de zwevende handelingen laten verwijderen met de juiste opdrachten
Remove the orphaned actions that are no longer part of the current implementation
Toezicht
Gebruik de volgende aanbevolen procedures voor het controleren van uw toepassing:
Controle op contextkwaliteitsindicatoren
- Goede context: AI herinnert recente besluiten, verwijzingen correcte dossiers
- Arme context: AI vraagt om eerder verstrekte info, herhaalt opgeloste kwesties
Snelheid voor spoorontwikkeling
- Hoge snelheid: Duidelijke vooruitgang, minimale verduidelijking nodig
- Lage snelheid: Herhaalde verklaringen, AI verwarring, langzame vooruitgang
Kostenefficiëntie bewaken
Gebruikspatronen voor token bijhouden:
- Efficiënt: Laag symbolisch gebruik, weinig contextsamenvattingen
- Inefficiënt: Hoog symbolisch gebruik, veelvoudige samenvattingen, herhaald werk
Wat te vermijden
Vermijd de volgende anti-patronen wanneer het gebruiken van de AI codeerhulpmiddelen:
- overslaat niet de verklaringsfase - altijd verzekert Fase 1 vóór implementatie wordt voltooid.
- slaat het testen na elke eigenschap niet over - test incrementeel, wacht niet tot alles volledig is.
- voeg geen ingewikkeldheid zonder de analyse van de worteloorzaak toe - vraag onnodige dossiertoevoegingen en verzoek behoorlijk onderzoek.
- verklaart geen succes zonder echte gegevens het testen - altijd test met daadwerkelijke gegevens, niet enkel randgevallen.
- vergeet runtime schoonmaakbeurt niet - schoon altijd orphaned acties na belangrijke veranderingen.
Feedback geven
Ontwikkelaars die geïnteresseerd zijn in het geven van feedback over de AI-coderingsgereedschappen, kunnen de opdracht /feedback gebruiken.
Met deze opdracht kunt u feedback geven op tekst en logbestanden verzenden naar Adobe. Alle logbestanden die u verzendt, worden ontsmet om persoonlijke of persoonlijke gegevens te verwijderen.
-
Typ
/feedbackin de agent en selecteer de opdrachtcommerce-extensibility/feedback. -
Verstrek uw terugkoppel voor het hulpmiddel op het terugkoppelen gebied dat bij de bovenkant van winde verschijnt en druk binnengaan sleutel.
{width="600" modal="regular"}
-
Op sparen Lokaal gebied, type of
yesofnoen druk binnengaan om erop te wijzen als u een lokaal exemplaar van uw logboeken wilt bewaren. {width="600" modal="regular"}
Als u ja selecteerde, kunt u de logboeken in uw
chatsomslag herzien na het verzenden van uw terugkoppelt. -
De opdracht
commerce-extensibility/feedbackwordt weergegeven in het veld voor chatinvoer van de agent. De pers gaat binnen of klikt verzendt om uw te verzenden terugkoppelt aan Adobe.
/feedback bevel ziet, kunt u aan update aan de recentste versie moeten.