疑難排解 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模型公開,且應用程式頁面上的動作 可見度 開關已開啟。 改善說明並重新部署中繼資料變更
空白或錯誤回應
處理常式在本機運作,但在部署後無法運作
檢查最新的推播認可、確認執行階段設定,以及確認動作程式碼識別碼符合
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