文件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 API的 Adobe I/O Events

  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"}

安裝擴充性AI工具

此程式會建立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
2a2029a1-b458-4706-b074-f9c0c06ca6bb