Resolução de problemas de IA.
Encontre a causa quando um botão de IA falta, está desativado ou devolve um erro. A maioria dos problemas vem de um de três lugares: a chave DXPR, os interrutores na página AI do DXPR Builder, ou os créditos DXPR.

Botões de IA desativados
- Pointing at an AI button shows "AI features are unavailable: no AI provider is configured." A DXPR não está configurada como fornecedor de IA, ou a chave está vazia. Aceda a Configuration > AI > AI Infrastructure > AI Platform Providers > DXPR AI Provider (
/admin/config/ai/providers/dxpr), escolha a chave em DXPR API Key e clique em Save configuration. - The message says "AI features require the AI module." O módulo AI não está instalado. Execute
composer require drupal/ai_provider_dxpre depoisdrush en ai_provider_dxpr.
Falta um botão de IA
Cada interrutor em DXPR Studio > DXPR Builder > AI (/admin/dxpr_studio/dxpr_builder/ai_settings) esconde as próprias ferramentas:
- No AI Agent or Tone of voice in the text toolbar. Enable text editing assistant está desligado. Um perfil de utilizador com botões próprios do editor de texto também os pode excluir: adicione AI Assistant e AI Tone of Voice ao perfil.
- No AI Agent on the builder toolbar, no prompt on an empty page and no Edit with AI in the More menus. Enable page creation assistant está desligado.
- No Edit with AI on Image elements, and no AI Image Generation under Background image. Enable image generation está desligado.
Após mudar um interrutor, clique em Save settings e recarregue a página que edita.
Um pedido falha
- The text toolbar says "AI service is currently unavailable. Please try again later." A DXPR não respondeu ao pedido. Tente outra vez dentro de um minuto. Se continua a falhar, verifique a chave na página do fornecedor e os créditos.
- A page or element request says "The AI service ran into a problem processing this request." A mesma causa, das ferramentas de página e elemento. Tente outra vez e verifique a chave e os créditos.
- An image shows "Image generation failed. Please try again." or "Image editing failed. Please try again." A DXPR não conseguiu criar a imagem, muitas vezes por causa dos créditos ou de uma descrição que viola as regras de conteúdo. Clique em Retry, ou em Cancel e mude a descrição.
- A warning says "Your AI credit balance is low". Restam menos de 5000 créditos. Carregue em dxpr.com/user/me/subscription/credits antes de esgotar.
Créditos
Usage and Credits na página AI do DXPR Builder mostra Credits remaining e os créditos usados este mês. Quando indica "Unable to load usage data", o DXPR Builder não conseguiu contactar dxpr.com com a chave de produto em General Settings: verifique essa chave e o acesso do servidor à Internet. Guardar o formulário do fornecedor com uma conta vazia mostra "You are using the Free Tier of DXPR or have run out of quota."
Resultados lentos ou fracos
- Answers take long. Textos longos e páginas inteiras demoram mais. DXAI Kavya M1 Fast responde mais depressa com menor qualidade; escolha-o em Default model na página do fornecedor, ou em Model no diálogo AI Settings do editor.
- The text is generic. Diga quem lê a página, para que serve e que factos importam. Escolha um tom em Tone of voice antes de correr um comando.
- Links or images in the result are missing. AI Output Filtering removeu ligações para domínios que não estão em Allowed domains. Consulte Configuração de IA.
Confirmar a correção
Recarregue a página no construtor. O botão AI Agent na barra de ferramentas já não está desativado. A barra de ferramentas de texto começa com AI Agent e Tone of voice. Um comando curto como Polish numa frase devolve novo texto.
O que se segue?
Ativar a IA no DXPR Builder para verificar cada definição desde o início.