Усунення несправностей ШІ.

Знайдіть причину, коли кнопка ШІ відсутня, неактивна або повертає помилку. Більшість проблем походять з одного з трьох місць: ключа DXPR, перемикачів на сторінці AI у DXPR Builder або ваших кредитів DXPR.

Кнопки ШІ неактивні

• Наведення на кнопку ШІ показує «AI features are unavailable: no AI provider is configured.» DXPR не налаштовано як провайдера ШІ, або його ключ порожній. Перейдіть до 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.

Кнопки ШІ немає

Кожен перемикач у 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 на панелі інструментів конструктора, немає промпту на порожній сторінці й немає Edit with AI в меню More. Enable page creation assistant вимкнено.
• Немає Edit with AI на елементах Image і немає AI Image Generation у Background image. 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». Лишилося менше 5 000 кредитів. Поповніть на dxpr.com/user/me/subscription/credits, перш ніж вони закінчаться.

Кредити

Usage and Credits на сторінці AI у DXPR Builder показує Credits remaining і кредити, використані цього місяця. Коли там «Unable to load usage data», DXPR Builder не зміг досягти dxpr.com із ключем продукту в General Settings: перевірте цей ключ і доступ сервера до інтернету. Збереження форми провайдера з порожнім обліковим записом показує «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 Agent на панелі інструментів більше не неактивна. Текстова панель інструментів починається з AI Agent і Tone of voice. Коротка команда на кшталт Polish на одному реченні повертає новий текст.

Що далі?

Увімкніть ШІ в DXPR Builder, щоб перевірити кожне налаштування від початку.