このページのタスクを完了する前に、連携のための前提条件が満たされていることを確認してください。
スクリプトを作成
必須の権限：
インタラクションをバーチャルエージェントへルーティングするには、少なくとも1つのStudioスクリプトが必要です。 スクリプトのガイドラインと要件に従ってください。 
コンタクトが意図する受信者とつながるための、音声、Eメール、チャットなどの手段。、テキストバーチャルエージェントの場合はデジタルメディアタイプが必要です。 このプロバイダーでサポートされているバーチャルエージェントアクションは：
Studioスクリプティングについての詳細は、オンラインヘルプの基本および技術参照ガイドのセクションで知ることができます。
バーチャルエージェントを本番稼動させる準備ができたらスクリプトを1つ以上のポイントオブコンタクト(PoC)に割り当てます。
Virtual Agent Hubにアプリを追加する
必須の権限：
設定アプリをVirtual Agent Hubに追加することで、CXoneとバーチャルエージェントプロバイダーの間の接続を確立します。
- CXoneで、アプリセレクター
をクリックし、選択します：その他>自動化とAI、次いでVirtual Agent Hubの順にクリックします。 また、Studioスクリプトで使用しているバーチャルエージェントアクションをダブルクリックして、Virtual Agent Hubを起動することもできます。 - ボットの追加をクリックします。
-
[バーチャルエージェント(ボット)名]を入力して、バーチャルエージェントプロバイダーのリストで
-
[次へ]をクリックします。
-
設定フォームのフィールドに入力して、 次へをクリックします。 このフォームの詳細は、本ページの設定ページ詳細セクションに記載されています。
-
[次へ]をクリックします。
-
テキストバーチャルエージェントを設定する場合は、音声のページで[テキストのみ(音声サポートなし)]を選択します。 音声バーチャルエージェントを設定する場合は、このページの「音声連携オプションの設定」セクションを参照してください。
-
[次へ] をクリックします。
-
トランスクリプトのページで、会話のトランスクリプトとインテント情報をキャプチャするかどうかのオプションを選択します。
このステップのフィールドについての詳細
オプション 詳細 トランスクリプト情報やインテント情報のキャプチャまたはアーカイブはしないこと 会話のトランスクリプションやインテント コンタクトが発言または入力した内容の背後にある意味や目的。コンタクトが伝えたいことや達成したいこと。の情報をキャプチャしたくない場合は、このオプションを選択します。インテント情報のみをキャプチャおよびアーカイブする インテント情報のみをキャプチャしたい場合は、このオプションを選択します。 キャプチャされたデータは、デフォルトではインタラクションの間にだけ保存されます。
このオプションにはカスタムスクリプティングが必要です。
トランスクリプト情報とインテント情報をキャプチャおよびアーカイブする トランスクリプトとインテントのデータの両方をキャプチャしたい場合は、このオプションを選択します。 キャプチャされたデータは、デフォルトではインタラクションの間に保存されるだけです。
このオプションにはカスタムスクリプティングが必要です。
-
[次へ]をクリックします。
-
[テスト+追加]ページで、音声またはテキストプロンプトを送信することで、ボットの接続をテストできます。 テストメッセージが機能しない場合は、[戻る]をクリックして[設定]ページに戻り、設定を確認します。 また、バーチャルエージェントプロバイダーの管理コンソールで設定を検証る必要がある場合があります。
-
追加をクリックします。
Amazon Lex V1設定ページの詳細
構成ページを完了させる際には、次のテーブルの情報を使用してください。 Virtual Agent Hubにアプリを追加すると、このページが表示されます。
|
フィールド |
詳細 |
|---|---|
| 連携バージョン |
使用したいVirtual Agent Hubのバージョンを選択します。 このオプションでは、新しくリリースされるバージョンに切り替える準備ができるまで、Virtual Agent Hubの以前のバージョンを使用できます。 利用可能なバージョンは以下の通りです。
|
| アクセスキー | このAmazon Lex V1バーチャルエージェントのアクセスキーIDを入力します。 アクセスキーは、AWSマネジメントコンソールで検索または作成できます。 このフィールドは必須です。 |
| シークレットキー | 指定したアクセスキーIDに対応するシークレットキーを入力します。 シークレットキーを作成したときにコピーしなかった場合は、新規にシークレットキーを作成する必要があります。 このフィールドは必須です。 |
| リージョン | Amazon Lex V1バーチャルエージェントがホストされているリージョンをドロップダウンから選択します。 このフィールドは必須です。 |
| Lexバージョン | ドロップダウンから、お使いのAmazon Lex V1のバージョンを選択します。 このフィールドは必須です。 |
| ボット名 | Amazon Lex V1コンソールの設定で構成したバーチャルエージェント名を入力します。 このフィールドは必須です。 |
| ボットのエイリアス | Amazon Lex V1コンソールで定義されているとおりに、このバーチャルエージェントで使用するエイリアス名を入力します。 エイリアスを使用すると、使用するAmazon Lex V1バーチャルエージェントのバージョンを指定できます。 このフィールドは必須です。 |
| ロケール | このバーチャルエージェントが使用するように設定されている言語とロケールをドロップダウンから選択します。 一覧のオプションは、language_locale形式 (言語 (ロケール)) です。 このフィールドは必須です。 |
| LexアカウントのText-to-Speechを使用 |
これがテキストバーチャルエージェントの場合、このオプションは無効のままにしてください。 |
| ようこそインテント |
会話の開始時に、このバーチャルエージェントが最初の挨拶に使用するインテントの名前。 Amazon Lex V1 のコンテキストでは、インテントは連絡先の要求に適合するアクションです。 この定義は、オンラインヘルプの他の場所で使われている このフィールドでは大文字と小文字が区別されます。 |
| タイムアウトインテント |
会話中に連絡先がタイムアウトしたときにこのバーチャルエージェントが使用するインテント名。 Amazon Lex V1 のコンテキストでは、インテントは連絡先の要求に適合するアクションです。 この定義は、オンラインヘルプの他の場所で使われている このフィールドでは大文字と小文字が区別されます。 |
| DTMFブレイクアウトパターン |
呼び出し中に、バーチャルエージェントが StudioスクリプトのDTMFBreakout 分岐にスキップする原因となる文字を入力します。 このフィールドは、それが音声バーチャルエージェントの場合にのみ完了します。 |
| 外部プロバイダーのタイムアウト |
スクリプトがAmazon Lex V1 からの応答を待機する秒数を入力します。 タイムアウトに達すると、コントロールはスクリプトに戻り、エラーブランチを取ります。 |
音声連携オプションを設定する
必須の権限：
- Virtual Agent Hubで、新しい構成アプリを追加し、このページのアプリを追加Virtual Agent Hubのセクションのステップに従って構成します。
-
構成ページで次をクリックします。
- 「音声」ページの[音声連携オプション]の下で、ナビゲーション管理（CXone音声ボットゲートウェイ）を選択します。
- Cloud TTS Hubを使用している場合は、TTSベンダー。
-
トランスクリプションオプションの下で、使用するクリプショントランスクリプションサービス用のオプションを選択します。
このステップのフィールドについての詳細
フィールド 詳細 トランスクリプションオプション トランスクリプションに使用するサービスを選択します。
- ボットアカウントのトランスクリプションを使用する：がバーチャルエージェントプロバイダーのトランスクリプションサービスを利用する場合にこれを選択します。 コンタクトの発話の音声は、転写される前にプロバイダーに送られます。
- CXoneトランスクリプションプロファイル：CXoneトランスクリプションプロファイルを使用する場合にこれを選択します。 このオプションの詳細は、CXoneTurn-by-Turn Transcriptionのヘルプページを参照してください。
- CXoneトランスクリプションプロファイルを使用する場合は、トランスクリプションプロファイルをクリックして、使用するプロファイルを選択します。 新規ターンバイターントランスクリプションプロファイルをクリックし、新しいプロファイルを作成します。
- [次へ]をクリックします。
- このページのアプリを追加Virtual Agent Hubのセクションに戻り、構成アプリの追加を終了します。
Amazon Lex V1アプリをアクションに割り当てる
必須の権限：
バーチャルエージェント コンタクトが発言または入力した内容の背後にある意味や目的。コンタクトが伝えたいことや達成したいこと。アプリをVirtual Agent Hubでセットアップして設定すると、それをスクリプトのバーチャルエージェントのアクションに割り当てる必要があります。 これにより、アクションとスクリプトがバーチャルエージェントプロバイダーに接続されます。
- Studioで、変更するスクリプトを開きます。
-
まだ行っていない場合は、[ツール]タブをクリックし、[自動化とAI]カテゴリを展開して、使用したいバーチャルエージェントアクションを追加します。 必ずスクリプト内の正しい場所に配置してください。 期待するアクションが起きない場合は、スクリプトメディアタイプが正しいことを確認してください。 たとえば、音声バーチャルエージェント用のスクリプトを作成している場合は、スクリプトは電話スクリプトにする必要があります。
-
- 左の列で、アクションに割り当てるバーチャルエージェントを見つけて、その横にあるチェックマーク
をクリックします。 - 閉じるをクリックします。
トランスクリプションプロファイルを変更する
必須の権限：
トランスクリプションプロファイルを使用すると、バーチャルエージェントプロバイダーが提供するものとは異なるトランスクリプションサービスを使うことができます。 バーチャルエージェントごとに1つのトランスクリプションプロファイルを割り当てることができます。 音声バーチャルエージェントで作業していて、トランスクリプションプロファイルを変更する必要がある場合のみ、このセクションの手順に従ってください。
- CXoneで、アプリセレクターをクリックし、選択します：その他>自動化とAI、次いでVirtual Agent Hubの順にクリックします。 また、Studioスクリプトで使用しているバーチャルエージェントアクションをダブルクリックして、Virtual Agent Hubを起動することもできます。
- Virtual Agent Hubページの左側にあるバーチャルエージェント設定アプリのリストで、変更するアプリをクリックします。
- バーチャルエージェントアプリのプロパティのページの中央で、音声タブをクリックします。
-
[トランスクリプションオプション]の下で、まだ選択されていなければ、CXoneトランスクリプションプロファイルの使用を選択します。
-
このバーチャルエージェントに使用させるターバンバイターントランスクリプションプロファイルを選択します。 使用したいオプションがない場合は、追加できます。
- [保存]をクリックします。
- バーチャルエージェントアプリのプロパティのページのテストのセクションでマイクオプションを使用することで、トランスクリプションサービスをテストします。
バーチャルエージェントをテストする
必須の権限：
バーチャルエージェントの多くの側面をテストして、すべてが意図したとおりに機能することを確認できます。 Virtual Agent Hubのバーチャルエージェントアプリのプロパティページからテストを実行できます。 テストでは次のことを行えます：
- バーチャルエージェントアプリがバーチャルエージェントプロバイダーと通信するように正しく構成されていることを確認します。
- カスタムペイロードJSONを追加して、バーチャルエージェントによるカスタムペイロードデータの処理をテストします。
- ウェルカムインテントイベントをトリガーして、バーチャルエージェントが会話を開始する方法をテストします。
- カスタムインテントイベントをトリガーして、バーチャルエージェント用に作成したカスタムイベントをテストします。
- タイムアウトイベントをトリガーして、コンタクトがタイムアウトしたときにバーチャルエージェントがどのように応答するかをテストします。
- バーチャルエージェントがDTMF ユーザーが電話のキーパッドのキーを押すかタップしたときに生成される信号音。入力を処理する方法をテストします。
次の画像はVirtual Agent Hubのバーチャルエージェントアプリのプロパティページの例です。 構成と音声タブおよびテストペインが表示されます。
- CXoneで、アプリセレクターをクリックし、選択します：その他>自動化とAI、次いでVirtual Agent Hubの順にクリックします。 また、Studioスクリプトで使用しているバーチャルエージェントアクションをダブルクリックして、Virtual Agent Hubを起動することもできます。
- 左側のリストから、テストしたいバーチャルエージェント用の構成アプリをクリックして選択します。
-
[テスト]ペインで、[メッセージを入力]フィールドにテストメッセージを入力し、エンターキーを押して送信します。 マイク
をクリックして、コンピューターのマイクに向かって話すこともできます。 - ウェルカムインテントで開始をクリックして、最初からテスト会話を開始します。 バーチャルエージェントはデフォルトのウェルカムメッセージで応答します。 テストメッセージを入力することができます。
-
その他のオプション
をクリックして、バーチャルエージェントの他の側面をテストします。このステップのフィールドについての詳細
フィールド 詳細 カスタムペイロードJSONを追加 ここを選択してバーチャルエージェントへのカスタムペイロードJSONの送信をテストします。
[テスト+追加]ページに表示される[カスタムペイロードJSON]テキストボックスにカスタムペイロードを入力します。 各行の後にエンターキーを押します。
カスタムペイロードをテストする準備ができたら、テストメッセージを送信します。 カスタムペイロードのテストが終了したら、[カスタムペイロードJSONを追加]ペインで[閉じる]をクリックします。
ウェルカムインテントイベントをトリガー デフォルトのウェルカムインテント コンタクトが発言または入力した内容の背後にある意味や目的。コンタクトが伝えたいことや達成したいこと。をテストする場合に選択します。 バーチャルエージェントはウェルカムメッセージを送信します。 応答するメッセージを入力します。カスタムインテントイベントをトリガーする カスタムインテントイベントをテストする場合に選択します。 表示されるポップアップにイベント名を入力し、[トリガー]をクリックします。 バーチャルエージェントは入力したインテントに対してメッセージを送信します。 レスポンスを送信してインテントをテストします。 タイムアウトイベントをトリガー デフォルトのタイムアウトインテントを表示する場合に選択します。 バーチャルエージェントはそれで設定されたタイムアウトレスポンスメッセージを送信します。 DTMF入力 ここを選択してDTMF ユーザーが電話のキーパッドのキーを押すかタップしたときに生成される信号音。発信音に対する音声バーチャルエージェントのレスポンスをテストします。 DTMF文字を入力し、入力をクリックしてそれらの文字に対するバーチャルエージェントのレスポンスを確認します。 - [リセット]をクリックして、テストを再開します。
-
テストの結果に基づいて変更を加える必要がある場合は、次のことができます。
- バーチャルエージェントのStudioスクリプトを変更します。
- Virtual Agent Hubのバーチャルエージェントアプリの構成設定を変更します。
- プロバイダのコンソールでバーチャルエージェントの構成設定を変更します。 Virtual Agent Hubのアプリのプロパティのページにある大きな四角いボタンをクリックします。 このセクションの冒頭の例では、プロバイダーボタン付きのGoogle Dialogflow CXアプリとを表示しています。 リンクが外部サイトを開くことを示す
アイコンが表示されます。
- スクリプトまたは構成設定を変更するたびにバーチャルエージェントを徹底的にテストします。
- テストが終了したら、[閉じる]をクリックします。