文档CommerceAdobe Commerce as a Cloud Service

教程先决条件

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

创建对象：

  • 中级
  • 开发人员

此页面列出了Adobe Commerce as a Cloud Service教程的先决条件和设置步骤，如评级扩展教程和送货方法扩展教程。

Adobe Commerce as a Cloud Service先决条件

  • 安装Adobe I/O CLI

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

  • 安装Adobe I/O CLI Commerce、Adobe I/O CLI Runtime和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

  • 下载AI辅助的IDE，如Cursor（推荐），其他IDE，如Claude Code、Gemini CLI或Copilot也受支持，但可能需要修改提示和教程中的其他步骤。

Adobe Developer Console先决条件

  1. 导航到Adobe Developer Console。
  2. 使用您的电子邮件和密码登录。

创建新项目

  1. 导航到Adobe Developer Console。

  2. 单击​从模板创建项目。

  3. 选择​ App Builder ​模板。

  4. 输入​ 项目标题 ​和​应用程序名称。

  5. 确保选中​ Include Runtime ​复选框。

    已选择Adobe Developer Console模板来创建App Builder项目 {width="600" modal="regular"}

  6. 单击​保存。

将API添加到工作区

  1. 单击​ 阶段 ​工作区，然后对每个API重复以下步骤。

    包含API的“添加服务”选项的“暂存”工作区 {width="600" modal="regular"}

  2. 单击​ 添加服务 ​并选择​API。

  3. 选择以下API之一。 您需要为下面列出的每个API重复此过程：

    • Adobe服务​筛选器：

      • I/O管理API
      • I/O事件 API

    • Experience Cloud​筛选器：

      • 适用于Adobe Commerce的​Adobe I/O Events API

  4. 单击​下一步。

  5. 单击​保存配置的API。

  6. 重复上述步骤，直到将所有API添加到工作区为止。

    Workspace显示所有必需的API已成功添加 {width="600" modal="regular"}

配置Adobe I/O CLI

  1. 清除任何现有配置：

    code language-bash 
    aio config clear

    使用Adobe I/O CLI登录：

    code language-bash 
    aio auth login -f

  2. 使用以下每个命令选择您的组织、项目和工作区：

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

    终端显示Adobe I/O CLI组织项目和工作区选择 {width="600" modal="regular"}

克隆入门工具包

为您正在构建的扩展克隆以下Commerce starter kit存储库之一，并准备项目：

集成入门工具包：

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

结帐入门工具包：

git clone https://github.com/adobe/commerce-checkout-starter-kit.git extension
cd extension
集成入门工具包

创建.env文件

创建环境配置文件：

code language-bash 
cp env.dist .env

在文本编辑器中打开.env文件并添加以下OAuth凭据：

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

您可以通过单击工作区上的​ Credential details ​选项卡，从Developer Console中的​ OAuth Server-to-Server ​页面复制这些值。

Adobe Developer Console中的 OAuth服务器到服务器凭据页面 {width="600" modal="regular"}

添加Commerce配置

将以下Commerce实例详细信息添加到您的.env文件：

code language-shell-session 
COMMERCE_BASE_URL=
COMMERCE_GRAPHQL_ENDPOINT=

要查找这些值，请执行以下操作：

  1. 导航到Commerce Cloud服务实例。
  2. 单击实例旁边的信息图标。
  3. 将REST终结点复制为COMMERCE_BASE_URL。
  4. 将GraphQL端点复制为COMMERCE_GRAPHQL_ENDPOINT。

设置事件前缀

为事件前缀设置临时值：

code language-shell-session 
EVENT_PREFIX=test

下载工作区配置

运行以下命令下载工作区配置文件：

code language-bash 
aio console workspace download workspace.json

将工作区配置文件复制到scripts目录：

code language-bash 
cp workspace.json scripts/

将本地工作区连接到远程工作区

将本地项目链接到远程工作区：

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

终端显示与aio应用成功的工作区连接，使用命令 {width="600" modal="regular"}

结帐入门工具包

将本地工作区连接到远程工作区

将本地项目链接到远程工作区。 从项目根目录（extension文件夹）中，运行：

code language-bash 
aio app use --merge

出现提示时，选择使用您在配置Adobe I/O CLI时选择的组织、项目和工作区的选项。 这会将工作区配置写入应用程序中，以便部署和本地开发使用该工作区。

终端显示与aio应用成功的工作区连接，使用命令 {width="600" modal="regular"}

安装可扩展性人工智能工具

此进程创建MCP配置(.<agent>/mcp.json)、技能目录(.<agent>/skills/)，并将AGENTS.md添加到项目根目录。 系统将提示您选择入门套件、编码代理和包管理器。

  1. 使用以下命令在extension文件夹中设置AI辅助开发工具：

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

    显示AI可扩展性工具设置命令输出的终端 {width="600" modal="regular"}

  2. 安装完成后，请重新启动编码代理，以便加载新的MCP工具和技能。 Commerce App Builder工具现在可在您的环境中使用。

    note note
    NOTE
    如果您看到一则警告，指出未找到入门工具包的技能，则说明出现了问题，这通常是因为安装程序在克隆入门工具包以外的文件夹中运行。 从aio commerce extensibility tools-setup文件夹（入门套件项目根）运行extension并在出现提示时选择相应的入门套件。

    终端显示AI可扩展性工具设置，已选择签出启动工具包 {width="600" modal="regular"}

recommendation-more-help
29fd6b16-22d9-4d45-b5c9-95c2f0341493