DocumentaçãoCommerceAdobe Commerce as a Cloud Service

Pré-requisitos do tutorial

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

Criado para:

  • Intermediário
  • Desenvolvedor

Esta página lista os pré-requisitos e as etapas de configuração para os tutoriais do Adobe Commerce as a Cloud Service, como o tutorial de extensão de classificações e o tutorial de extensão do método de envio.

Pré-requisitos do Adobe Commerce as a Cloud Service

  • Instalar o Adobe I/O CLI

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

  • Instale os plug-ins Adobe I/O CLI Commerce, Adobe I/O CLI Runtime e 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

  • Baixar um IDE assistido por IA, como Cursor (recomendado). Outros IDEs, como Claude Code, Gemini CLI ou Copilot também são suportados, mas podem exigir modificações nos prompts e em outras etapas do tutorial.

Pré-requisitos do Adobe Developer Console

  1. Navegue até Adobe Developer Console.
  2. Faça logon usando seu email e senha.

Criar um novo projeto

  1. Navegue até Adobe Developer Console.

  2. Clique em Criar projeto a partir de um modelo.

  3. Selecione o modelo App Builder.

  4. Insira um Título do projeto e Nome do aplicativo.

  5. Certifique-se de que a caixa de seleção Include Runtime esteja marcada.

    Criação de projeto do Adobe Developer Console com modelo do App Builder selecionado {width="600" modal="regular"}

  6. Clique em Salvar.

Adicionar APIs ao espaço de trabalho

  1. Clique no espaço de trabalho Preparo e repita as etapas a seguir para cada API.

    Espaço de trabalho de preparo com a opção Adicionar Serviço para APIs {width="600" modal="regular"}

  2. Clique em Adicionar Serviço e selecione API.

  3. Selecione uma das seguintes APIs. Você precisará repetir esse processo para cada API listada abaixo:

    • Filtro Serviços da Adobe:

      • API de gerenciamento de E/S
      • API de Eventos de E/S

    • Filtro Experience Cloud:

      • API Adobe I/O Events para Adobe Commerce

  4. Clique em Avançar.

  5. Clique em Salvar API configurada.

  6. Repita as etapas anteriores até que todas as APIs sejam adicionadas ao espaço de trabalho.

    Workspace mostrando todas as APIs necessárias adicionadas com êxito {width="600" modal="regular"}

Configurar a CLI do Adobe I/O

  1. Limpar qualquer configuração existente:

    code language-bash 
    aio config clear

    Fazer logon usando o Adobe I/O CLI:

    code language-bash 
    aio auth login -f

  2. Selecione a organização, o projeto e o espaço de trabalho, usando cada um dos seguintes comandos:

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

    Terminal mostrando a seleção do projeto e do espaço de trabalho da organização da CLI do Adobe I/O {width="600" modal="regular"}

Clonar os kits iniciais

Clonar um dos seguintes repositórios do Commerce starter kit para a extensão que você está criando e preparar seu projeto:

Kit inicial de integração:

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

Kit inicial de check-out:

git clone https://github.com/adobe/commerce-checkout-starter-kit.git extension
cd extension
Kit de início de integração

Criar um arquivo .env

Crie seu arquivo de configuração de ambiente:

code language-bash 
cp env.dist .env

Abra o arquivo .env em um editor de texto e adicione as seguintes credenciais OAuth:

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

Você pode copiar esses valores da página Credential details no Developer Console clicando na guia OAuth Server-to-Server do seu espaço de trabalho.

Página de credenciais de servidor para servidor do OAuth no Adobe Developer Console {width="600" modal="regular"}

Adicionar a configuração do Commerce

Adicione os seguintes detalhes da instância do Commerce ao arquivo .env:

code language-shell-session 
COMMERCE_BASE_URL=
COMMERCE_GRAPHQL_ENDPOINT=

Para localizar esses valores:

  1. Navegue até instâncias do Commerce Cloud Service.
  2. Clique no ícone de informações ao lado da instância.
  3. Copie o ponto de extremidade REST como COMMERCE_BASE_URL.
  4. Copiar o ponto de extremidade do GraphQL como COMMERCE_GRAPHQL_ENDPOINT.

Definir prefixo do evento

Defina um valor temporário para o prefixo do evento:

code language-shell-session 
EVENT_PREFIX=test

Baixar configuração do espaço de trabalho

Execute o seguinte comando para baixar o arquivo de configuração do espaço de trabalho:

code language-bash 
aio console workspace download workspace.json

Copie o arquivo de configuração do espaço de trabalho para o diretório scripts:

code language-bash 
cp workspace.json scripts/

Conectar o espaço de trabalho local ao espaço de trabalho remoto

Vincular o projeto local ao espaço de trabalho remoto:

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

Terminal mostrando conexão de espaço de trabalho bem-sucedida com o comando de uso do aplicativo aio {width="600" modal="regular"}

Kit inicial de check-out

Conectar o espaço de trabalho local ao espaço de trabalho remoto

Vincule o projeto local ao espaço de trabalho remoto. Na raiz do projeto (a pasta extension), execute:

code language-bash 
aio app use --merge

Quando solicitado, escolha a opção que usa a organização, o projeto e o espaço de trabalho selecionados ao configurar a CLI do Adobe I/O. Isso grava a configuração do espaço de trabalho no aplicativo para que a implantação e o desenvolvimento local usem esse espaço de trabalho.

Terminal mostrando conexão de espaço de trabalho bem-sucedida com o comando de uso do aplicativo aio {width="600" modal="regular"}

Instalar ferramentas de IA de extensibilidade

Este processo cria a configuração de MCP (.<agent>/mcp.json), o diretório de habilidades (.<agent>/skills/) e adiciona AGENTS.md à raiz do projeto. Você deverá escolher um kit inicial, um agente de codificação e um gerenciador de pacotes.

  1. Configure as ferramentas de desenvolvimento assistido por IA na pasta extension usando os seguintes comandos:

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

    Terminal mostrando a saída do comando de instalação das ferramentas de extensibilidade de IA {width="600" modal="regular"}

  2. Depois que a configuração for concluída, reinicie o agente de codificação para permitir que ele carregue as novas ferramentas e habilidades do MCP. As ferramentas do Commerce App Builder agora estão disponíveis em seu ambiente.

    note note
    NOTE
    Se você vir um aviso de que nenhuma habilidade foi encontrada para o kit inicial, algo deu errado, geralmente porque a configuração foi executada em uma pasta diferente do local onde o kit inicial foi clonado. Execute aio commerce extensibility tools-setup na pasta extension (a raiz do projeto do kit inicial) e selecione o kit inicial apropriado quando solicitado.

    Terminal mostrando a configuração das ferramentas de extensibilidade de IA com o kit de início de check-out selecionado {width="600" modal="regular"}

recommendation-more-help
0519caf3-99f4-44ba-8e03-411a5b7764c8