---
url: 'https://dxpr.com/pt-pt/hc/documentation/learn-dxpr-builder/ai/setup'
title: 'Ativar a IA no DXPR Builder | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T11:46:10+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: 'Ligue o DXPR Builder ao serviço de IA da DXPR e escolha que ferramentas de IA os editores recebem. No fim, o botão AI Agent está na barra de ferramentas do construtor de cada página. Precisa de uma conta DXPR e dos módulos de IA instalados. A utilização da IA é paga em créditos DXPR. O vídeo liga a chave, ativa as ferramentas e abre uma página para mostrar o botão.'
tags:
  - 'Schrijven en ontwerpen met AI'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T11:46:10+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'Ativar a IA no DXPR Builder'
      description: 'Ligue o DXPR Builder ao serviço de IA da DXPR e escolha que ferramentas de IA os editores recebem. No fim, o botão AI Agent está na barra de ferramentas do construtor de cada página. Precisa de uma conta DXPR e dos módulos de IA instalados. A utilização da IA é paga em créditos DXPR. O vídeo liga a chave, ativa as ferramentas e abre uma página para mostrar o botão.'
      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:10+0000'
      dateModified: '2026-10-24T11:46:10+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/documentation/learn-dxpr-builder/ai/setup'
      articleSection: 'Schrijven en ontwerpen met AI'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/pt-pt/hc/documentation/learn-dxpr-builder/ai/setup'
      description: 'Ligue o DXPR Builder ao serviço de IA da DXPR e escolha que ferramentas de IA os editores recebem. No fim, o botão AI Agent está na barra de ferramentas do construtor de cada página. Precisa de uma conta DXPR e dos módulos de IA instalados. A utilização da IA é paga em créditos DXPR. O vídeo liga a chave, ativa as ferramentas e abre uma página para mostrar o botão.'
      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
---
[Help Center](/pt-pt/node/75)/[Documentation](/pt-pt/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Build pages](/hc/documentation/learn-dxpr-builder/build) /[Schrijven en ontwerpen met AI](/hc/documentation/learn-dxpr-builder/ai) # Ativar a IA no DXPR Builder.

 Learn DXPR BuilderBuild pagesSchrijven en ontwerpen met AI

   ## In this guide

 Related guides

- [Reescrever texto com IA](/pt-pt/hc/documentation/learn-dxpr-builder/ai/text-commands)
- [Criar uma página com IA](/pt-pt/hc/documentation/learn-dxpr-builder/ai/page-creation)
- [Configuração de IA](/pt-pt/hc/documentation/learn-dxpr-builder/ai/configuration)

Ligue o DXPR Builder ao serviço de IA da DXPR e escolha que ferramentas de IA os editores recebem. No fim, o botão **AI Agent** está na barra de ferramentas do construtor de cada página. Precisa de uma conta DXPR e dos módulos de IA instalados. A utilização da IA é paga em créditos DXPR. O vídeo liga a chave, ativa as ferramentas e abre uma página para mostrar o botão.

  ## Antes de começar

- Instale o fornecedor de IA da DXPR: execute `composer require drupal/ai_provider_dxpr` e depois `drush en ai_provider_dxpr`. Isto também instala os módulos **AI** e **Key**.
- Obtenha a chave de API na conta DXPR. O registo em dxpr.com é gratuito.
- Guarde a chave no Drupal. Aceda a **Configuration** > **System** > **Keys** (`/admin/config/system/keys`) e clique em **Add Key**. Dê-lhe uma etiqueta com "DXPR", escolha o tipo de chave **Authentication** e cole a chave.
- Precisa das permissões **Administer LLM Providers** e **Administer DXPR Builder configuration**.

## Configuração

