AI-modellen en providers.

DXPR Builder lerenPagina’s bouwenSchrijven en ontwerpen met AI

De AI-functies van DXPR Builder draaien via de Drupal AI-module en de DXPR-providermodule (ai_provider_dxpr). Deze pagina legt uit wat een provider is, hoe de DXPR-provider erin past, welke modellen er bestaan en wat de "service providers" en gewichten op de instellingenpagina's betekenen.

De video kiest het EU-model in de editor en toont het in het paneel AI Agent.

Providers in de Drupal AI-module

In de AI-module is een provider een plugin die één AI-service verbindt. Elke provider declareert de bewerkingstypen die hij ondersteunt, zoals chat, tekst naar afbeelding, afbeelding naar afbeelding en tekst vertalen. Hij somt ook zijn modellen op en heeft zijn eigen API-sleutelinstellingen.

Geïnstalleerde providers staan bij Configuration > AI > AI Infrastructure > AI Platform Providers (/admin/config/ai/providers). Hiervoor zijn de rechten administer ai providers nodig. De standaardprovider en het standaardmodel voor elk bewerkingstype worden ingesteld bij Configuration > AI > AI Infrastructure > Default Models for AI Operations (/admin/config/ai/settings). Ze worden opgeslagen in ai.settings als default_providers.

De DXPR-provider

ai_provider_dxpr registreert de provider met ID dxpr en label "DXPR". Hij ondersteunt chat, text_to_image, image_to_image en translate_text, streamt chatoutput en praat met kavya.dxpr.com/v1 met de API-sleutel geselecteerd uit de Key-module. Zijn instellingenformulier staat op /admin/config/ai/providers/dxpr (DXPR AI Provider):

  • DXPR API Key: de Key-entiteit met je DXPR API-sleutel (aangemaakt op /admin/config/system/keys; bij installatie selecteert de module een key waarvan het label "DXPR" bevat)
  • AI Usage Tracking: creditsaldo en gebruik
  • Default model en Allowed models: zie Modellen hieronder
  • AI Service Providers: Automatic of Manual Override, met een sleeptabel van upstreamservices
  • Em-dash processor: nabewerkingsniveau, met overrides per taal

Door het formulier op te slaan wordt dxpr ook geregistreerd als de standaardprovider voor elk bewerkingstype dat nog geen standaard heeft. Chatvarianten en tekst vertalen krijgen kavya-m1. Tekst naar afbeelding en afbeelding naar afbeelding krijgen kavya-image. Opslaan stuurt ook één kort testverzoek om de sleutel en de ratelimit van het account te controleren.

De eigen AI-pagina van DXPR Builder toont daarna je credits en een link naar dit formulier: Configure AI service providers.

Tabblad AI Settings van DXPR Builder met gebruikte credits en functieschakelaars

Welke provider DXPR Builder gebruikt

DXPR Builder stuurt elk AI-verzoek op naam naar de DXPR-provider. Tekstcommando's, paginaopstelling, afbeeldingsgeneratie en afbeeldingsbewerking gebruiken dus altijd de DXPR-provider. De standaarden op /admin/config/ai/settings wijzigen dit niet. De routes achter deze functies staan op AI-API-referentie.

Andere providers in de AI-module, zoals OpenAI, Anthropic of Mistral, kunnen geen DXPR Builder-functies bedienen. Ze kunnen nog steeds de standaarden zijn voor andere AI-functies op dezelfde site, bijvoorbeeld AI Image Alt Text of AI Translate.

Modellen

Buildersleutel API-model Gebruikt voor
dxai_kavya_m1 kavya-m1 Tekstcommando's en paginaopstelling (standaard)
dxai_kavya_m1_eu kavya-m1-eu Tekst, gerouteerd naar MistralAI (Frankrijk)
dxai_kavya_m1_fast kavya-m1-fast Tekst, lagere latentie
(none) kavya-image Afbeeldingsgeneratie en -bewerking, altijd

