Microsoft Azureを統合

このページのタスクを完了する前に、連携のための前提条件が満たされていることを確認してください。

スクリプトを作成

必須の権限：スクリプトの表示、スクリプトの作成/編集

インタラクションをバーチャルエージェントへルーティングするには、少なくとも1つのStudioスクリプトが必要です。スクリプトのガイドラインと要件に従ってください。このプロバイダーでサポートされているバーチャルエージェントアクションはVoiceBot Exchange であり、スクリプトには電話メディアタイプ 連絡先が意図した受信者と接続するための、音声、Eメール、チャットなどの媒体。が必要です。The supported virtual agent action for this provider is Voicebot Conversation and your script must have the phone media type 連絡先が意図した受信者と接続するための、音声、Eメール、チャットなどの媒体。.

Studioスクリプティングについての詳細は、オンラインヘルプの基本および技術参照ガイドのセクションで知ることができます。

バーチャルエージェントを本番稼動させる準備ができたらスクリプトを1つ以上のポイントオブコンタクト(PoC)に割り当てます。

バーチャルエージェントハブにアプリを追加する

必須の権限：スクリプトの表示、スクリプトの作成/編集

設定アプリをバーチャルエージェントハブに追加することで、CXoneとバーチャルエージェントプロバイダーの間の接続を確立します。

1. Studioで、スクリプトを開くか作成し、バーチャルエージェントのアクションを追加します（まだ含まれていない場合）。
2. 仮想エージェントアクションをダブルクリックして、 バーチャルエージェントハブ 。
3. ボットの追加をクリックします。

4. [バーチャルエージェント(ボット)名]を入力して、バーチャルエージェントプロバイダーのリストでMicrosoft Azureをクリックします。

5. 次へをクリックします。

6. 設定フォームのフィールドに入力して、 次へをクリックします。このフォームの詳細は、本ページの設定ページ詳細セクションに記載されています。

7. 次へをクリックします。

8. テキストバーチャルエージェントを設定する場合は、音声のページで[テキストのみ(音声サポートなし)]を選択します。音声バーチャルエージェントを設定する場合は、担当のCXoneアカウント担当者までご連絡ください。

9. [次へ] をクリックします。

10. トランスクリプトのページで、会話のトランスクリプトとインテント情報をキャプチャするかどうかのオプションを選択します。

    このステップのフィールドの詳細

    オプション	詳細
    トランスクリプト情報やインテント情報のキャプチャまたはアーカイブはしないこと	会話のトランスクリプションやインテント 連絡先の発言/入力する内容の背後にある意味または目的。連絡先が伝えたいこと、または達成したいこと。の情報をキャプチャしたくない場合は、このオプションを選択します。
    インテント情報のみをキャプチャおよびアーカイブする	インテント情報のみをキャプチャしたい場合は、このオプションを選択します。キャプチャされたデータは、デフォルトではインタラクションの間にだけ保存されます。 このオプションにはカスタムスクリプティングが必要です。
    トランスクリプト情報とインテント情報をキャプチャおよびアーカイブする	トランスクリプトとインテントのデータの両方をキャプチャしたい場合は、このオプションを選択します。キャプチャされたデータは、デフォルトではインタラクションの間に保存されるだけです。 このオプションにはカスタムスクリプティングが必要です。

11. 次へをクリックします。

12. [テスト+追加]ページで、音声またはテキストプロンプトを送信することで、ボットの接続をテストできます。テストメッセージが機能しない場合は、[戻る]をクリックして[設定]ページに戻り、設定を確認します。また、バーチャルエージェントプロバイダーの管理コンソールで設定を検証る必要がある場合があります。

13. 追加をクリックします。

Microsoft Azure設定ページの詳細

構成ページを完了させる際には、次のテーブルの情報を使用してください。バーチャルエージェントハブにアプリを追加すると、このページが表示されます。

AzureTTSを設定する

このバーチャルエージェントによるAzureテキスト読み上げを使用する場合は、Microsoftをすでにセットアップした自分のアカウントを用意する必要があります。

1. バーチャルエージェントハブで、新しい設定アプリを追加し、このページのアプリをバーチャルエージェントハブに追加のステップに従って設定します。
2. 独自アカウントを使用してAzure Text-to-Speechを起動をクリックしてオンにし、有効にします。
3. 音声サービスキーを入力します。このキーはAzureポータルで確認できます。
4. お客様の音声サービスキーが作成された対象のリージョン用のリージョン識別子を、音声サービスリージョンフィールドに入力します。
5. TTS音声名のドロップダウンから、このバーチャルエージェントに使用させる音声と言語を選択します。
6. このページのアプリをバーチャルエージェントハブに追加に戻り、設定アプリの追加を終了します。

音声連携オプションを設定する

必須の権限：スクリプトの表示、スクリプトの作成/編集

Azureバーチャルエージェントについては、Azureテキスト読み上げサービスまたはCXoneCloud TTSのいずれかを使用できます。

