應用程式如何連線 app-architecture
IMPORTANT
所有AEM Sites Cloud Service客戶都可使用LLM應用程式來開發及管理自己的應用程式。 一旦計數開始,每個應用程式呼叫都會計入客戶的AEM Sites內容請求。 Adobe會在計量生效前宣告計量速率和開始日期。
LLM應用程式將您品牌的服務帶入AI對話中。 例如,客戶要求您提供咖啡推薦,您的應用程式找到相符的產品,而助理會顯示結果。
在本指南中:瞭解應用程式的每個部分有何作用、在何處進行變更,以及當使用者使用應用程式時,這些部分如何共同運作。
應用程式的三個部分
一個應用程式可群組數個相關動作,例如瀏覽產品、比較產品和尋找商店。 每個動作都有各自的設定、處理常式及選用的Widget。 新增動作不需要其他存放庫配對。
具有互動式Widget的應用程式包含三個部分:動作設定、處理常式程式碼和Widget程式碼。 您管理LLM Apps中的設定。 處理常式和Widget程式碼存在於兩個不同的存放庫中。
┌───────────────────────┐ ┌───────────────────────┐ ┌───────────────────────┐
│ 1. LLM Apps UI │ │ 2. Handler repository │ │ 3. Widget repository │
│ │ │ │ │ │
│ Action descriptions │ │ Connects to your APIs │ │ Widget layout │
│ Required information │ │ Runs the task │ │ Branding and styles │
│ When to use an action │ │ Returns results │ │ Interactive controls │
└───────────────────────┘ └───────────────────────┘ └───────────────────────┘
│ │ │
└───────────────────────────┼───────────────────────────┘
▼
┌───────────────────────────────────────┐
│ Your app in an AI conversation │
│ The action runs and the widget │
│ shows the result. │
└───────────────────────────────────────┘
- 動作設定描述工作。 它們會告知助理何時使用動作以及需要哪些資訊。 對於產品搜尋,該資訊可能是類別或搜尋字詞。
- 處理常式完成工作。 它會從您的系統取得資料或執行任務。 例如,產品搜尋處理常式會從您的目錄中擷取相符的產品。
- Widget會顯示結果。 它可控制客戶看見及互動的內容,例如含有名稱、價格和按鈕的產品卡。
建議您為每個動作新增Widget。 Widget可讓您控制結果的外觀以及客戶與其互動的方式,而非將簡報交給AI助理。 也支援純文字回應。
進行變更的位置
保持這三個部分一致。 例如,如果您變更處理常式傳回的資訊,請更新Widget以顯示新結果。
交談中發生的情況
部署後,您的應用程式有一個連線URL,稱為MCP伺服器URL。 將此URL新增至支援的AI平台,讓助理可以探索及使用您應用程式的動作。
對於具有產品搜尋動作和Widget的應用程式:
- 客戶要求助理,給我看咖啡盒。
- 助理會使用動作的說明來選擇產品搜尋動作。
- 處理常式會從目錄中取得相符的產品。
- Widget會將產品顯示為交談中的卡片。
- 客戶瀏覽結果或提出後續問題。
當應用程式提供資訊或服務時,客戶會繼續參與交談。 Widget支援取決於LLM平台。
套用及測試您的變更
先發佈Widget變更和部署動作變更,再測試更新的體驗。 請依照部署您的應用程式以部署至中繼環境,並在支援的LLM平台上測試應用程式。
自動產生的動作會以範例資料開頭。 將處理常式連線至您的實際系統,並在客戶使用應用程式之前先行測試。
recommendation-more-help
llm-apps-help-main-toc