1. Aceda a **Configuration** > **AI** > **AI Infrastructure** > **AI Platform Providers** > **DXPR AI Provider** (`/admin/config/ai/providers/dxpr`).
2. Em **DXPR API Key**, escolha a chave guardada.
3. Escolha o **Default model**. **DXAI Kavya M1** serve para a maioria dos sites.
4. Clique em **Save configuration**.
5. Aceda a **DXPR Studio** > **DXPR Builder** > **AI** (`/admin/dxpr_studio/dxpr_builder/ai_settings`).
6. Verifique **Credits remaining** em **Usage and Credits**.
7. Em **AI Features**, escolha as ferramentas que os editores recebem: **Enable text editing assistant**, **Enable page creation assistant** e **Enable image generation**.
8. Clique em **Save settings**.
9. Abra uma página que usa o DXPR Builder e aponte para a barra de ferramentas no canto superior direito do conteúdo.
10. Clique em **AI Agent**: abre a prompt para o primeiro pedido.

Guardar o formulário do fornecedor torna a DXPR o fornecedor de IA predefinido do site, salvo se outro já tinha sido escolhido. O DXPR Builder usa sempre a DXPR, qualquer que seja a predefinição escolhida depois.

## O que vê

A barra de ferramentas do construtor tem agora um botão **AI Agent** junto a **Show history**. Numa página vazia, uma caixa de prompt fica acima de **Generate content**. Clique num texto e a barra de ferramentas de texto começa com **AI Agent** e **Tone of voice**. O menu **More** de cada elemento tem **Edit with AI**.

Os créditos usados este mês aparecem abaixo de **Credits remaining**. Abra a **página de subscrição** para carregar.

## Definições

| Setting | What it does | Default |
|---|---|---|
| **Default model** | **DXAI Kavya M1** dá os melhores resultados. **DXAI Kavya M1 EU** mantém o texto na MistralAI em França. **DXAI Kavya M1 Fast** responde mais depressa com menor qualidade | DXAI Kavya M1 |
| **Allowed models** | Os modelos para que os editores podem mudar. Com um modelo marcado, os editores não veem escolha de modelo | All three |
| **Enable text editing assistant** | Os botões **AI Agent** e **Tone of voice** na barra de ferramentas de texto | On |
| **Enable page creation assistant** | A prompt em páginas vazias, o botão **AI Agent** na barra de ferramentas e **Edit with AI** | On |
| **Enable image generation** | **Edit with AI** em elementos Image e o botão **AI Image Generation** para imagens de fundo | On |

[Configuração de IA](/hc/documentation/learn-dxpr-builder/ai/configuration) explica todas as outras definições na página de IA.

## Se o botão AI Agent não aparece

- **The AI Agent button is greyed out, and its tooltip says no AI provider is configured.** Não há chave escolhida no formulário do fornecedor, ou o formulário nunca foi guardado. Escolha a chave em `/admin/config/ai/providers/dxpr` e clique em **Save configuration**.
- **There is no AI Agent button at all.** **Enable page creation assistant** está desligado. Marque-o em `/admin/dxpr_studio/dxpr_builder/ai_settings` e clique em **Save settings**.
- **The key list under DXPR API Key only shows "- Select a key -".** Ainda não há chave. Adicione uma em `/admin/config/system/keys`.
- **Saving the provider form shows "You are using the Free Tier of DXPR or have run out of quota."** A conta não tem créditos. Carregue em dxpr.com/user/me/subscription/credits.
- **Usage and Credits reads "Unable to load usage data".** O DXPR Builder não conseguiu contactar dxpr.com com a chave de produto em **General Settings**. Verifique a chave de produto e o acesso do servidor à Internet e recarregue a página.

## O que se segue?

- [Reescrever texto com IA](/hc/documentation/learn-dxpr-builder/ai/text-commands): mude o tom ou o comprimento de um parágrafo.
- [Criar uma página com IA](/hc/documentation/learn-dxpr-builder/ai/page-creation): transforme um resumo curto numa página completa.
- [Configuração de IA](/hc/documentation/learn-dxpr-builder/ai/configuration): tons, comandos e filtragem de resultados.