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가 쓰는 공급자

DXPR Builder는 모든 AI 요청을 이름으로 DXPR 공급자에 보냅니다. 따라서 텍스트 명령, 페이지 만들기, 이미지 생성, 이미지 편집은 항상 DXPR 공급자를 씁니다. /admin/config/ai/settings의 기본값은 이를 바꾸지 않습니다. 이 기능들의 경로는 AI API 참조에 있습니다.

OpenAI, Anthropic, Mistral 같은 AI 모듈의 다른 공급자는 DXPR Builder 기능을 제공할 수 없습니다. 같은 사이트의 다른 AI 기능(예: AI Image Alt Text, AI Translate)의 기본값으로는 쓸 수 있습니다.

모델

다음에 없는 모델은 거부됩니다: 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의 스키마).

수동 모드에서는 필드 포매터가 활성화된 공급자를 브라우저에 전달합니다. 브라우저는 가중치 순(낮은 순)으로 정렬해 각 채팅 요청에 쉼표로 구분된 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에서.

다음 단계

• AI 구성
• AI API 참조
• AI 문제 해결