疑難排解 troubleshooting

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

從可觀察的症狀開始。 進行疑難排解時,請勿共用認證、權杖、私人MCP URL或敏感處理常式結果。

應用程式建立和動作產生

症狀
嘗試什麼
LLM Apps受管理基礎結構設定失敗
在​ 安裝失敗 ​下讀取錯誤,然後選取​重試。 如果頁面無法檢查進度,請選取​再次檢查;在背景中繼續安裝
沒有可用的AEM程式
請要求您的管理員提供程式存取權。 如果載入失敗,請選取​重試載入程式
新存放庫未出現
將存放庫新增至Cloud Manager程式作為私人存放庫,並等待其狀態為​就緒,然後重新開啟存放庫清單。 不支援Cloud Manager中由Adobe託管的存放庫
未連結任何Edge Delivery Services網站
不在GitHub上的Widget存放庫必須透過自備Git連結至Cloud Manager中的EDS網站。 連結它,然後再次選取​驗證存放庫。 檢視自備Git
動作或Widget存放庫驗證失敗
使用相容的現有專案或空的存放庫。 使用個別的存放庫執行動作和Widget,然後再次選取​驗證存放庫
AEM網站設定或存取驗證失敗(GitHub Widget存放庫)
遵循設定AEM網站存取權。 對於新的Code Sync安裝,請完成其確認頁面精靈。 針對現有網站,請保留安裝,並要求網站管理員透過Adobe使用者管理員授與您的AEM帳戶admin存取權。 確認程式碼同步涵蓋Widget存放庫,然後選取​驗證AEM設定
需要DA寫入許可權
要求DA組織管理員授予LLM應用程式中使用的Adobe帳戶寫入網站所有內容的存取權。 遵循授予DA寫入存取權,使用該帳戶登入,然後選取​驗證AEM設定。 AEM網站角色未授予DA許可權
無法驗證AEM或DA存取
請再次嘗試​驗證AEM安裝程式,以暫時驗證失敗。 如果訊息回報存取遭拒,請在重試之前使用上述指示修正AEM或DA許可權
建立應用程式時沒有產生動作
應用程式建立只會設定基礎結構。 在應用程式頁面上,選取​自動建置動作,輸入​您的網站,然後選取​建置我的動作。 請參閱建立動作
動作仍在產生中
UI預估產生最多需要30分鐘。 在「動作」頁面上追蹤進度,或離開頁面並於稍後返回
動作產生報表失敗
確認網站是透過HTTPS公開,且對於您自己的存放庫,存放庫存取權仍然有效。 如果問題仍然存在,請連絡LLM應用程式團隊,並提供顯示的錯誤訊息

動作和處理常式

症狀
嘗試什麼
未叫用動作
在交談中啟用應用程式的外掛程式或聯結器。 確認動作設定中的​向AI模型公開,且應用程式頁面上的動作​ 可見度 ​開關已開啟。 改善說明並重新部署中繼資料變更
空白或錯誤回應
執行npm test,然後使用MCP檢查程式或curl呼叫處理常式。 檢視本機處理常式開發與測試
處理常式在本機運作,但在部署後無法運作
檢查最新的推播認可、確認執行階段設定,以及確認動作程式碼識別碼符合actions/<code-identifier>/index.js
無法將產生的動作標示為已檢閱
確認處理常式和Widget產生成功。 檢查產生的提取請求或分支是否合併衝突,重新載入動作,然後再次選取​標示為已檢閱。 對於您自己的存放庫,如果稽核要求您自行合併分支,請先將其與常規流程合併

Widget

症狀
嘗試什麼
Widget未呈現
驗證指令碼URL、Widget URL、HTTPS、EDS出版物、CSP網域和CORS標頭
Widget會呈現但未顯示任何資料
使用MCP檢查器呼叫處理常式,並將其structuredContent圖形與從bridge.toolResult讀取的欄位進行比較
Widget可在直接預覽中運作,但無法在ChatGPT中使用
直接預覽可能會使用範例資料。 測試已部署的處理常式結果,並驗證CORS和CSP允許EDS來源
已封鎖瀏覽器請求
僅將所需來源新增至正確的CSP欄位並重新部署
HTTP標題編輯器無法儲存設定
使用AEM組態服務或要求EDS系統管理員初始化站台標頭組態

當完整的bridge.toolResult值可能包含個人或敏感資料時,請勿記錄這些值。

ChatGPT擴充功能

有關遺漏的進入點、檔案檢視器問題、無效的圖示URL、顯示設定或撰寫器提及錯誤,請參閱ChatGPT擴充功能疑難排解。 在變更應用程式之前檢查使用者端支援:有效的連線不表示該使用者端支援所有擴充功能。

