--- url: 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/modelos-e-fornecedores' title: 'Modelos e fornecedores de IA | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T11:45:55+00:00' updated: '2026-10-24T17:19:22+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: |- As funcionalidades de IA do DXPR Builder correm através do módulo AI do Drupal e do módulo do fornecedor DXPR (ai_provider_dxpr). Esta página explica o que é um fornecedor, como o fornecedor DXPR se encaixa, que modelos existem e o que significam os "fornecedores de serviços" e os pesos nas páginas de definições. O vídeo escolhe o modelo da UE no editor e mostra-o no painel AI Agent. tags: - 'Write and design with AI' 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: 'Modelos e fornecedores de IA' description: |- As funcionalidades de IA do DXPR Builder correm através do módulo AI do Drupal e do módulo do fornecedor DXPR (ai_provider_dxpr). Esta página explica o que é um fornecedor, como o fornecedor DXPR se encaixa, que modelos existem e o que significam os "fornecedores de serviços" e os pesos nas páginas de definições. O vídeo escolhe o modelo da UE no editor e mostra-o no painel AI Agent. image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T11:45:55+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/modelos-e-fornecedores' articleSection: 'Escrever e desenhar com IA' - '@type': WebPage '@id': 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/modelos-e-fornecedores' description: |- As funcionalidades de IA do DXPR Builder correm através do módulo AI do Drupal e do módulo do fornecedor DXPR (ai_provider_dxpr). Esta página explica o que é um fornecedor, como o fornecedor DXPR se encaixa, que modelos existem e o que significam os "fornecedores de serviços" e os pesos nas páginas de definições. O vídeo escolhe o modelo da UE no editor e mostra-o no painel AI Agent. 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) /[Criar páginas](/pt-pt/hc/documentation/learn-dxpr-builder/build) /[Escrever e desenhar com IA](/pt-pt/hc/documentation/learn-dxpr-builder/ai) # Modelos e fornecedores de IA. Aprender DXPR BuilderCriar páginasEscrever e desenhar com IA ## Neste guia Guias relacionados - [Configuração de IA](/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/configuracao) - [Referência da API de IA](/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/referencia-da-api-de-ia) - [Resolução de problemas de IA](/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/resolucao-de-problemas) As funcionalidades de IA do DXPR Builder correm através do módulo AI do Drupal e do módulo do fornecedor DXPR (`ai_provider_dxpr`). Esta página explica o que é um fornecedor, como o fornecedor DXPR se encaixa, que modelos existem e o que significam os "fornecedores de serviços" e os pesos nas páginas de definições. O vídeo escolhe o modelo da UE no editor e mostra-o no painel AI Agent. ## Fornecedores no módulo AI do Drupal No módulo AI, um fornecedor é um plugin que liga um serviço de IA. Cada fornecedor declara os tipos de operação suportados, como chat, texto para imagem, imagem para imagem e tradução de texto. Também enumera os modelos e guarda as próprias definições de chave de API. Os fornecedores instalados estão enumerados em **Configuration** > **AI** > **AI Infrastructure** > **AI Platform Providers** (`/admin/config/ai/providers`). Isto precisa da permissão `administer ai providers`. O fornecedor e o modelo predefinidos de cada tipo de operação definem-se em **Configuration** > **AI** > **AI Infrastructure** > **Default Models for AI Operations** (`/admin/config/ai/settings`). Ficam guardados em `ai.settings` como `default_providers`. ## O fornecedor DXPR `ai_provider_dxpr` regista o fornecedor com o ID `dxpr` e a etiqueta "DXPR". Suporta `chat`, `text_to_image`, `image_to_image` e `translate_text`, transmite o resultado do chat em fluxo e fala com `kavya.dxpr.com/v1` com a chave de API selecionada no módulo Key. O formulário de definições está em `/admin/config/ai/providers/dxpr` (**DXPR AI Provider**): - **DXPR API Key**: a entidade Key que guarda a chave de API DXPR (criada em `/admin/config/system/keys`; ao instalar, o módulo seleciona uma chave cuja etiqueta contém "DXPR") - **AI Usage Tracking**: saldo e uso de créditos - **Default model** e **Allowed models**: ver Modelos abaixo - **AI Service Providers**: Automatic ou Manual Override, com uma tabela de arrastar dos serviços a montante - **Em-dash processor**: nível de pós-processamento, com substituições por idioma Guardar o formulário também regista `dxpr` como o fornecedor predefinido para cada tipo de operação que ainda não tem predefinição. As variantes de chat e a tradução de texto recebem `kavya-m1`. Texto para imagem e imagem para imagem recebem `kavya-image`. Guardar também envia um pedido curto de teste para verificar a chave e o limite de débito da conta. A página de IA do DXPR Builder mostra depois os créditos e uma ligação para este formulário: **Configure AI service providers**. ## Que fornecedor o DXPR Builder usa O DXPR Builder envia cada pedido de IA para o fornecedor DXPR pelo nome. Por isso, os comandos de texto, a criação de páginas, a geração de imagens e a edição de imagens usam sempre o fornecedor DXPR. As predefinições em `/admin/config/ai/settings` não mudam isto. As rotas por trás destas funcionalidades estão em [Referência da API de IA](/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/referencia-da-api-de-ia). Outros fornecedores no módulo AI, como OpenAI, Anthropic ou Mistral, não podem servir funcionalidades do DXPR Builder. Podem continuar a ser as predefinições para outras funcionalidades de IA no mesmo site, por exemplo AI Image Alt Text ou AI Translate. ## Modelos | Builder key | API model | Used for | |---|---|---| | `dxai_kavya_m1` | `kavya-m1` | Comandos de texto e criação de páginas (predefinição) | | `dxai_kavya_m1_eu` | `kavya-m1-eu` | Texto, encaminhado para a MistralAI (França) | | `dxai_kavya_m1_fast` | `kavya-m1-fast` | Texto, menor latência | | (none) | `kavya-image` | Geração e edição de imagens, sempre | Um modelo que não está em **Allowed models** é recusado. A rota de chat do DXPR Builder responde `403` com "The selected model is not allowed. Please refresh the page to update your model options." Para outras funcionalidades do módulo AI, o fornecedor responde "The selected model is not allowed by the administrator." Onde se define o modelo de texto predefinido: 1. Com `ai_provider_dxpr` instalado: **Default model** em `/admin/config/ai/providers/dxpr`(`ai_provider_dxpr.settings`, chave `ai_model`). A página de definições de IA do DXPR Builder mostra depois apenas **Configure AI service providers**, a ligação 2. Sem ele: **Default model** e **Allow users to choose model** em **DXPR Studio** > **DXPR Builder** > **AI**(`/admin/dxpr_studio/dxpr_builder/ai_settings`, `dxpr_builder.settings`) ## Escolher um modelo no editor Os editores podem escolher o modelo para os próprios pedidos de IA: 1. Na barra de ferramentas do DXPR Builder, clique em **More** e escolha **AI settings**. 2. Em **Model**, escolha um modelo, por exemplo **DXAI Kavya M1 EU**. 3. Clique em **Save**. 4. Clique em **AI Agent** na barra de ferramentas. O cabeçalho do painel indica o modelo escolhido. A escolha fica guardada no navegador (`ck5-ai-agent:model`). Com **Allowed models**limitado a um modelo, não aparece seletor. ## Fornecedores de serviços e pesos O Kavya M1 é servido por serviços de IA a montante. Os formulários de definições chamam-lhes "fornecedores de serviços": OpenAI, MistralAI, Anthropic, Google Gemini e XAI. Não têm relação com os fornecedores do módulo AI do Drupal; apenas orientam o encaminhamento dentro do serviço DXPR. Duas chaves de configuração controlam isto, guardadas em `ai_provider_dxpr.settings` quando esse módulo está instalado e senão em `dxpr_builder.settings`(esquema em `config/schema/dxpr_builder.schema.yml`): | Key | Values | Effect | |---|---|---| | `ai_provider_selection_mode` | `automatic` (predefinição) ou `manual` | Automatic: nenhuma lista de fornecedores é enviada e a DXPR encaminha pelo desempenho em direto. Manual: os fornecedores ativos são enviados com o pedido | | `ai_providers` | Por fornecedor: `enabled`, `weight`, `region` | `weight` é um inteiro; menor significa maior prioridade. `region` é `enabled` ou `disabled` (a secção da tabela onde a linha está) | No modo manual, o formatador de campo passa os fornecedores ativos para o navegador. O navegador ordena-os por peso, do menor para o maior, e envia-os como uma cadeia `providers` separada por vírgulas com cada pedido de chat, por exemplo `openai,mistral,anthropic`. O serviço DXPR usa o primeiro fornecedor e recorre para o seguinte ativo quando está indisponível ou lento. Os pesos só são enviados quando o modelo é `kavya-m1`; os modelos EU e Fast têm encaminhamento fixo. Pesos predefinidos: OpenAI 0, MistralAI 1, Anthropic 2, Google Gemini 3, XAI 4. Arrastar uma linha para cima na tabela baixa o peso. Para mudar a ordem: 1. Aceda a `/admin/config/ai/providers/dxpr` (ou `/admin/dxpr_studio/dxpr_builder/ai_settings`sem o módulo do fornecedor) 2. Defina **Default model** como DXAI Kavya M1; as opções de fornecedor escondem-se para outros modelos 3. Escolha **Manual Override** (**Manual priority**na página do DXPR Builder) 4. Arraste fornecedores entre as secções Enabled e Disabled e para a ordem pretendida 5. Clique em **Save configuration** (**Save settings**na página do DXPR Builder) ## Créditos de IA As funcionalidades de IA consomem créditos DXPR da subscrição. Verifique os créditos restantes em **DXPR Studio** > **DXPR Builder** > **AI** em **Usage and Credits**, ou em **AI Usage Tracking** no formulário DXPR AI Provider. Carregue em dxpr.com/user/me/subscription/credits. ## O que se segue? - [Configuração de IA](/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/configuracao) - [Referência da API de IA](/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/referencia-da-api-de-ia) - [Resolução de problemas de IA](/pt-pt/hc/documentacao/aprender-dxpr-builder/ia/resolucao-de-problemas)