Dépannage IA.

Trouvez la cause quand un bouton IA manque, est grisé ou renvoie une erreur. La plupart des problèmes viennent de l’un de trois endroits : la clé DXPR, les interrupteurs de la page AI de DXPR Builder, ou vos crédits DXPR.

Les boutons IA sont grisés

• Pointer un bouton IA affiche « AI features are unavailable: no AI provider is configured. » DXPR n’est pas configuré comme fournisseur IA, ou sa clé est vide. Accédez à Configuration > AI > AI Infrastructure > AI Platform Providers > DXPR AI Provider (/admin/config/ai/providers/dxpr), choisissez votre clé sous DXPR API Key et cliquez sur Save configuration.
• Le message dit « AI features require the AI module. » Le module AI n’est pas installé. Exécutez composer require drupal/ai_provider_dxpr, puis drush en ai_provider_dxpr.

Un bouton IA manque

Chaque interrupteur sous DXPR Studio > DXPR Builder > AI (/admin/dxpr_studio/dxpr_builder/ai_settings) masque ses propres outils :

• Pas de AI Agent ni de Tone of voice dans la barre d’outils du texte. Enable text editing assistant est désactivé. Un profil d’utilisateur avec ses propres boutons d’éditeur de texte peut aussi les exclure : ajoutez AI Assistant et AI Tone of Voice au profil.
• Pas de AI Agent sur la barre d’outils du builder, pas de prompt sur une page vide et pas de Edit with AI dans les menus More. Enable page creation assistant est désactivé.
• Pas de Edit with AI sur les éléments Image, ni de AI Image Generation sous Background image. Enable image generation est désactivé.

Après avoir changé un interrupteur, cliquez sur Save settings et rechargez la page modifiée.

Une requête échoue

• La barre d’outils du texte dit « AI service is currently unavailable. Please try again later. » DXPR n’a pas répondu à la demande. Réessayez dans une minute. Si cela continue d’échouer, vérifiez la clé sur la page du fournisseur et vos crédits.
• Une demande de page ou d’élément dit « The AI service ran into a problem processing this request. » La même cause, depuis les outils de page et d’élément. Réessayez, puis vérifiez la clé et vos crédits.
• Une image affiche « Image generation failed. Please try again. » ou « Image editing failed. Please try again. » DXPR n’a pas pu créer l’image, souvent à cause des crédits ou d’une description qui enfreint les règles de contenu. Cliquez sur Retry, ou sur Cancel et changez la description.
• Un avertissement dit « Your AI credit balance is low ». Il reste moins de 5 000 crédits. Rechargez sur dxpr.com/user/me/subscription/credits avant la panne.

Crédits

Usage and Credits sur la page AI de DXPR Builder montre Credits remaining et les crédits utilisés ce mois-ci. Quand il affiche « Unable to load usage data », DXPR Builder n’a pas pu joindre dxpr.com avec la clé de produit sous General Settings : vérifiez cette clé et l’accès internet du serveur. Enregistrer le formulaire du fournisseur avec un compte vide affiche « You are using the Free Tier of DXPR or have run out of quota. »

Des résultats lents ou faibles

• Les réponses prennent du temps. Les longs textes et les pages entières prennent plus longtemps. DXAI Kavya M1 Fast répond plus vite avec une qualité moindre ; choisissez-le sous Default model sur la page du fournisseur, ou sous Model dans le dialogue AI Settings de l’éditeur.
• Le texte est générique. Dites qui lit la page, à quoi elle sert et quels faits comptent. Choisissez un ton sous Tone of voice avant d’exécuter une commande.
• Des liens ou images manquent dans le résultat. AI Output Filtering a retiré les liens vers les domaines hors Allowed domains. Voir Configuration de l’IA.

Confirmer la correction

Rechargez la page dans le builder. Le bouton AI Agent de la barre d’outils n’est plus grisé. La barre d’outils du texte commence par AI Agent et Tone of voice. Une courte commande comme Polish sur une phrase renvoie du nouveau texte.

Et ensuite ?

Activer l’IA dans DXPR Builder pour vérifier chaque réglage depuis le début.