Modelos e fornecedores de IA.

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.

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

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):

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
• Referência da API de IA
• Resolução de problemas de IA