DocumentaciónCommerceAdobe Commerce as a Cloud Service

Requisitos previos del tutorial

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

Creado para:

  • Intermedio
  • Desarrollador

En esta página se enumeran los requisitos previos y los pasos de configuración de Adobe Commerce as a Cloud Service tutoriales, como el tutorial de extensión de clasificaciones y el tutorial de extensión de método de envío.

Requisitos previos de Adobe Commerce as a Cloud Service

  • Instalar Adobe I/O CLI

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

  • Instale los complementos Adobe I/O CLI Commerce, Adobe I/O CLI Runtime y 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

  • Descargue un IDE asistido por IA, como Cursor (recomendado), otros IDE, como Claude Code, Gemini CLI o Copilot también son compatibles, pero podrían requerir modificaciones en las indicaciones y otros pasos en el tutorial.

Requisitos previos de Adobe Developer Console

  1. Vaya a Adobe Developer Console.
  2. Inicie sesión con su correo electrónico y contraseña.

Creación de un nuevo proyecto

  1. Vaya a Adobe Developer Console.

  2. Haga clic en Crear proyecto a partir de una plantilla.

  3. Seleccione la plantilla App Builder.

  4. Escriba un Título de proyecto y Nombre de aplicación.

  5. Asegúrese de que la casilla de verificación Include Runtime esté marcada.

    Creación de proyecto de Adobe Developer Console con la plantilla de App Builder seleccionada {width="600" modal="regular"}

  6. Haga clic en Guardar.

Añadir API al espacio de trabajo

  1. Haga clic en el área de trabajo Stage y, a continuación, repita los pasos siguientes para cada API.

    Espacio de trabajo de fase con la opción Agregar servicio para las API {width="600" modal="regular"}

  2. Haga clic en Agregar servicio y seleccione API.

  3. Seleccione una de las siguientes API. Deberá repetir este proceso para cada API enumerada a continuación:

    • Filtro de Adobe Services:

      • API de administración de E/S
      • API Eventos de E/S

    • Filtro Experience Cloud:

      • API de Adobe I/O Events for Adobe Commerce

  4. Haga clic en Siguiente.

  5. Haga clic en Guardar API configurada.

  6. Repita los pasos anteriores hasta que todas las API se agreguen al espacio de trabajo.

    Workspace muestra todas las API requeridas agregadas correctamente {width="600" modal="regular"}

Configuración de la CLI de Adobe I/O

  1. Borre cualquier configuración existente:

    code language-bash 
    aio config clear

    Iniciar sesión con Adobe I/O CLI:

    code language-bash 
    aio auth login -f

  2. Seleccione su organización, proyecto y espacio de trabajo con cada uno de los siguientes comandos:

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

    Terminal que muestra la selección del espacio de trabajo y el proyecto de la organización Adobe I/O CLI {width="600" modal="regular"}

Clona los starter kits

Clone uno de los siguientes repositorios de Commerce starter kit para la extensión que está creando y prepare su proyecto:

Kit de inicio de integración:

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

Kit de inicio de compra:

git clone https://github.com/adobe/commerce-checkout-starter-kit.git extension
cd extension
Kit de inicio de integración

Creación de un archivo .env

Cree el archivo de configuración de entorno:

code language-bash 
cp env.dist .env

Abra el archivo .env en un editor de texto y agregue las siguientes credenciales de OAuth:

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

Puede copiar estos valores de la página Credential details en Developer Console haciendo clic en la pestaña OAuth Server-to-Server del área de trabajo.

Página de credenciales de servidor a servidor OAuth en Adobe Developer Console {width="600" modal="regular"}

Añadir la configuración de Commerce

Agregue los siguientes detalles de la instancia de Commerce al archivo .env:

code language-shell-session 
COMMERCE_BASE_URL=
COMMERCE_GRAPHQL_ENDPOINT=

Para buscar estos valores:

  1. Vaya a Instancias del servicio Commerce Cloud.
  2. Haga clic en el icono de información junto a la instancia.
  3. Copie el extremo REST como COMMERCE_BASE_URL.
  4. Copie el extremo de GraphQL como COMMERCE_GRAPHQL_ENDPOINT.

Establecer prefijo de evento

Establezca un valor temporal para el prefijo de evento:

code language-shell-session 
EVENT_PREFIX=test

Descargar configuración de Workspace

Ejecute el siguiente comando para descargar el archivo de configuración de Workspace:

code language-bash 
aio console workspace download workspace.json

Copie el archivo de configuración de área de trabajo en el directorio scripts:

code language-bash 
cp workspace.json scripts/

Conectar el espacio de trabajo local al remoto

Vincule el proyecto local al espacio de trabajo remoto:

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

El terminal muestra una conexión correcta del espacio de trabajo con el comando de uso de la aplicación aio {width="600" modal="regular"}

Kit de inicio de cierre de compra

Conectar el espacio de trabajo local al remoto

Vincule el proyecto local al espacio de trabajo remoto. Desde la raíz del proyecto (la carpeta extension), ejecute:

code language-bash 
aio app use --merge

Cuando se le solicite, elija la opción que utiliza la organización, el proyecto y el espacio de trabajo que seleccionó al configurar la CLI de Adobe I/O. Esto escribe la configuración del espacio de trabajo en la aplicación para que la implementación y el desarrollo local utilicen ese espacio de trabajo.

El terminal muestra una conexión correcta del espacio de trabajo con el comando de uso de la aplicación aio {width="600" modal="regular"}

Instalación de herramientas de IA de extensibilidad

Este proceso crea la configuración de MCP (.<agent>/mcp.json), el directorio de aptitudes (.<agent>/skills/) y agrega AGENTS.md a la raíz del proyecto. Se le pedirá que elija un Starter Kit, un agente de codificación y un gestor de paquetes.

  1. Configure las herramientas de desarrollo asistido por IA en la carpeta extension mediante los siguientes comandos:

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

    Terminal que muestra la salida del comando de configuración de las herramientas de extensibilidad de IA {width="600" modal="regular"}

  2. Una vez finalizada la instalación, reinicie el agente de codificación para que pueda cargar las nuevas herramientas y habilidades de MCP. Las herramientas de Commerce App Builder ya están disponibles en su entorno.

    note note
    NOTE
    Si ve una advertencia que indica que no se encontraron aptitudes para el Starter Kit, se produjo un error, a menudo porque la configuración se ejecutó en una carpeta distinta de la carpeta en la que se clonó el Starter Kit. Ejecute aio commerce extensibility tools-setup desde la carpeta extension (la raíz del proyecto del Starter Kit) y seleccione el Starter Kit apropiado cuando se le solicite.

    Terminal que muestra la configuración de las herramientas de extensibilidad de IA con el kit de inicio de pago seleccionado {width="600" modal="regular"}

recommendation-more-help
d201267d-8d61-4d13-b6bb-517a2cbb4981