---
url: 'https://dxpr.com/it/hc/documentation/learn-dxpr-builder/ai/troubleshooting'
title: 'Risoluzione dei problemi AI | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T03:03:51+00:00'
updated: '2026-10-24T06:23:51+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: 'Trova la causa quando un pulsante AI manca, è disabilitato o restituisce un errore. La maggior parte dei problemi viene da uno di tre posti: la chiave DXPR, gli interruttori nella pagina AI di DXPR Builder o i tuoi crediti 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: 'Risoluzione dei problemi AI'
      description: 'Trova la causa quando un pulsante AI manca, è disabilitato o restituisce un errore. La maggior parte dei problemi viene da uno di tre posti: la chiave DXPR, gli interruttori nella pagina AI di DXPR Builder o i tuoi crediti DXPR.'
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T03:03:51+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/it/hc/documentation/learn-dxpr-builder/ai/troubleshooting'
      articleSection: 'Een probleem oplossen'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/it/hc/documentation/learn-dxpr-builder/ai/troubleshooting'
      description: 'Trova la causa quando un pulsante AI manca, è disabilitato o restituisce un errore. La maggior parte dei problemi viene da uno di tre posti: la chiave DXPR, gli interruttori nella pagina AI di DXPR Builder o i tuoi crediti DXPR.'
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: Home
            item: 'https://dxpr.com/it'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: it
---
[Help Center](/it/hc)/[Documentation](/it/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) # Risoluzione dei problemi AI.

 Learn DXPR BuilderManage the siteEen probleem oplossen

   ## In this guide

 Related guides

- [Accendi l’AI in DXPR Builder](/it/hc/documentation/learn-dxpr-builder/ai/setup)

Trova la causa quando un pulsante AI manca, è disabilitato o restituisce un errore. La maggior parte dei problemi viene da uno di tre posti: la chiave DXPR, gli interruttori nella pagina **AI** di DXPR Builder o i tuoi crediti DXPR.

## I pulsanti AI sono disabilitati

- **Puntando un pulsante AI compare "AI features are unavailable: no AI provider is configured."** DXPR non è impostato come provider AI, oppure la sua chiave è vuota. Vai in **Configuration** > **AI** > **AI Infrastructure** > **AI Platform Providers** > **DXPR AI Provider** (`/admin/config/ai/providers/dxpr`), scegli la tua chiave in **DXPR API Key** e fai clic su **Save configuration**.
- **Il messaggio dice "AI features require the AI module."** Il modulo AI non è installato. Esegui `composer require drupal/ai_provider_dxpr`, poi `drush en ai_provider_dxpr`.

## Manca un pulsante AI

Ogni interruttore in **DXPR Studio** > **DXPR Builder** > **AI** (`/admin/dxpr_studio/dxpr_builder/ai_settings`) nasconde i suoi strumenti:

- **Nessun AI Agent o Tone of voice nella barra del testo.** **Enable text editing assistant** è disattivato. Anche un profilo utente con i propri pulsanti dell’editor di testo può escluderli: aggiungi **AI Assistant** e **AI Tone of Voice** al profilo.
- **Nessun AI Agent nella barra del builder, nessun prompt in una pagina vuota e nessun Edit with AI nei menu More.** **Enable page creation assistant** è disattivato.
- **Nessun Edit with AI sugli elementi Image e nessuna AI Image Generation in Background image.** **Enable image generation** è disattivato.

Dopo aver cambiato un interruttore, fai clic su **Save settings** e ricarica la pagina che modifichi.

## Una richiesta fallisce

- **La barra del testo dice "AI service is currently unavailable. Please try again later."** DXPR non ha risposto alla richiesta. Riprova tra un minuto. Se continua a fallire, controlla la chiave nella pagina del provider e i tuoi crediti.
- **Una richiesta di pagina o elemento dice "The AI service ran into a problem processing this request."** La stessa causa, dagli strumenti di pagina ed elemento. Riprova, poi controlla la chiave e i tuoi crediti.
- **Un’immagine mostra "Image generation failed. Please try again." o "Image editing failed. Please try again."** DXPR non ha potuto creare l’immagine, spesso per i crediti o per una descrizione che viola le regole sui contenuti. Fai clic su **Retry**, oppure su **Cancel** e cambia la descrizione.
- **Un avviso dice "Your AI credit balance is low".** Restano meno di 5.000 crediti. Ricarica in dxpr.com/user/me/subscription/credits prima di esaurirli.

## Crediti

**Usage and Credits** nella pagina **AI** di DXPR Builder mostra **Credits remaining** e i crediti usati questo mese. Quando dice "Unable to load usage data", DXPR Builder non ha raggiunto dxpr.com con la chiave prodotto in **General Settings**: controlla quella chiave e l’accesso a internet del server. Salvare il form del provider con un account vuoto mostra "You are using the Free Tier of DXPR or have run out of quota."

## Risultati lenti o deboli

- **Le risposte richiedono tempo.** Testi lunghi e pagine intere richiedono più tempo. **DXAI Kavya M1 Fast** risponde più in fretta a qualità minore; sceglilo in **Default model** nella pagina del provider, oppure in **Model** nella finestra **AI Settings** dell’editor.
- **Il testo è generico.** Di’ chi legge la pagina, a cosa serve e quali fatti contano. Scegli un tono in **Tone of voice** prima di eseguire un comando.
- **Nel risultato mancano link o immagini.** **AI Output Filtering** ha rimosso i link a domini fuori da **Allowed domains**. Vedi [Configurazione AI](/it/hc/documentation/learn-dxpr-builder/ai/configuration#ai-output-filtering).

## Conferma la soluzione

Ricarica la pagina nel builder. Il pulsante **AI Agent** sulla barra non è più disabilitato. La barra del testo inizia con **AI Agent** e **Tone of voice**. Un comando breve come **Polish** su una frase restituisce nuovo testo.

## Prossimi passi

[Accendi l’AI in DXPR Builder](/it/hc/documentation/learn-dxpr-builder/ai/setup) per controllare ogni impostazione dall’inizio.