Amazon Lex V2を統合する

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

スクリプトを作成

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

インタラクションをバーチャルエージェントへルーティングするには、少なくとも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. [バーチャルエージェント(ボット)名]を入力して、バーチャルエージェントプロバイダーのリストでAmazon AWS Lex V2をクリックします。

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

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

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

8. テキストバーチャルエージェントを設定する場合は、音声のページで[テキストのみ(音声サポートなし)]を選択します。 音声バーチャルエージェントを設定する場合は、このページの「音声連携オプションの設定」セクションを参照してください。

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

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

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

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

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

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

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

Amazon Lex V2設定ページの詳細

構成ページを完了させる際には、次のテーブルの情報を使用してください。 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のように配列として返す。 このバージョンはすべてのプロバイダーで利用可能です。
アクセスキー	このAmazon Lex V2バーチャルエージェントのアクセスキーIDを入力します。 アクセスキーは、AWSマネジメントコンソールで検索または作成できます。 このフィールドは必須です。
シークレットキー	指定したアクセスキーIDに対応するシークレットキーを入力します。 シークレットキーを作成したときにコピーしなかった場合は、新規にシークレットキーを作成する必要があります。 このフィールドは必須です。
リージョン	Amazon Lex V2バーチャルエージェントがホストされているリージョンをドロップダウンから選択します。 このフィールドは必須です。
Lexバージョン	ドロップダウンから、お使いのAmazon Lex V2のバージョンを選択します。 このフィールドは必須です。
ボット名	Amazon Lex V2コンソールの設定で構成されたバーチャルエージェントIDを入力します。 このフィールドは必須です。
ボットのエイリアス	Amazon Lex V2コンソールで定義されているとおりに、このバーチャルエージェントで使用するエイリアスのIDを入力します。 エイリアスを使用すると、使用するAmazon Lex V2バーチャルエージェントのバージョンを指定できます。 このフィールドは必須です。
ロケール	このバーチャルエージェントが使用するように設定されている言語とロケールをドロップダウンから選択します。 一覧のオプションは、language_locale形式 (言語 (ロケール)) です。 このフィールドは必須です。
LexアカウントのText-to-Speechを使用	Amazon Lex V2テキスト読み上げ ユーザーが録音プロンプトをテキストとして入力し、コンピューターで生成された音声を使用してその内容を読み上げる機能。(TTS)サービスを使用したい場合、クリックして有効にします。 このオプションを使用すると、TTSがAmazon Lex V2アカウントに請求されます。 Amazon Lex V2TTSサービスを利用したくない場合は、CXoneサービスを使用することができます。 これがテキストバーチャルエージェントの場合、このオプションは無効のままにしてください。
ようこそインテント	会話の開始時に、このバーチャルエージェントが最初の挨拶に使用するインテントの名前。 Amazon Lex V2 のコンテキストでは、インテントは連絡先の要求に適合するアクションです。 この定義は、オンラインヘルプの他の場所で使われている コンタクトが発言または入力した内容の背後にある意味や目的。コンタクトが伝えたいことや達成したいこと。インテントCXoneの意味とは異なります。 これらのインテントはAmazon Lex V2コンソールで定義します。 このフィールドでは大文字と小文字が区別されます。
タイムアウトインテント	会話中に連絡先がタイムアウトしたときにこのバーチャルエージェントが使用するインテント名。 Amazon Lex V2 のコンテキストでは、インテントは連絡先の要求に適合するアクションです。 この定義は、オンラインヘルプの他の場所で使われている コンタクトが発言または入力した内容の背後にある意味や目的。コンタクトが伝えたいことや達成したいこと。インテントCXoneの意味とは異なります。 これらのインテントはAmazon Lex V2コンソールで定義します。 このフィールドでは大文字と小文字が区別されます。
DTMFブレイクアウトパターン	呼び出し中に、バーチャルエージェントが StudioスクリプトのDTMFBreakout 分岐にスキップする原因となる文字を入力します。 このフィールドは、それが音声バーチャルエージェントの場合にのみ完了します。
外部プロバイダーのタイムアウト	スクリプトがAmazon Lex V2 からの応答を待機する秒数を入力します。 タイムアウトに達すると、コントロールはスクリプトに戻り、エラーブランチを取ります。

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

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

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

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

3. 「音声」ページの[音声連携オプション]の下で、ナビゲーション管理（CXone音声ボットゲートウェイ）を選択します。
4. Cloud TTS Hubを使用している場合は、TTSベンダー。

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

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

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

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

Amazon Lex V2アプリをアクションに割り当てる

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

バーチャルエージェント コンタクトが発言または入力した内容の背後にある意味や目的。コンタクトが伝えたいことや達成したいこと。アプリを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. テストが終了したら、[閉じる]をクリックします。