AIのトラブルシューティング.

Learn DXPR BuilderManage the siteEen probleem oplossen

AIボタンがない、グレーアウトしている、エラーを返す場合の原因を特定します。問題の多くは3か所のいずれかにあります。DXPRキー、DXPR BuilderのAIページのスイッチ、DXPRクレジットです。

あるべき場所に表示されたテキストツールバーのAI Agentボタンとそのコマンドドロップダウン

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"と表示される場合、DXPR Builderは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設定をご覧ください。

修正の確認

ビルダーでページを再読み込みします。ツールバーのAI Agentボタンはグレーアウトしなくなります。テキストツールバーはAI AgentとTone of voiceから始まります。1文に対するPolishのような短いコマンドは新しいテキストを返します。

次のステップ

DXPR BuilderでAIをオンにするですべての設定を最初から確認します。