Amazon Q Business でテーマのカスタマイズ内容が Web インターフェース上に反映されない問題がおきたので対応した
2025.08.31いわさです。
Amazon Q Business では Web Experience と呼ばれる Web インターフェースが提供され、そこからビジネス向けにカスタマイズした機能にアクセスすることが出来ます。
先日とある機能を試す機会があって触っていたのですが、その際に Web インターフェース画面をカスタマイズできることを知りました。
どんなもんなのかと思ってカスタマイズを試していたのですが、うまくカスタム内容が反映されない事象が発生しました。
本日はこちらを解決出来たのでその方法を紹介します。
おそらく私のようにドキュメントを読まずにまず試してしまう人は同じ問題が発生すると思います。
前提として、本日時点の Amazon Q Business デフォルト状態の Web インターフェースは次のようなデザインになっています。
テーマのカスタマイズ
テーマのカスタマイズはアプリケーションごとの行うことが出来ます。
作成したアプリケーションごとに以下の「Customize web experience」から開始することが出来ます。
そすうると Web インターフェースのプレビュー画面が表示されます。
右側にはカスタム項目が表示されており、Text と Theme の 2 つのタブが表示されています。
テキスト
テキストタブではタイトル・サブタイトル・チャット起動時に表示されるウェルカムメッセージの３つのテキストを任意の値に設定することが出来ます。
タイトルは 25 文字まで、サブタイトルは 50 文字まで、ウェルカムメッセージは 300 文字まで設定が可能です。
「Display sample prompts」にチェックを入れると、サンプルプロンプト選択コントロールがチャット欄に表示されるようになります。
ただし、このサンプルプロンプトの内容のカスタマイズは出来ないみたいだったので
プレビュー上だと日本語も扱うことが出来たのですが、保存しようとすると次のようにタイトルとサブタイトルで入力チェックのエラーが発生しました。日本語使えないみたいですね。
ウェルカムメッセージについては使えました。
テーマ
テーマタブでは色やフォントなどの見た目の部分を変更できます。
Managed theming では UI 上でカスタマイズできる項目を設定していきます。Custom theming では CSS ファイルを埋め込んでそのままデザインのカスタマイズを行います。
前者の場合でも最終的には選択した内容で CSS が出力されます。
背景色、タイトル色、フォント、ロゴを指定した時のプレビューがこんな感じです。
テキストの位置などは変更できません。
また、アドバンスドオプションではチャット内容のコンポーネントとフォントの色を指定することができます。ユーザー入力と Q の返答と色を分けることもできます。
ただし、プレビュー画面ではチャット内容のスタイル確認はできないようだったので、デプロイして実際に確認する必要があります。
デプロイ方法ですが、S3 バケットを指定します。
そうすると CSS ファイルが画面で設定した内容に従って出力される感じですね。保存されるだけで、これを適用するとかの作業は不要です。
ただし、注意点が少しあるので紹介します。
テーマが反映されない
S3 バケットに CSS ファイルを保存した後に Web インターフェースにアクセスしてみたところ、テキストのカスタム内容は反映されていたのですが、テーマで設定した内容が反映されていませんでした。どうして...
よくよくドキュメントを読み直してみると、S3 バケットに関する注意点などが記述されています。
先ほどのカスタマイズ画面で S3 バケットにテーマ内容を保存したと思いますが、Amazon Q からアクセスできるようにしておく必要があるみたいです。
パブリックアクセス可能にするか、あるいはプライベートバケットの場合は Amazon Q Business がアクセスできるようにバケットポリシーの設定が必要になります。
本日時点では上記ドキュメントにプライベートバケットのポリシー設定内容が記述されていなかったので、パブリックアクセス可能なように設定してみました。
そうすると、テーマで設定した内容も反映されることを確認しました。良いですね。
さいごに
本日は Amazon Q Business でテーマのカスタマイズ内容が Web インターフェース上に反映されない問題がおきたの対応方法を紹介しました。
初めてカスタマイズする際はバケットポリシーの設定を忘れがちなので覚えておきましょう。
