---
url: 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/resolucao-de-problemas'
title: 'Resolução de problemas de IA | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T11:46:22+00:00'
updated: '2026-10-24T17:19:22+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: '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.'
tags:
  - 'Fix a problem'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T17:19:22+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'Resolução de problemas de IA'
      description: '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.'
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T11:46:22+0000'
      dateModified: '2026-10-24T17:19:22+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/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/resolucao-de-problemas'
      articleSection: 'Resolver um problema'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/resolucao-de-problemas'
      description: '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.'
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: Início
            item: 'https://dxpr.com/pt-pt'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: pt-pt
---
[Centro de ajuda](/pt-pt/node/75)/[Documentação](/pt-pt/hc/documentacao) /[Aprender DXPR Builder](/pt-pt/hc/documentation/learn-dxpr-builder) /[Gerir o site](/pt-pt/hc/documentation/learn-dxpr-builder/manage) /[Resolver um problema](/pt-pt/hc/documentation/learn-dxpr-builder/troubleshooting) # Resolução de problemas de IA.

 Aprender DXPR BuilderGerir o siteResolver um problema

   ## Neste guia

 Guias relacionados

- [Ativar a IA no DXPR Builder](/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/ativacao)

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_dxpr` e depois `drush 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](/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/configuracao#ai-output-filtering).

## 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](/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/ativacao) para verificar cada definição desde o início.