--- url: 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/ai/troubleshooting' title: 'AI 문제 해결 | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T01:40:10+00:00' updated: '2026-10-24T06:23:51+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: |- AI 버튼이 없거나, 회색으로 표시되거나, 오류를 반환할 때 원인을 찾으세요. 대부분의 문제는 세 곳 중 한 곳에서 옵니다. DXPR 키, DXPR Builder AI 페이지의 스위치, DXPR 크레딧이 해당됩니다. tags: - 'Een probleem oplossen' image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' published: true og: site_name: DXPR updated_time: '2026-10-24T06:23:51+0000' 'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.' schema: '@context': 'https://schema.org' '@graph': - mainEntity: { } - '@type': TechArticle headline: 'AI 문제 해결' description: |- AI 버튼이 없거나, 회색으로 표시되거나, 오류를 반환할 때 원인을 찾으세요. 대부분의 문제는 세 곳 중 한 곳에서 옵니다. DXPR 키, DXPR Builder AI 페이지의 스위치, DXPR 크레딧이 해당됩니다. image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T01:40:10+0000' dateModified: '2026-10-24T06:23:51+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/ko/hc/documentation/learn-dxpr-builder/ai/troubleshooting' articleSection: 'Een probleem oplossen' - '@type': WebPage '@id': 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/ai/troubleshooting' description: |- AI 버튼이 없거나, 회색으로 표시되거나, 오류를 반환할 때 원인을 찾으세요. 대부분의 문제는 세 곳 중 한 곳에서 옵니다. DXPR 키, DXPR Builder AI 페이지의 스위치, DXPR 크레딧이 해당됩니다. breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: 홈 item: 'https://dxpr.com/ko' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: ko --- [Help Center](/ko/node/75)/[Documentation](/ko/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Manage the site](/hc/documentation/learn-dxpr-builder/manage) /[Een probleem oplossen](/hc/documentation/learn-dxpr-builder/troubleshooting) # AI 문제 해결. Learn DXPR BuilderManage the siteEen probleem oplossen ## In this guide Related guides - [DXPR Builder에서 AI 켜기](/ko/hc/documentation/learn-dxpr-builder/ai/setup) AI 버튼이 없거나, 회색으로 표시되거나, 오류를 반환할 때 원인을 찾으세요. 대부분의 문제는 세 곳 중 한 곳에서 옵니다. DXPR 키, DXPR Builder **AI** 페이지의 스위치, DXPR 크레딧이 해당됩니다. ## AI 버튼이 회색으로 표시되는 경우 - **AI 버튼을 가리키면 “AI features are unavailable: no AI provider is configured.” 메시지가 표시됩니다.** DXPR이 AI 공급자로 설정되지 않았거나 키가 비어 있습니다. **Configuration** > **AI** > **AI Infrastructure** > **AI Platform Providers** > **DXPR AI Provider** (`/admin/config/ai/providers/dxpr`)로 이동하여 **DXPR API Key** 아래에서 키를 고르고 **Save configuration**(을)를 클릭하세요. - **메시지에 “AI features require the AI module.”라고 표시됩니다.** AI 모듈이 설치되지 않았습니다. `composer require drupal/ai_provider_dxpr`(을)를 실행한 뒤 `drush en ai_provider_dxpr`(을)를 실행하세요. ## AI 버튼이 없는 경우 다음의 각 스위치는 자체 도구를 숨깁니다: **DXPR Studio** > **DXPR Builder** > **AI** (`/admin/dxpr_studio/dxpr_builder/ai_settings`). - **텍스트 툴바에 AI Agent나 Tone of voice가 없습니다.** **Enable text editing assistant** 항목이 꺼져 있습니다. 자체 텍스트 에디터 버튼이 있는 사용자 프로필도 제외할 수 있습니다. 프로필에 **AI Assistant**와 **AI Tone of Voice**(을)를 추가하세요. - **빌더 툴바에 AI Agent가 없고, 빈 페이지에 프롬프트가 없고, More 메뉴에 Edit with AI가 없습니다.** **Enable page creation assistant** 항목이 꺼져 있습니다. - **Image 요소에 Edit with AI가 없고, Background image 아래에 AI Image Generation이 없습니다.** **Enable image generation** 항목이 꺼져 있습니다. 스위치를 바꾼 뒤 **Save settings**(을)를 클릭하고 편집 중인 페이지를 새로고침하세요. ## 요청 실패 - **텍스트 툴바에 “AI service is currently unavailable. Please try again later.” 메시지가 표시됩니다.** DXPR이 요청에 답하지 않았습니다. 1분 뒤에 다시 시도하세요. 계속 실패하면 공급자 페이지의 키와 크레딧을 확인하세요. - **페이지나 요소 요청에 “The AI service ran into a problem processing this request.” 메시지가 표시됩니다.** 페이지와 요소 도구에서 같은 원인입니다. 다시 시도한 뒤 키와 크레딧을 확인하세요. - **이미지에 “Image generation failed. Please try again.” 또는 “Image editing failed. Please try again.” 메시지가 표시됩니다.** DXPR이 이미지를 만들지 못했습니다. 크레딧이나 콘텐츠 규칙에 어긋나는 설명이 원인인 경우가 많습니다. **Retry**(을)를 클릭하거나 **Cancel**(을)를 클릭하고 설명을 바꾸세요. - **“Your AI credit balance is low” 경고가 표시됩니다.** 5,000 크레딧 미만 남았습니다. 바닥나기 전에 dxpr.com/user/me/subscription/credits에서 충전하세요. ## 크레딧 **Usage and Credits**(DXPR Builder **AI** 페이지에 있음)는 **Credits remaining**과 이번 달에 사용한 크레딧을 보여줍니다. “Unable to load usage data”라고 표시되면 **General Settings** 아래의 제품 키로 dxpr.com에 연결하지 못한 것입니다. 해당 키와 서버의 인터넷 연결을 확인하세요. 계정이 비어 있는 상태로 공급자 폼을 저장하면 “You are using the Free Tier of DXPR or have run out of quota.” 메시지가 표시됩니다. ## 결과가 느리거나 약한 경우 - **답이 오래 걸립니다.** 긴 텍스트와 전체 페이지는 더 오래 걸립니다. **DXAI Kavya M1 Fast**(은)는 낮은 품질로 빠르게 답합니다. 공급자 페이지의 **Default model** 아래나 에디터의 **AI Settings** 대화상자에 있는 **Model**(을)에서 선택하세요. - **텍스트가 일반적입니다.** 누가 페이지를 읽고 용도가 무엇이며 어떤 사실이 중요한지 말하세요. 명령을 실행하기 전에 **Tone of voice** 아래에서 어조를 고르세요. - **결과의 링크나 이미지가 없습니다.** **AI Output Filtering**(이)가 **Allowed domains**에 없는 도메인의 링크를 제거했습니다. 자세한 내용은 [AI configuration](/ko/hc/documentation/learn-dxpr-builder/ai/configuration#ai-output-filtering) 문서를 참고하세요. ## 해결 확인 빌더에서 페이지를 새로고침하세요. 툴바의 **AI Agent** 버튼이 더 이상 회색으로 표시되지 않습니다. 텍스트 툴바가 **AI Agent**와 **Tone of voice**(으)로 시작합니다. **Polish** 같은 짧은 명령을 한 문장에 실행하면 새 텍스트가 돌아옵니다. ## 다음 단계 [Turn on AI in DXPR Builder](/ko/hc/documentation/learn-dxpr-builder/ai/setup) 문서에서 모든 설정을 처음부터 확인하세요.