應用程式如何連線 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助理。 也支援純文字回應。

進行變更的位置

您想要變更的內容
編輯位置
當助理使用動作時,或動作要求哪些資訊
LLM應用程式中的動作設定
結果來自何處,或動作執行時會發生什麼情況
處理常式存放庫中的處理常式程式碼
結果的外觀,包括版面、品牌和互動
Widget存放庫中的Widget程式碼

保持這三個部分一致。 例如,如果您變更處理常式傳回的資訊,請更新Widget以顯示新結果。

交談中發生的情況

部署後,您的應用程式有一個連線URL,稱為​MCP伺服器URL。 將此URL新增至支援的AI平台,讓助理可以探索及使用您應用程式的動作。

對於具有產品搜尋動作和Widget的應用程式:

  1. 客戶要求助理,給我看咖啡盒。
  2. 助理會使用動作的說明來選擇產品搜尋動作。
  3. 處理常式會從目錄中取得相符的產品。
  4. Widget會將產品顯示為交談中的卡片。
  5. 客戶瀏覽結果或提出後續問題。

當應用程式提供資訊或服務時,客戶會繼續參與交談。 Widget支援取決於LLM平台。

套用及測試您的變更

先發佈Widget變更和部署動作變更,再測試更新的體驗。 請依照部署您的應用程式以部署至中繼環境,並在支援的LLM平台上測試應用程式。

自動產生的動作會以範例資料開頭。 將處理常式連線至您的實際系統,並在客戶使用應用程式之前先行測試。

recommendation-more-help
llm-apps-help-main-toc