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)に割り当てます。

Virtual Agent Hubにアプリを追加する

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

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

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

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

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

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

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

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

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

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

    このステップのフィールドについての詳細

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

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

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

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

Microsoft Azure設定ページの詳細

構成ページを完了させる際には、次のテーブルの情報を使用してください。 Virtual Agent Hubにアプリを追加すると、このページが表示されます。

フィールド	詳細
連携バージョン	使用したいVirtual Agent Hubのバージョンを選択します。 このオプションでは、新しくリリースされるバージョンに切り替える準備ができるまで、Virtual Agent Hubの以前のバージョンを使用できます。 利用可能なバージョンは以下の通りです。 バージョン1.0.0：これはVirtual Agent Hubの最初のバージョンです。 カスタムペイロードオブジェクトはcustomPayload.payload.xxxxとして返されます。 バージョン2.0.0：このプロバイダーでは、このバージョンは利用できません。 バージョン3.0.0：このバージョンでは、StandardBotが導入され、CXoneがバーチャルエージェントプロバイダーと通信する方法が標準化されました。 customPayloadオブジェクトは、customPayloadscriptPayloads[n].xxxxのように配列として返す。 このバージョンはすべてのプロバイダーで利用可能です。
Direct Lineシークレット	Direct Lineの認証シークレットを入力します。 Direct Lineシークレットを使用すると、CXoneは、お客様のMicrosoft Azureバーチャルエージェントで行われた任意の会話にアクセスできます。 そのキーはMicrosoft Azureポータルにあります。
Azureテキスト読み上げ統合に自分のアカウントを使用する（CXoneTTSクラウドの代わりに）	Microsoft Azureテキスト読み上げサービスを使用し、ご自身のアカウントをセットアップされている場合は、スライダーをクリックしてオンにしてください。 CXoneCloud TTS Hubを使用したい場合、またはAzureTTSアカウントをセットアップしていない場合は、このフィールドをオフに設定してください。 設定ウィザードの次のページでCloud TTS Hubを設定できます。
音声サービスキー	音声サービスキーを入力します。 このキーはAzureポータルで確認できます。 このフィールドは、Azureテキスト読み上げサービスの使用を有効にした場合のみ入力してください。
音声サービスのリージョン	音声サービスキーが作成された地域の地域識別子を入力します。 このフィールドは、Azureテキスト読み上げサービスの使用を有効にした場合のみ入力してください。
TTS音声名	このバーチャルエージェントが使用する ユーザーが録音プロンプトをテキストとして入力し、コンピューターで生成された音声を使用してその内容を読み上げる機能。テキスト読み上げAzureの音声をドロップダウンから選択します。 このフィールドは、Azureテキスト読み上げサービスの使用を有効にした場合のみ入力してください。
タイムアウトメッセージ	コンタクト時間切れになったとき、Azureバーチャルエージェントに使用させるメッセージを入力します。 デフォルトのメッセージは「まだいらっしゃいますか？」です。
DTMFブレークアウトパターン	呼び出し中に押されると、バーチャルエージェントがStudioスクリプトのDTMFBreakout ブランチを取得する原因となる文字を入力します。 このフィールドは、それが音声バーチャルエージェントの場合にのみ完了します。
ようこそインテント	このバーチャルエージェントに使用させたいAzureようこそインテント コンタクトが発言または入力した内容の背後にある意味や目的。コンタクトが伝えたいことや達成したいこと。のIDを入力します。
タイムアウトインテント	このバーチャルエージェントに使用させたいAzureタイムアウトインテントのIDを入力します。
LUIS予測インテントが必要な場合は、独自のLUISアプリアカウントを使用	LUISアプリアカウントをお持ちで、AzureボットでLUISの意図 コンタクトが発言または入力した内容の背後にある意味や目的。コンタクトが伝えたいことや達成したいこと。予測を使用する場合は、スライダーをクリックしてオンにします。 このAzureバーチャルエージェントでLUISインテント予測を使用しない場合は、このフィールドをオフに設定したままにします。 LUISはMicrosoft Azure言語のCognitive Serviceの一部であり、会話型バーチャルエージェントに自然言語機能を提供します。 詳細については、Microsoft AzureCognitive Service for Languageのオンラインヘルプを参照してください。
LUISアプリID	LUISアプリのIDを入力します。 このフィールドは、[LUIS Prediction Intentが必要な場合]フィールドを[オン]に設定した場合にのみ表示されます。
LUIS予測キー	このMicrosoft Azureバーチャルエージェントで使用しているLUISアプリのキーを入力します。 このフィールドは、[LUIS予測インテントが必要な場合]　フィールドを[オン]に設定した場合にのみ表示されます。
LUIS予測エンドポイント	この Microsoft Azure ボットで使用しているLUISアプリのエンドポイントを入力します。 このフィールドは、[LUIS Prediction Intentが必要な場合]フィールドを[オン]に設定した場合にのみ表示されます。

AzureTTSを設定する

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

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

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

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

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

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

1. Virtual Agent Hubで、新しい構成アプリを追加し、このページのアプリを追加Virtual Agent Hubのセクションのステップに従って構成します。

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

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

   このステップのフィールドについての詳細

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

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

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

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

   このステップのフィールドについての詳細

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

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

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

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

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

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

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

3. アクションをダブルクリックするとVirtual Agent Hubが開きます。

   画像を表示

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   このステップのフィールドについての詳細

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

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

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

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