動作和Widget欄位 action-widget-configuration

IMPORTANT
所有AEM Sites Cloud Service客戶都可使用LLM應用程式來開發及管理自己的應用程式。 一旦計數開始,每個應用程式呼叫都會計入客戶的AEM Sites內容請求。 Adobe會在計量生效前宣告計量速率和開始日期。

使用此頁面來查閱動作編輯器中的欄位。 如需建立步驟,請參閱從頭開始建立動作。

尋找設定

建立新動作​對話方塊和儲存的動作編輯器使用相同的四個索引標籤:

標籤
設定
動作詳細資料
動作名稱、程式碼識別碼、說明、輸入引數和​LLM設定,包括註解、呼叫狀態文字和可見度
LLM Widget詳細資料
Widget型別、沙箱網域、Widget說明、範本URL和CSP
應用程式分析
使用者意圖收集和指示
ChatGPT延伸模組
直接開啟的進入點、動作圖示、顯示偏好設定和撰寫者提及

若要儲存您的編輯,請選取​儲存變更。 正在等待稽核的產生動作改為顯示​標籤為已稽核,這也會合併其產生的提取請求或分支。

動作引數

輸入引數是LLM平台傳送給動作處理常式的值。 模型會從使用者的訊息中擷取值,並將這些值對應至設定的引數。

屬性
說明
名稱
引數識別碼(例如,category, query)
類型
已上傳檔案引數的String、Number、Integer、Boolean、Object或File
說明
人類看得懂的說明 — LLM平台會使用該說明來擷取正確的值
必要
如果勾選,模型必須在叫用動作之前提供此引數

檔案引數

檔案引數是具有File型別的輸入引數。 當使用者上傳檔案時,主機會為這些引數提供檔案物件,通常包括download_url和file_id。

上傳的檔案引數與檔案輸入點不同。 File進入點使用名為file的Object引數,包含開啟檔案的name和resourceUri。

中繼資料欄位

基本資訊

欄位
必要
說明
動作名稱
是
動作的顯示名稱(例如,搜尋產品)
說明
是
動作功能的說明 — LLM平台會使用說明來決定何時叫用動作

建立對話方塊會預覽從動作名稱衍生的不可變​程式碼識別碼。 這是應用程式內獨一無二的,最多可包含63個字元(以小寫字母開始),並使用小寫字母、數字、連字型大小或底線。 它將動作對應到處理常式存放庫中的actions/<code-identifier>/index.js。

註解

描述動作行為的可選提示:

註解
說明
破壞性提示
此動作可能會刪除或覆寫資料
等冪(相同的引數=沒有額外效果)
重複相同的請求對環境沒有額外的影響;重複請求不一定會傳回相同的資料
開放世界提示
動作會與外部系統互動
唯讀提示
動作只會讀取資料,不會寫入

OpenAI中繼資料

欄位
最大長度
說明
正在叫用狀態文字
64個字元
動作執行時在LLM平台中顯示的訊息(例如,正在載入產品……)
叫用的狀態文字
64個字元
動作完成後顯示的訊息(例如,載入的產品……)

可見度

若要開啟或關閉動作,請在應用程式頁面上使用其​ 可見度 ​開關。 切換器會控制下一個部署是否包含動作。 動作編輯器沒有單獨的開啟/關閉開關。

以下動作編輯器設定可控制模型和Widget曝光,而非應用程式層級的開啟/關閉狀態:

切換
說明
公開給AI模型
AI模型可在對話期間叫用該動作
在應用程式表面顯示為Widget
動作會在應用程式中呈現視覺化的Widget

模型和Widget曝光度設定不會取代選擇Widget型別。

分析

欄位
說明
收集使用者意圖
預設為啟用。 要求導致分析動作的目標匿名摘要
使用者意向描述
用於要求摘要的指示,最多2,000個字元。 預設會排除個人和敏感資訊。 檢閱針對您的隱私權原則的任何自訂

Widget欄位

Widget資訊

欄位
說明
Widget型別
互動式Widget的Edge Delivery Services區塊,或純文字動作的​無互動式UI
Widget網域
主機使用的沙箱來源。 UI會根據應用程式提交和每個應用程式唯一性的要求識別它。 這與EDS頁面的​ Widget URL ​不同
Widget說明
最多512個字元。 對應至_meta["openai/widgetDescription"];彙總模型的演算元件,並減少重複的旁白。 動作說明可控制模型選取動作的時機;Widget說明可說明元件在呈現後顯示的內容

範本URL

欄位
說明
指令碼URL
EDS scripts/aem-embed.js進入點的HTTPS URL。 在同一EDS專案中的跨動作共用
Widget URL
動作轉譯之EDS頁面的HTTPS URL。 產生的動作會自動設定URL

CSP設定

內容安全性原則可控制Widget iframe可聯絡的外部網域。 每個外部網域都必須明確加入允許清單。

指示詞
說明
資源網域
靜態資產的網域 — 影像、字型、指令碼、樣式
連線網域
Widget可以透過fetch、XHR或WebSocket聯絡的網域
框架網域
巢狀iframe允許來源;觸發更嚴格的應用程式檢閱
重新導向網域
openExternal個重新導向連結的受信任目標(ChatGPT個特定)
基礎URI網域
base-uri CSP指示詞(僅限MCP Apps SDK,而非ChatGPT)

ChatGPT擴充功能欄位 chatgpt-extension-fields

這些選擇性設定僅限ChatGPT;它們不會設定Claude或其他LLM平台。 可用性因ChatGPT使用者端而異。 如需需求和步驟,請參閱設定ChatGPT擴充功能。

進入點和動作圖示

入口點需要一個Widget。 為同一個Widget選取「全域」、「螺紋」和「檔案」的任意組合,或保留全部未勾選。 全域和執行緒在沒有輸入的情況下叫用動作;檔案僅提供file物件。 其他必要的輸入會導致對應的進入點無法運作。 如果檔案與全域或執行緒結合,file必須是選擇性的。

欄位
說明
使用者可以開啟此應用程式的位置
「全域」(導覽中的全熒幕)、「對話方塊」(對話方塊內容標籤)和「檔案」(符合檔案副檔名的自訂檢視器)的核取方塊。 可選取多種型別
圖示URL
選擇性動作圖示與其進入點共用。 接受HTTP(S) URL或資料URI;偏好使用公用HTTPS影像URL。 變更或清除URL會取代任何儲存的圖示變體
副檔名
檔案進入點至少有一個副檔名,例如.csv。 編輯器在省略時新增前導點

選取「檔案」會新增名為file的選用物件輸入(如果遺失)。 現有的定義會保留,而且必須接受開啟檔案的name和resourceUri。

顯示偏好設定

這些Widget設定與登入點不同。 主機選擇最終簡報。

欄位
選項和預設行為
由模型啟動時顯示
inline、fullscreen或​無喜好設定
支援的資源顯示模式
內嵌、全熒幕,或兩者皆有。 未選取則會使主機預設值生效
初始資源顯示
主機預設值、內嵌​或​全熒幕。 選取支援的模式時,必須包含初始模式

撰寫者提及次數

啟用撰寫者提及​會指定應用程式的資源搜尋動作。 每個應用程式只能有一個動作可提供提及搜尋。 動作必須是唯讀且可透過應用程式檢視,且包含名為query的字串引數,該引數接受空白文字且沒有其他必要輸入。 提供者可以是純文字;啟用應用程式可見性不需要為搜尋提供者設定Widget。

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