1. バーチャルエージェントハブで、新しい構成アプリを追加し、このページのアプリを追加バーチャルエージェントハブのセクションのステップに従って構成します。

2. 構成ページで次をクリックします。

3. 「音声」ページの[音声連携オプション]の下で、バーチャルエージェントと使用する音声接続の種類のオプションを選択します。

   このステップのフィールドの詳細

   フィールド	詳細
   音声連携オプション	このバーチャルエージェントと使用している音声統合の種類を選択します： ナビゲーション管理（CXone音声ボットゲートウェイ)：スクリプトがバーチャルエージェントとの会話の各ターンを制御する場合、このオプションを選択します。スクリプトは、Voicebot Exchangeアクションを使用する必要があります。 SIP連携（バックチャネル）：バーチャルエージェントとのSIPバックチャネル接続を使用している場合、このオプションを選択します。セットアップのアシストについては、CXoneアカウント担当者までお問い合わせください。 カスタムテレフォニー（gRPC、DirectLine Voiceなど）：バーチャルエージェントへの接続に別のテレフォニーオプションを使用している場合、このオプションを選択します。セットアップのアシストについては、CXoneアカウント担当者までお問い合わせください。

4. フォームでCXoneクラウドTTSを使用を選択できない場合は、戻るをクリックして構成ページに戻ります。Azureテキスト読み上げ呼び出し用の独自アカウントを使用スライダーをクリックしてオフにします。これで音声ページでCloud TTSを有効にできます。

5. Cloud TTSを使用している場合は、TTSベンダーを選択します。バーチャルエージェントプロバイダーのTTSサービスを使用している場合、このフィールドは表示されないで、このステップをスキップすることができます。

6. トランスクリプションオプションの下で、使用するクリプショントランスクリプションサービス用のオプションを選択します。

   このステップのフィールドの詳細

   フィールド	詳細
   トランスクリプションオプション	トランスクリプションに使用するサービスを選択します。 ボットアカウントのトランスクリプションを使用する：がバーチャルエージェントプロバイダーのトランスクリプションサービスを利用する場合にこれを選択します。コンタクトの発話の音声は、転写される前にプロバイダーに送られます。 CXoneトランスクリプションプロファイル：CXoneトランスクリプションプロファイルを使用する場合にこれを選択します。このオプションの詳細は、CXoneターンバイターンのトランスクリプションのヘルプページを参照してください。

7. CXoneトランスクリプションプロファイルを使用する場合は、トランスクリプションプロファイルをクリックして、使用するプロファイルを選択します。新規ターンバイターントランスクリプションプロファイルをクリックし、新しいプロファイルを作成します。
8. 次へをクリックします。
9. このページのアプリを追加バーチャルエージェントハブのセクションに戻り、構成アプリの追加を終了します。

Microsoft Azureアプリをアクションに割り当てる

必須の権限：スクリプトの表示、スクリプトの作成/編集

バーチャルエージェント 連絡先の発言/入力する内容の背後にある意味または目的。連絡先が伝えたいこと、または達成したいこと。アプリをバーチャルエージェントハブでセットアップして設定すると、それをスクリプトのバーチャルエージェントのアクションに割り当てる必要があります。これにより、アクションとスクリプトがバーチャルエージェントプロバイダーに接続されます。

1. Studioで、変更するスクリプトを開きます。

2. まだ行っていない場合は、[ツール]タブをクリックし、[自動化とAI]カテゴリを展開して、使用したいバーチャルエージェントアクションを追加します。必ずスクリプト内の正しい場所に配置してください。期待するアクションが起きない場合は、スクリプトメディアタイプが正しいことを確認してください。たとえば、音声バーチャルエージェント用のスクリプトを作成している場合は、スクリプトは電話スクリプトにする必要があります。

3. アクションをダブルクリックするとバーチャルエージェントハブが開きます。

   画像の表示

   
4. 左の列で、アクションに割り当てるバーチャルエージェントを見つけて、その横にあるチェックマークをクリックします。
5. 閉じるをクリックします。

トランスクリプションプロファイルを変更する

必須の権限：スクリプトの表示、スクリプトの作成/編集

トランスクリプションプロファイルを使用すると、バーチャルエージェントプロバイダーが提供するものとは異なるトランスクリプションサービスを使うことができます。バーチャルエージェントごとに1つのトランスクリプションプロファイルを割り当てることができます。音声バーチャルエージェントで作業していて、トランスクリプションプロファイルを変更する必要がある場合のみ、このセクションの手順に従ってください。

1. Studioで、スクリプトを開くか作成し、バーチャルエージェントのアクションを追加します（まだ含まれていない場合）。
2. 仮想エージェントアクションをダブルクリックして、 バーチャルエージェントハブ 。
3. バーチャルエージェントハブページの左側にあるバーチャルエージェント設定アプリのリストで、変更するアプリをクリックします。
4. バーチャルエージェントアプリのプロパティのページの中央で、音声タブをクリックします。

