AI 模型和服务商.

Learn DXPR BuilderBuild pagesSchrijven en ontwerpen met AI

DXPR Builder 的 AI 功能通过 Drupal AI 模块和 DXPR 提供方模块（ai_provider_dxpr）运行。本页介绍提供方是什么、DXPR 提供方如何融入、有哪些模型，以及设置页面上的“service providers”和权重是什么意思。

该视频在编辑器中选择 EU 模型，并在 AI Agent 面板中展示。

Drupal AI 模块中的提供方

在 AI 模块中，提供方是连接一个 AI 服务的插件。每个提供方声明其支持的操作类型，例如聊天、文本生成图片、图片改图片和翻译文本。它还列出自己的模型，并保存自己的 API 密钥设置。

已安装的提供方列在 Configuration > AI > AI Infrastructure > AI Platform Providers (/admin/config/ai/providers)。这需要 administer ai providers 权限。每种操作类型的默认提供方和模型在 Configuration > AI > AI Infrastructure > Default Models for AI Operations (/admin/config/ai/settings) 设置。它们存放在 ai.settings 中，为 default_providers。

DXPR 提供方

ai_provider_dxpr 注册 ID 为 dxpr、标签为“DXPR”的提供方。它支持 chat、text_to_image、image_to_image 和 translate_text，流式输出聊天内容，用从 Key 模块选择的 API 密钥与 kavya.dxpr.com/v1 通信。其设置表单在 /admin/config/ai/providers/dxpr（DXPR AI Provider）：

  • DXPR API Key：保存您 DXPR API 密钥的 Key 实体（在 /admin/config/system/keys 创建；安装时模块会选择标签含“DXPR”的键）
  • AI Usage Tracking：积分余额和用量
  • Default model 和 Allowed models：见下文模型
  • AI Service Providers：Automatic 或 Manual Override，带上游服务拖拽表
  • Em-dash processor：后处理级别，带按语言覆盖

保存表单还会将 dxpr 注册为每个尚无默认值的操作类型的默认提供方。聊天变体和翻译文本使用 kavya-m1。文本生成图片和图片改图片使用 kavya-image。保存还会发送一次简短测试请求，检查密钥和账户的速率限制。

DXPR Builder 自己的 AI 页面随后显示您的积分和指向此表单的链接：Configure AI service providers。

DXPR Builder 的 AI Settings 选项卡，显示用量积分和功能开关

DXPR Builder 使用哪个提供方

DXPR Builder 按名称向 DXPR 提供方发送每个 AI 请求。因此文本命令、页面创建、图像生成和图像编辑始终使用 DXPR 提供方。/admin/config/ai/settings 的默认值不改变这一点。这些功能背后的路由见 AI API 参考。

AI 模块中的其他提供方（如 OpenAI、Anthropic 或 Mistral）不能为 DXPR Builder 功能服务。它们仍可以是同一网站上其他 AI 功能的默认值，例如 AI Image Alt Text 或 AI Translate。

模型

构建器键 API 模型 用途
dxai_kavya_m1 kavya-m1 文本命令和页面创建（默认）
dxai_kavya_m1_eu kavya-m1-eu 文本，路由到 MistralAI（法国）
dxai_kavya_m1_fast kavya-m1-fast 文本，延迟更低
（无） kavya-image 图像生成和编辑，始终使用

不在 Allowed models 中的模型会被拒绝。DXPR Builder 的聊天路由回答 403：“The selected model is not allowed. Please refresh the page to update your model options.”。对于其他 AI 模块功能，提供方回答“The selected model is not allowed by the administrator.”。

默认文本模型的设置位置：

  1. 安装了 ai_provider_dxpr 时：Default model 位于 /admin/config/ai/providers/dxpr （ai_provider_dxpr.settings，键为 ai_model）。DXPR Builder AI 设置页面随后只显示 Configure AI service providers 链接
  2. 没有安装时：Default model 和 Allow users to choose model，位于 DXPR Studio > DXPR Builder > AI (/admin/dxpr_studio/dxpr_builder/ai_settings，dxpr_builder.settings)

在编辑器中选择模型

编辑人员可以为自己的 AI 请求选择模型：

  1. 在 DXPR Builder 工具栏上点击 More，选择 AI settings。
  2. 在 Model 下选择模型，例如 DXAI Kavya M1 EU。
  3. 点击 Save。
  4. 点击工具栏上的 AI Agent。面板标题显示您选择的模型。

该选择存放在浏览器中（ck5-ai-agent:model）。Allowed models 只留一个模型时，不显示选择器。

服务提供方与权重

Kavya M1 由上游 AI 服务提供。设置表单称它们为“service providers”：OpenAI、MistralAI、Anthropic、Google Gemini 和 XAI。它们与 Drupal AI 模块的提供方无关，只控制 DXPR 服务内部的路由。两个配置键控制这一点：安装该模块时存放在 ai_provider_dxpr.settings 中，否则存放在 dxpr_builder.settings 中（结构见 config/schema/dxpr_builder.schema.yml）：

键 值 效果
ai_provider_selection_mode automatic（默认）或 manual Automatic：不发送提供方列表，DXPR 按实时性能路由。Manual：随请求发送已启用的提供方
ai_providers 每个提供方：enabled、weight、region weight 是整数；越小优先级越高。region 为 enabled 或 disabled（该行所在的表分区）

在手动模式下，字段格式化器将启用的提供方传给浏览器。浏览器按权重排序（最小在前），随每次聊天请求以逗号分隔的 providers 字符串发送，例如 openai,mistral,anthropic。DXPR 服务使用第一个提供方，在其不可用或缓慢时回退到下一个启用的提供方。权重只在模型为 kavya-m1 时发送；EU 和 Fast 模型路由固定。

默认权重：OpenAI 0、MistralAI 1、Anthropic 2、Google Gemini 3、XAI 4。在表格中将行上拖可降低其权重。

更改顺序：

  1. 前往 /admin/config/ai/providers/dxpr（没有提供方模块时为 /admin/dxpr_studio/dxpr_builder/ai_settings）
  2. 将 Default model 设为 DXAI Kavya M1；其他模型下提供方选项隐藏
  3. 选择 Manual Override（DXPR Builder 页面上为 Manual priority）
  4. 在 Enabled 和 Disabled 分区之间拖拽提供方，排成您要的顺序
  5. 点击 Save configuration（DXPR Builder 页面上为 Save settings）

AI 积分

AI 功能消耗您订阅中的 DXPR 积分。请在 DXPR Studio > DXPR Builder > AI 的 Usage and Credits 下，或 DXPR AI Provider 表单的 AI Usage Tracking 下查看剩余积分。在 dxpr.com/user/me/subscription/credits 充值。

接下来做什么？