疑難排解 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。 修正相依性、語法或測試失敗,並推送變更部署成功,但缺少變更
確認預期的認可已推送並重新部署到相同環境
動作仍為未部署
在檢閱動作或變更其中繼資料後再次部署
ChatGPT增效模組
症狀
嘗試什麼
外掛程式未出現
啟用開發人員模式、開啟chatgpt.com/plugins、驗證外掛程式是否存在,並選取連線
外掛程式建立失敗
確認開發人員模式已啟用,從 測試應用程式 再次複製MCP伺服器URL,並使用 伺服器URL 搭配無驗證
外掛程式會連線,但無法叫用動作
確認外掛程式已附加至聊天、動作已公開至模型,且已部署最新版本
外掛程式使用錯誤的環境
使用預期的階段或生產MCP伺服器URL編輯或重新建立外掛程式
如果問題持續發生,在聯絡Beta團隊之前,先記錄應用程式名稱、環境、失敗的步驟、時間以及顯示的錯誤訊息。 請勿包含機密或敏感的客戶資料。
recommendation-more-help
llm-apps-help-main-toc