5. [トランスクリプションオプション]の下で、まだ選択されていなければ、CXoneトランスクリプションプロファイルの使用を選択します。

6. このバーチャルエージェントに使用させるターバンバイターントランスクリプションプロファイルを選択します。使用したいオプションがない場合は、追加できます。

7. 保存をクリックします。
8. バーチャルエージェントアプリのプロパティのページのテストのセクションでマイクオプションを使用することで、トランスクリプションサービスをテストします。

バーチャルエージェントボットをテストする

必須の権限：スクリプトの表示、スクリプトの作成/編集

バーチャルエージェントの多くの側面をテストして、すべてが意図したとおりに機能することを確認できます。バーチャルエージェントハブのバーチャルエージェントアプリのプロパティページからテストを実行できます。テストでは次のことを行えます：

• バーチャルエージェントアプリがバーチャルエージェントプロバイダーと通信するように正しく構成されていることを確認します。
• カスタムペイロードJSONを追加して、バーチャルエージェントによるカスタムペイロードデータの処理をテストします。
• ウェルカムインテントイベントをトリガーして、バーチャルエージェントが会話を開始する方法をテストします。
• カスタムインテントイベントをトリガーして、バーチャルエージェント用に作成したカスタムイベントをテストします。
• タイムアウトイベントをトリガーして、コンタクトがタイムアウトしたときにバーチャルエージェントがどのように応答するかをテストします。
• バーチャルエージェントがDTMF ユーザーが電話のキーパッドのキーを押すかタップしたときに生成される信号音。入力を処理する方法をテストします。

次の画像はバーチャルエージェントハブのバーチャルエージェントアプリのプロパティページの例です。構成と音声タブおよびテストペインが表示されます。

1. Studioで、スクリプトを開くか作成し、バーチャルエージェントのアクションを追加します（まだ含まれていない場合）。
2. 仮想エージェントアクションをダブルクリックして、 バーチャルエージェントハブ 。
3. 左側のリストから、テストしたいバーチャルエージェント用の構成アプリをクリックして選択します。

4. [テスト]ペインで、[メッセージを入力]フィールドにテストメッセージを入力し、エンターキーを押して送信します。マイクをクリックして、コンピューターのマイクに向かって話すこともできます。

5. ウェルカムインテントで開始をクリックして、最初からテスト会話を開始します。バーチャルエージェントはデフォルトのウェルカムメッセージで応答します。テストメッセージを入力することができます。

6. その他のオプション をクリックして、バーチャルエージェントの他の側面をテストします。

   このステップのフィールドの詳細

   フィールド	詳細
   カスタムペイロードJSONを追加	ここを選択してバーチャルエージェントへのカスタムペイロードJSONの送信をテストします。 [テスト+追加]ページに表示される[カスタムペイロードJSON]テキストボックスにカスタムペイロードを入力します。各行の後にエンターキーを押します。 カスタムペイロードをテストする準備ができたら、テストメッセージを送信します。カスタムペイロードのテストが終了したら、[カスタムペイロードJSONを追加]ペインで[閉じる]をクリックします。
   ウェルカムインテントイベントをトリガー	デフォルトのウェルカムインテント 連絡先の発言/入力する内容の背後にある意味または目的。連絡先が伝えたいこと、または達成したいこと。をテストする場合に選択します。バーチャルエージェントはウェルカムメッセージを送信します。応答するメッセージを入力します。
   カスタムインテントイベントをトリガーする	カスタムインテントイベントをテストする場合に選択します。表示されるポップアップにイベント名を入力し、[トリガー]をクリックします。バーチャルエージェントは入力したインテントに対してメッセージを送信します。レスポンスを送信してインテントをテストします。
   タイムアウトイベントをトリガー	デフォルトのタイムアウトインテントを表示する場合に選択します。バーチャルエージェントはそれで設定されたタイムアウトレスポンスメッセージを送信します。
   DTMF入力	ここを選択してDTMF ユーザーが電話のキーパッドのキーを押すかタップしたときに生成される信号音。発信音に対する音声バーチャルエージェントのレスポンスをテストします。DTMF文字を入力し、入力をクリックしてそれらの文字に対するバーチャルエージェントのレスポンスを確認します。

7. [リセット]をクリックして、テストを再開します。

8. テストの結果に基づいて変更を加える必要がある場合は、次のことができます。

   • バーチャルエージェントのStudioスクリプトを変更します。
   • バーチャルエージェントハブのバーチャルエージェントアプリの構成設定を変更します。
   • プロバイダのコンソールでバーチャルエージェントの構成設定を変更します。バーチャルエージェントハブのアプリのプロパティのページにある大きな四角いボタンをクリックします。このセクションの冒頭の例では、プロバイダーボタン付きのGoogle Dialogflow CXアプリとを表示しています。リンクが外部サイトを開くことを示すアイコンが表示されます。
9. スクリプトまたは構成設定を変更するたびにバーチャルエージェントを徹底的にテストします。
10. テストが終了したら、[閉じる]をクリックします。