基礎架構設定 create-first-app
基礎架構是您應用程式的技術基礎:儲存其程式碼的存放庫,以及執行其動作處理常式並將其Widget傳送給使用者的服務。
如總覽中所述,動作處理常式會執行工作,例如尋找產品,而 Widget 會將結果呈現為交談中的互動式體驗。
LLM Apps會將處理常式和Widget原始程式碼儲存在兩個不同的存放庫中:
- 動作存放庫 — 包含伺服器端處理常式及其測試。
- Widget存放庫 — 包含互動式Widget的程式碼和樣式。
例如,產品搜尋處理常式會擷取相符的產品,而其Widget會將它們顯示為產品卡。 存放庫會儲存該程式碼;Adobe I/O Runtime會執行已部署的處理常式,而Edge Delivery Services則會提供Widget。
安裝精靈會準備這些存放庫,並連線應用程式所需的服務。 從兩個選項中選擇一個:
- LLM Apps受管理基礎結構是最快的開始方式。 Adobe會為您的動作處理常式和Widget建立並託管存放庫,因此您不需要自行設定存放庫。
- 您自己的存放庫會將您應用程式的程式碼保留在您擁有的存放庫中,新增到Cloud Manager。 它們可以託管於GitHub、GitHub Enterprise、GitLab、Bitbucket或Azure DevOps。 平台會使用必要的專案檔案來初始化空白的存放庫,因此您不需要預先準備動作或Widget程式碼。
在本指南中:瞭解如何選擇基礎結構選項,並使用安裝精靈建立您的應用程式。 安裝之後,繼續建立動作。
建立應用程式 不會 產生啟動動作。 從應用程式頁面個別開始產生動作。
開啟建立應用程式精靈
開啟Adobe LLM應用程式。 從歡迎頁面,選取開始使用。 如果您已經有開啟的應用程式,請使用應用程式選擇器,然後選取建立新的應用程式。
建立您的LLM應用程式精靈從開始。 選擇如何設定技術環境。
這兩個選項都支援稍後自動產生動作。 這兩個選項都不需要您手動寫入動作。
使用LLM Apps個受管理基礎結構 adobe-managed-infrastructure
使用此選項可讓Adobe為您的應用程式設定和管理存放庫和連線服務。 您不需要自行建立存放庫或安裝GitHub個App。
- 選取讓我們處理它。
- 選取下一步。
- 完成應用程式詳細資料。
- 選取建立應用程式。
在Adobe準備存放庫並連線Widget網站時,應用程式頁面會顯示設定您的應用程式。 UI指出設定通常需要1-2分鐘;在設定就緒之前,動作、測試和部署仍無法使用。
如果安裝失敗,請讀取錯誤並選取重試。 如果頁面無法檢查進度,安裝程式會在背景中繼續;請選取 再次檢查 以重新連線。
安裝程式完成時,請繼續建立動作。
使用您自己的存放庫 your-own-repositories
選取使用我的Cloud Manager設定,然後選取下一步。 此路徑包含四個精靈步驟:
開始執→動作基礎結構設定→Widget基礎結構設定→應用程式詳細資料。
LLM Apps使用您的Adobe帳戶透過Cloud Manager到達您的存放庫。 您未安裝GitHub應用程式。
開始之前 own-repositories-prerequisites
- 存取應用程式所屬的Cloud Manager程式。
- 兩個存放庫,一個用於動作處理常式,另一個用於Widget。 空白的存放庫沒有問題,包括僅包含其Git主機建立的README的存放庫。
- 兩個存放庫都已新增至Cloud Manager作為私人存放庫,其擁有權已驗證,且狀態為就緒。 Cloud Manager必須能夠寫入它們;唯讀存取權杖是不夠的。
只會列出您自行託管的存放庫。 不支援Cloud Manager中由Adobe託管的存放庫。
您的Widget存放庫是Edge Delivery Services網站 widget-repository-is-an-eds-site
Widget是從Edge Delivery Services (EDS)網站提供,您的Widget存放庫儲存該網站的程式碼。 確定Widget存放庫屬於EDS網站,或將會屬於。 有兩種方式可設定一個:
- 任何Git提供者,請自備Git。 在Cloud Manager中建立EDS網站,並使用 自備Git 將其連結到您的存放庫。 Cloud Manager然後將存放庫的程式碼同步至網站。 請在啟動精靈之前執行此動作。 參閱自備Git。
- 具有AEM程式碼同步的GitHub存放庫。 自行設定EDS網站,如同Edge Delivery Services教學課程。 精靈會引導您完成安裝AEM Code Sync,以及在驗證存放庫後檢查存取權。
Widget步驟會偵測適用的情況。 請參閱設定Widget基礎結構。
設定動作基礎結構
動作存放庫包含當LLM平台叫用動作時所執行的伺服器端處理常式與測試。
- 在 Cloud Manager程式 下,選取包含動作存放庫的程式。
- 在 Cloud Manager存放庫 下,選取動作存放庫。 如果遺失該清單,請在Cloud Manager中新增該清單,並附上前往Cloud Manager,然後重新整理清單。
- 選取驗證存放庫。 驗證會使用Adobe LLM應用程式範本初始化空白的存放庫。 現有的存放庫必須包含相容的動作專案。
- 當顯示 已驗證的存放庫 時,請選取下一步。
平台會將產生的動作程式碼推送至此存放庫的分支。 選取 標籤為已檢閱 會合併分支。 請參閱建立動作。
設定Widget基礎結構 set-up-the-widget-infrastructure
Widget是附加至動作(例如產品卡片或預訂表單)的可選視覺回應。 Edge Delivery Services (EDS)會從使用您Widget存放庫的網站提供這些服務。
-
在 Widget來源 下,選取手動選取Widget存放庫。
-
在 Cloud Manager程式 底下,選取包含介面工具儲存庫的程式。 它可能與動作存放庫的程式不同。
-
在 Edge Delivery Services存放庫 下,選取Widget存放庫。 請勿選取動作存放庫。
-
選取驗證存放庫。 驗證會使用AEM範本初始化空的存放庫。 現有的存放庫必須是相容的EDS專案。
後續動作取決於託管Widget存放庫的位置。
其他提供者上的Widget存放庫(自備Git) widget-repository-byog
對於GitLab、Bitbucket、Azure DevOps或GitHub Enterprise上的存放庫,驗證會找到Cloud Manager連結到存放庫的EDS網站。 精靈會在 Edge Delivery Services網站 下顯示網站。
Cloud Manager會將存放庫的程式碼同步至該網站,因此您不需要AEM程式碼同步。 選取下一步。
如果驗證報告未連結任何網站,請使用 自備Git 將存放庫連結到Cloud Manager中的EDS網站,然後再次驗證。 參閱自備Git。
GitHub上的Widget存放庫 widget-repository-github
GitHub存放庫使用AEM程式碼同步來發佈其程式碼。 驗證後,精靈會顯示安裝AEM程式碼同步。 使用相同的Adobe帳戶來存取LLM Apps、AEM網站存取權和DA寫入存取權。
設定AEM網站存取權 aem-site-access
新安裝:選取安裝AEM程式碼同步,並授與它存取Widget存放庫的許可權。 完成安裝確認頁面上的安裝精靈,將自己新增為網站管理員。
現有的EDS網站:請保持您的AEM程式碼同步安裝,並確認其涵蓋選取的Widget存放庫。 請要求現有網站管理員在https://tools.aem.live/tools/user-admin/index.html/?org=<org>&site=<site>開啟AEM使用者管理員,並以admin角色新增您的Adobe帳戶。 您不需要重新安裝Code Sync。
將<org>和<site>取代為您的AEM組織和網站名稱。 您的網站管理員可以確認這些值。
授予DA寫入許可權 da-write-access
針對新網站和現有網站,請要求DA組織管理員:
-
在
https://da.live/config#/<org>/開啟DA設定,將<org>取代為儲存網站內容的DA組織。 -
開啟 許可權 工作表。 如果工作表不存在,請選取新增工作表,將其命名為
permissions,並新增欄標題路徑、群組和動作。 您也可以新增 註解 欄來說明每個規則。 -
新增授與您Adobe帳戶寫入網站中所有內容的存取權的資料列:在 路徑 中使用網站的內容路徑,群組中使用您的Adobe帳戶電子郵件,並在 動作 中使用
write。 儲存設定。
熒幕擷圖使用虛構的帳戶。 將
widget-author@example.com取代為您的Adobe帳戶電子郵件,並使用您網站的內容路徑,而非整個組織的/ + **範例。CONFIG列是組態管理員的專用資料列;您不需要變更它即可授與內容存取權。
AEM網站角色不授予DA寫入許可權。 您不需要整個組織的寫入許可權。
如需設定DA許可權的詳細資訊,請參閱許可權和安全性。
驗證AEM設定 validate-aem-setup
- 返回LLM Apps並選取驗證AEM設定。
- 當顯示 AEM安裝程式已驗證 時,請選取下一步。
如果驗證失敗,請依照訊息檢查AEM網站存取權或DA寫入存取權,然後再次驗證。
輸入應用程式詳細資料 app-details
兩個基礎結構選項都已完成,並顯示應用程式詳細資料。
- 輸入LLM應用程式名稱。 使用可識別品牌或體驗的名稱,例如Frescopa咖啡。
- 選取應用程式所屬的AEM程式。 如果您只能存取一個程式,精靈會自動選取該程式。 使用您自己的存放庫時,程式是動作存放庫的程式,不能在此變更。
- 在 應用程式見解資料區域 下,選擇 美國(US) 或歐洲(EU)。
- 選取建立應用程式。
如果沒有可用的AEM程式,請向您的管理員要求存取權。 如果載入程式失敗,請選取重試載入程式。
精靈會在建立後開啟應用程式頁面。 使用LLM Apps個受管理的基礎結構,請等待基礎結構設定完成後再繼續。
若要稍後檢查存放庫,請開啟應用程式的設定。 存放庫區段會顯示每個存放庫的程式和名稱,以及針對使用自攜Git的Widget存放庫,其EDS網站和來源。 應用程式建立後,便無法變更存放庫。
先前使用Adobe LLM Apps GitHub應用程式建立的應用程式可繼續使用現有的存放庫。
下一步:建立動作
您的應用程式現在具有其基礎架構,但尚未產生任何動作。 繼續進行建立動作以分析網站或選擇手動動作建立。
如需動作中繼資料、處理常式、Widget和已部署的MCP伺服器之間的關係,請參閱應用程式如何連線在一起。