疑難排解 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模型 ​已啟用、改善動作描述,並重新部署中繼資料變更
空白或錯誤回應
執行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值可能包含個人或敏感資料時,請勿記錄這些值。

部署

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

ChatGPT增效模組

症狀
嘗試什麼
外掛程式未出現
啟用開發人員模式、開啟chatgpt.com/plugins、驗證外掛程式是否存在,並選取​連線
外掛程式建立失敗
確認開發人員模式已啟用,從​ 測試應用程式 ​再次複製MCP伺服器URL,並使用​ 伺服器URL ​搭配​無驗證
外掛程式會連線,但無法叫用動作
確認外掛程式已附加至聊天、動作已公開至模型,且已部署最新版本
外掛程式使用錯誤的環境
使用預期的階段或生產MCP伺服器URL編輯或重新建立外掛程式

如果問題持續發生,在聯絡Beta團隊之前,先記錄應用程式名稱、環境、失敗的步驟、時間以及顯示的錯誤訊息。 請勿包含機密或敏感的客戶資料。

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