---
url: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/ai/troubleshooting'
title: 'AI 故障排查 | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T00:45:12+00:00'
updated: '2026-10-24T06:23:51+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: '当 AI 按钮缺失、灰色不可用或返回错误时，找到原因。大多数问题来自三处：DXPR 密钥、DXPR Builder AI 页面上的开关，或您的 DXPR 积分。'
tags:
  - 'Een probleem oplossen'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T06:23:51+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'AI 故障排查'
      description: '当 AI 按钮缺失、灰色不可用或返回错误时，找到原因。大多数问题来自三处：DXPR 密钥、DXPR Builder AI 页面上的开关，或您的 DXPR 积分。'
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T00:45:12+0000'
      dateModified: '2026-10-24T06:23:51+0000'
      author:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      mainEntityOfPage: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/ai/troubleshooting'
      articleSection: 'Een probleem oplossen'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/ai/troubleshooting'
      description: '当 AI 按钮缺失、灰色不可用或返回错误时，找到原因。大多数问题来自三处：DXPR 密钥、DXPR Builder AI 页面上的开关，或您的 DXPR 积分。'
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: 首页
            item: 'https://dxpr.com/zh-hans'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: zh-hans
---
[Help Center](/zh-hans/node/75)/[Documentation](/zh-hans/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Manage the site](/hc/documentation/learn-dxpr-builder/manage) /[Een probleem oplossen](/hc/documentation/learn-dxpr-builder/troubleshooting) # AI 故障排查.

 Learn DXPR BuilderManage the siteEen probleem oplossen

   ## In this guide

 Related guides

- [在 DXPR Builder 中开启 AI](/zh-hans/hc/documentation/learn-dxpr-builder/ai/setup)

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

## 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 配置](/zh-hans/hc/documentation/learn-dxpr-builder/ai/configuration#ai-output-filtering)。

## 确认修复

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

## 接下来做什么？

[在 DXPR Builder 中开启 AI](/zh-hans/hc/documentation/learn-dxpr-builder/ai/setup)，从头检查每个设置。