組み込みエージェントでの音声機能の有効化

組み込みエージェントで音声入力と音声出力を有効にすることで、ユーザーは音声コマンドや音声応答を使ってエージェントとやり取りできるようになります。音声機能は、組み込みアプリケーションにおけるアクセシビリティを向上させ、より自然な会話体験を実現します。

「音声モード」 で、エージェントの設定を行い、音声を選択します。選択したボイスは、ボイスを有効にする「 Embedded agent 」チャンネルにトグルとして表示されます。

開始前に

以下の前提条件を必ず満たしてください：

組み込みエージェントの音声機能を有効にするには、以下の手順に従ってください：

エージェントの設定ページに移動してください。
「チャンネル 」>「 組み込みエージェント」を選択します。
音声を有効にする環境（ 下書きまたは公開）を選択してください。「Draft 」環境を使用して、プレビューでの音声の挙動をテストしてください。エージェントをデプロイした後、 Live 環境を使用して、組み込みチャットでユーザーが音声機能を利用できるようにします。デプロイを行うまでは、ドラフトの変更は本番環境には反映されません。
音声機能を有効にするには、音声モデルのトグルスイッチをオンにしてください。

本番環境で音声機能を有効にすると、埋め込みチャットウィジェットで音声機能が利用可能になります。

組み込みチャットにおける音声機能は、セキュリティ有効モードと無効モードの両方で動作します：

セキュリティ機能有効 ：音声ストリームは、既存のJWTトークン方式を通じて認証されます。音声セッションはJWTで確立されたユーザーIDと紐付けられており、これにより、認証されたユーザーのみが音声機能にアクセスできるようになっています。セキュリティの設定の詳細については、「組み込みチャットのセキュリティ設定」を参照してください。
セキュリティが無効化されています ：音声機能は匿名モードで動作し、ユーザーは認証なしで操作を行うことができます。このモードは、匿名アクセスが明示的に必要であり、機密データが公開されない場合にのみ使用してください。詳細については、「セキュリティモード」を参照してください。

音声認証は、テキストベースのチャットとのやり取りと同じセキュリティモデルを採用しており、JWTトークンを使用してリクエストの検証を行い、セッションの整合性を維持します。