Een model dat niet op Allowed models staat, wordt geweigerd. De chatroute van DXPR Builder antwoordt 403 met "The selected model is not allowed. Please refresh the page to update your model options." Voor andere AI-modulefuncties antwoordt de provider "The selected model is not allowed by the administrator."

Waar het standaardtekstmodel wordt ingesteld:

  1. Met ai_provider_dxpr geïnstalleerd: Default model op /admin/config/ai/providers/dxpr (ai_provider_dxpr.settings, sleutel ai_model). De AI-instellingenpagina van DXPR Builder toont dan alleen een Configure AI service providers-link
  2. Zonder die: Default model en Allow users to choose model bij DXPR Studio > DXPR Builder > AI (/admin/dxpr_studio/dxpr_builder/ai_settings, dxpr_builder.settings)

Een model kiezen in de editor

Redacteurs kunnen het model voor hun eigen AI-verzoeken kiezen:

  1. Klik op de DXPR Builder-werkbalk op More en kies AI settings.
  2. Kies onder Model een model, bijvoorbeeld DXAI Kavya M1 EU.
  3. Klik op Save.
  4. Klik op de werkbalk op AI Agent. De kop van het paneel noemt het model dat je koos.

De keuze wordt in de browser bewaard (ck5-ai-agent:model). Met Allowed models beperkt tot één model wordt geen selector getoond.

Serviceproviders en gewichten

Kavya M1 wordt bediend door upstream-AI-services. De instellingenformulieren noemen deze "service providers": OpenAI, MistralAI, Anthropic, Google Gemini en XAI. Ze staan los van Drupal AI-moduleproviders; ze sturen alleen routering binnen de DXPR-service. Twee configuratiesleutels beheersen dit, opgeslagen in ai_provider_dxpr.settings wanneer die module is geïnstalleerd en anders in dxpr_builder.settings (schema in config/schema/dxpr_builder.schema.yml):

Sleutel Waarden Effect
ai_provider_selection_mode automatic (standaard) of manual Automatisch: er wordt geen providerlijst verstuurd en DXPR routeert op live performance. Handmatig: de ingeschakelde providers worden met het verzoek meegestuurd
ai_providers Per provider: enabled, weight, region weight is een geheel getal; lager betekent hogere prioriteit. region is enabled of disabled (het tabelgedeelte waarin de rij staat)

In handmatige modus geeft de veldformatter de ingeschakelde providers door aan de browser. De browser sorteert ze op gewicht, laagste eerst, en stuurt ze als een komma-gescheiden providers-string met elk chatverzoek mee, bijvoorbeeld openai,mistral,anthropic. De DXPR-service gebruikt de eerste provider en valt terug op de volgende ingeschakelde wanneer die niet beschikbaar of traag is. Gewichten worden alleen verstuurd wanneer het model kavya-m1 is; de EU- en Fast-modellen hebben vaste routering.

Standaardgewichten: OpenAI 0, MistralAI 1, Anthropic 2, Google Gemini 3, XAI 4. Een rij omhoog slepen in de tabel verlaagt zijn gewicht.

Om de volgorde te wijzigen:

  1. Ga naar /admin/config/ai/providers/dxpr (of /admin/dxpr_studio/dxpr_builder/ai_settings zonder de providermodule)
  2. Zet Default model op DXAI Kavya M1; de provideropties zijn verborgen voor andere modellen
  3. Kies Manual Override (Manual priority op de DXPR Builder-pagina)
  4. Sleep providers tussen de secties Enabled en Disabled en in de volgorde die je wilt
  5. Klik op Save configuration (Save settings op de DXPR Builder-pagina)

AI-credits

AI-functies verbruiken DXPR-credits van je abonnement. Controleer resterende credits bij DXPR Studio > DXPR Builder > AI onder Usage and Credits, of onder AI Usage Tracking op het DXPR AI Provider-formulier. Koop bij op dxpr.com/user/me/subscription/credits.

Wat nu?