AI 故障排查.

Learn DXPR BuilderManage the siteEen probleem oplossen

当 AI 按钮缺失、灰色不可用或返回错误时，找到原因。大多数问题来自三处：DXPR 密钥、DXPR Builder AI 页面上的开关，或您的 DXPR 积分。

文本工具栏中的 AI Agent 按钮及其命令下拉菜单，本应出现的位置

AI 按钮灰色不可用

  • 指向 AI 按钮显示“AI features are unavailable: no AI provider is configured.”。 DXPR 没有设为 AI 提供方，或其密钥为空。请前往 Configuration > AI > AI Infrastructure > AI Platform Providers > DXPR AI Provider (/admin/config/ai/providers/dxpr)，在 DXPR API Key 下选择您的密钥并点击 Save configuration。
  • 消息说“AI features require the AI module.”。 AI 模块没有安装。请运行 composer require drupal/ai_provider_dxpr，再运行 drush en ai_provider_dxpr。

缺少 AI 按钮

在 DXPR Studio > DXPR Builder > AI (/admin/dxpr_studio/dxpr_builder/ai_settings) 上的每个开关隐藏各自的工具：

  • 文本工具栏中没有 AI Agent 或 Tone of voice。 Enable text editing assistant 为关闭状态。带自己文本编辑器按钮的用户档案也可能排除它们：请向档案添加 AI Assistant 和 AI Tone of Voice。
  • 构建器工具栏上没有 AI Agent，空页面上没有提示，More 菜单中没有 Edit with AI。 Enable page creation assistant 为关闭状态。
  • Image 元素上没有 Edit with AI，Background image 下没有 AI Image Generation。 Enable image generation 为关闭状态。

更改开关后，请点击 Save settings 并重新加载您编辑的页面。

请求失败

  • 文本工具栏说“AI service is currently unavailable. Please try again later.”。 DXPR 没有回答请求。请一分钟后重试。如果一直失败，请检查提供方页面上的密钥和您的积分。
  • 页面或元素请求说“The AI service ran into a problem processing this request.”。 同样的原因，来自页面和元素工具。请重试，再检查密钥和积分。
  • 图片显示“Image generation failed. Please try again.”或“Image editing failed. Please try again.”。 DXPR 未能创建图片，常因积分或描述违反内容规则。请点击 Retry，或点击 Cancel 并修改描述。
  • 警告说“Your AI credit balance is low”。 剩余积分不足 5000。请用完之前在 dxpr.com/user/me/subscription/credits 充值。

积分

Usage and Credits（DXPR Builder AI 页面上）显示 Credits remaining 和本月已用积分。当它显示“Unable to load usage data”时，DXPR Builder 无法用 General Settings 下的产品密钥连接到 dxpr.com：请检查该密钥和服务器的网络连接。用空账户保存提供方表单会显示“You are using the Free Tier of DXPR or have run out of quota.”。

结果慢或弱

  • 回答很慢。 长文本和整页需要更久。DXAI Kavya M1 Fast 回答更快但质量较低；在提供方页面的 Default model 下选择它，或选择 Model（编辑器 AI Settings 对话框中）。
  • 文本泛泛。 请说明谁读页面、页面用途和哪些事实重要。运行命令前先在 Tone of voice 下选择语气。
  • 结果中的链接或图片缺失。 AI Output Filtering 移除了指向不在 Allowed domains 中的域名的链接。请参阅 AI 配置。

确认修复

在构建器中重新加载页面。工具栏上的 AI Agent 按钮不再灰色不可用。文本工具栏以 AI Agent 和 Tone of voice 开头。对一句话运行 Polish 等短命令会返回新文本。

接下来做什么？

在 DXPR Builder 中开启 AI，从头检查每个设置。