疑难解答 troubleshooting
IMPORTANT
Adobe LLM Apps当前在Beta中。
此处显示的功能、工作流和UI不一定表示产品的最终状态。 要加入Beta,请发送电子邮件至llm-apps-beta@adobe.com 。
从您所看到的症状开始。 进行故障排除时,请勿共享凭据、令牌、专用MCP URL或敏感处理程序结果。
应用程序创建和载入
症状
尝试什么
新存储库不显示
选择在GitHub上管理存储库,授予Adobe LLM应用程序GitHub应用程序访问这两个存储库的权限,返回到对话框,并刷新列表
EDS存储库需要AEM代码同步
为EDS存储库安装AEM代码同步,然后返回创建LLM应用程序对话框
EDS验证表明您不是管理员
选择打开AEM Live Admin,将自己添加为EDS网站的管理员,然后刷新存储库
载入仍在生成
等待大约15分钟。 您可以离开页面并稍后返回
载入报告失败
确认两个存储库均可访问,并且网站是通过HTTPS公开的,然后联系Beta团队并提供显示的错误消息
操作和处理程序
症状
尝试什么
未调用操作
附加ChatGPT插件,确认已启用向AI模型公开,改进操作说明并重新部署元数据更改
空响应或错误响应
处理程序在本地工作,但在部署后无法正常工作
确认已推送最新的提交,存在运行时配置,并且操作代码标识符与
actions/<code-identifier>/index.js匹配无法将生成的操作标记为已审阅
确认已成功生成处理程序和构件。 检查生成的拉取请求是否存在合并冲突,重新加载操作,然后再次选择标记为已审核
小组件
症状
尝试什么
构件未呈现
验证脚本URL、构件URL、HTTPS、EDS发布、CSP域和CORS标头
构件将呈现,但不显示数据
使用MCP检查器调用处理程序,并将其
structuredContent形状与从bridge.toolResult读取的字段进行比较构件在直接预览中起作用,但在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