疑難排解 troubleshooting
IMPORTANT
Adobe LLM Apps目前在Beta中。
此處顯示的功能、工作流程和UI不一定代表產品的最終狀態。 若要加入Beta，請傳送電子郵件至llm-apps-beta@adobe.com。
從您看到的症狀開始。 進行疑難排解時，請勿共用認證、權杖、私人MCP URL或敏感處理常式結果。
應用程式建立和上線
症狀
嘗試什麼
新存放庫未出現
選取在GitHub上管理存放庫、授予Adobe LLM應用程式GitHub應用程式存取這兩個存放庫的許可權、返回對話方塊，並重新整理清單
EDS存放庫需要AEM程式碼同步
為EDS存放庫安裝AEM Code Sync，然後返回「建立LLM應用程式」對話方塊
EDS驗證顯示您不是管理員
選取開啟AEM Live Admin，將自己新增為EDS網站的管理員，然後重新整理存放庫
上線仍在產生中
大約需要15分鐘。 您可以離開頁面，稍後再返回
上線報告失敗
確認兩個存放庫皆可存取，且網站是透過HTTPS公開，然後聯絡Beta團隊並提供可見的錯誤訊息
動作和處理常式
症狀
嘗試什麼
未叫用動作
附加ChatGPT外掛程式，確認 公開至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值可能包含個人或敏感資料時，請勿記錄這些值。
部署
症狀
嘗試什麼
在 準備 期間部署失敗
確認處理常式存放庫已連結，且您的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上必須有，它會驗證每個聯結器而不是每個動作。
即使每個動作是無，應用程式仍會提示登入
關閉 啟用驗證 並部署。 當啟用時，應用程式會通告授權伺服器，即使未閘道任何動作亦然
請勿將存取權杖、宣告集或身分提供者使用者端密碼貼到支援要求中。
ChatGPT增效模組
症狀
嘗試什麼
外掛程式未出現
啟用開發人員模式、開啟chatgpt.com/plugins、驗證外掛程式是否存在，並選取連線
外掛程式建立失敗
確認開發人員模式已啟用，從 測試應用程式 再次複製MCP伺服器URL，並使用 伺服器URL 搭配無驗證
外掛程式會連線，但無法叫用動作
確認外掛程式已附加至聊天、動作已公開至模型，且已部署最新版本
外掛程式使用錯誤的環境
使用預期的階段或生產MCP伺服器URL編輯或重新建立外掛程式
如果問題持續發生，在聯絡Beta團隊之前，先記錄應用程式名稱、環境、失敗的步驟、時間以及顯示的錯誤訊息。 請勿包含機密或敏感的客戶資料。
recommendation-more-help
llm-apps-help-main-toc