部署

症狀
嘗試什麼
在​ 準備 ​期間部署失敗
確認處理常式存放庫已連結,且您的Adobe Developer Console存取權仍然有效
在​ 建置應用程式 ​期間部署失敗
在本機執行npm install、npm test和npm run build。 修正相依性、語法或測試失敗,並推送變更
部署成功,但缺少變更
確認預期的認可已推送並重新部署到相同環境
動作仍為​未部署
在檢閱動作或變更其中繼資料後再次部署

驗證 authentication

適用於​ 啟用驗證 ​已開啟。 請參閱使用您自己的身分提供者來驗證一般使用者。

症狀
嘗試什麼
儲存設定後,動作仍為公開狀態
將應用程式再次部署至該環境。 驗證變更會在下次部署時生效
切換環境後設定看起來錯誤
確認​ Workspace ​選取器顯示您打算的環境。 階段​和​ 生產 ​是獨立設定的
登入未開始
確認您已在啟用驗證後部署應用程式,且動作使用​必要。 Optional​動作只有在處理常式要求登入時才會提示
平台將使用者傳送至錯誤的登入頁面
驗證​ 簽發者 ​是否與您的身分提供者的簽發者URL完全相符,以及它是否可透過公用HTTPS連線
登入成功,但所有呼叫仍遭拒絕
確認您的身分提供者會發行權杖,其對象為該環境的應用程式MCP伺服器URL,且權杖是使用非對稱演演算法簽署的JWT。 檢視權杖需求
身分提供者不會接收任何流量
您的提供者的探索、授權和權杖端點必須可透過公開HTTPS連線。 檢查前面的防火牆、WAF或IP允許清單 — 您的應用程式在提供者無法使用時仍可連線
身分提供者拒絕為要求的對象核發權杖
有些提供者只會針對已向其註冊的資源發出代號。 確認應用程式的MCP伺服器URL已註冊為身分提供者中的資源識別碼
登入時未請求新新增的範圍
LLM平台會快取應用程式發佈的中繼資料幾分鐘。 請稍候,然後重試登入
系統會要求使用者再次登入範圍
此動作需要權杖未攜帶的範圍。 在您的身分提供者中,將範圍新增至使用者端的授權,或從動作中移除此範圍
使用者會收到重複的登入提示
一種處理常式,每次呼叫時都會傳回extra.challengeAuth(),而不會檢查呼叫者的身分要求,在驗證後再次登入。 請求驗證僅當缺少動作所需的身分時
在使用者到達您的身分提供者之前,登入會遭到拒絕
LLM平台傳送的重新導向URI未向授權伺服器註冊。 有些平台會針對每個聯結器發出不同的值,因此請註冊聯結器設定畫面上顯示的值
儲存被不支援的範圍訊息封鎖
將領域新增至​支援的領域,或從需要它的動作中移除它
公用動作仍會提示登入Claude
檢查聯結器是否在需要時使用​登入,而非​立即登入。 若為較舊部署的應用程式,請更新執行階段並重新部署。 目前執行階段上的混合式應用程式可匿名呼叫公用動作
選擇性​動作傳回登入文字,但沒有Claude登入提示
extra.challengeAuth()是ChatGPT工具結果挑戰。 對於可攜式登入閘道,請使用​ 必要 ​動作,讓執行階段傳回Claude預期的HTTP挑戰
即使每個動作是​無,應用程式仍會提示登入
關閉​ 啟用驗證 ​並部署。 當啟用時,應用程式會通告授權伺服器,即使未閘道任何動作亦然

請勿將存取權杖、宣告集或身分提供者使用者端密碼貼到支援要求中。

ChatGPT增效模組

症狀
嘗試什麼
外掛程式未出現
開啟chatgpt.com/plugins,確認您的帳戶或工作區允許自訂MCP伺服器,並安裝或連線產生的外掛程式
外掛程式建立失敗
從​再次複製完整的HTTPS MCP伺服器URL測試應用程式,並選擇符合應用程式的驗證方法。 僅針對公用應用程式使用​無驗證,而非作為失敗OAuth的因應措施
外掛程式會連線,但無法叫用動作
確認外掛程式已附加至聊天、動作已公開至模型,且已部署最新版本
外掛程式使用錯誤的環境
使用預期的階段或生產MCP伺服器URL編輯或重新建立外掛程式
外掛程式仍會顯示舊版動作中繼資料
部署變更,選取ChatGPT連線上的​重新整理,然後開始新的交談

如果問題仍然存在,請先記錄應用程式名稱、環境、失敗的步驟、時間,以及顯示的錯誤訊息,然後再聯絡LLM應用程式團隊。 請勿包含機密或敏感的客戶資料。

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