Google Dialogflow ESを統合する

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

スクリプトを作成

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

インタラクションをバーチャルエージェントへルーティングするには、少なくとも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)に割り当てます。

カスタムペイロードベストプラクティス

カスタムペイロードデータGoogle Dialogflow ESCXoneに統合するときは、これらのベストプラクティスに従ってください:

  • CustomPayloadインテント閉じた コンタクトが発言または入力した内容の背後にある意味や目的。コンタクトが伝えたいことや達成したいこと。のためにコンテキストを渡すために使用します。 コンテキストはバーチャルエージェントがユーザーのインテントを理解するために役立ちます。 コンテキストは必須ではありませんが、バーチャルエージェントが発話閉じた コンタクトが発言または入力すること。をインテントに一致させるために役立ちます。
  • スクリプトのSnippet アクションで、RESTリソース用のGoogle Dialogflow ESドキュメンテーションリンク先が外部Webサイトであることを示すアイコンで概説されている形式に従うcustomPayloadオブジェクトを作成します: projects.agent.sessions.context Studioオンラインヘルプには、ダナミックデータ変数およびオブジェクトに関する詳細情報が用意されています。
  • また、コンテンツなしのcustomPayloadでカスタムデータを渡すことができます。 そのためには、標準JSONキー値ペアをダイナミックデータオブジェクトに含めるようにします。
  • 音声コンテキストは、speech_contactパラメーターのカスタムペイロードで渡されます。 このパラメーターの内容は、Studioのトレースやアプリケーションログで確認できます。
  • スクリプト例に示すように、customPayloadDYNAMICオブジェクトはJSONのバーチャルエージェントパラメーターとして渡されます。
  • スピーチコンテキストのヒントは、speechContextsパラメーターにカスタムペイロードで渡すことができます。 speechContexts.phrases の値は、提供したいヒントのGoogleクラストークン中央から右上に向かって矢印が伸びている正方形。でなければなりません。 このトークンは、コンタクトの言語およびロケールと一致している必要があります。 例:

    DYNAMIC customPayload
    customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
    customPayload.speechContexts.boost=10		

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

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

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

  1. Studioで、スクリプトを開くか作成し、バーチャルエージェントのアクションを追加します(まだ含まれていない場合)。
  2. 仮想エージェントアクションをダブルクリックして、 Virtual Agent Hub
  3. ボットの追加をクリックします。
  4. [バーチャルエージェント(ボット)名]を入力して、バーチャルエージェントプロバイダーのリストでGoogle Dialogflow ESをクリックします。

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

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

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

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

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

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

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

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

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

Google Dialogflow ES設定ページの詳細

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

フィールド

詳細

連携バージョン

使用したいVirtual Agent Hubバージョンを選択します。 このオプションでは、新しくリリースされるバージョンに切り替える準備ができるまで、Virtual Agent Hubの以前のバージョンを使用できます。 利用可能なバージョンは以下の通りです。

  • バージョン1.0.0これはVirtual Agent Hubの最初のバージョンです。 カスタムペイロードオブジェクトはcustomPayload.payload.xxxxとして返されます。
  • バージョン2.0.0このバージョンではGoogle Dialogflow ESで使用されているスキーマを更新しました。 これはcustomPayloadオブジェクトの構造に影響します。
  • バージョン3.0.0:このバージョンでは、StandardBotが導入され、CXoneがバーチャルエージェントプロバイダーと通信する方法が標準化されました。 customPayloadオブジェクトは、customPayloadscriptPayloads[n].xxxxのように配列として返す。 このバージョンはすべてのプロバイダーで利用可能です。
顧客のGCPプロジェクトID

組織のGoogle CloudプロジェクトID。 これは、バーチャルエージェントの識別子です。 Google Dialogflow ES コンソールの設定でそれを見つけることができます。

このフィールドは、OEMサービスアカウントを使用している場合にのみ表示されます。

JSONサービスアカウント

Google Cloud Consoleから作成してダウンロードしたサービスアカウントキーファイル。 キーファイルの内容全体をコピーしてこのフィールドに貼り付けます。 このフィールドは、自分のGoogle Dialogflow ESアカウントを使用している場合にのみ表示されます。

サービスアカウントキーは、次の例のようなJSONオブジェクトです。

{

"type": "service_account",
"project_id": "ic-demo2-aai-gcp",
"private_key_id": "sdv80sdf08ssd9sdf0sdf8sdfsdf90sdf8",
"private_key": "-----BEGIN PRIVATE KEY-----
nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCzgrS8vp
<private key has been truncated for this example>
----END PRIVATE KEY-----\n",
"client_email": "your@client_email-gcp.iam.gserviceaccount.com",
"client_id": "123456789",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/dialogflow-dthjop%40ic-demo2-aai-gcp.iam.gserviceaccount.com"
}

言語

このバーチャルエージェントに使用させたい言語。 これは、バーチャルエージェントが理解する言語です。 これは必須フィールドです。

リージョン Google Dialogflow ESバーチャルエージェントが位置する領域。
環境 バーチャルエージェントが公開されるカスタム環境の名前。 このフィールドを空白のままにした場合は、ドラフト環境が使用されます。
出力TTSを実行する

Google Dialogflow ESテキスト読み上げ(TTS閉じた ユーザーが録音プロンプトをテキストとして入力し、コンピューターで生成された音声を使用してその内容を読み上げる機能。)サービスを使用する場合は、このオプションを有効にします。 TTS出力設定を設定します

GoogleTTSサービスを利用しない場合は、CXoneCloud TTS Hubを使用できます。 設定アプリウィザードの音声のページでこのオプションを設定します

タイムアウトイベント タイムアウト時にトリガーするGoogle Dialogflow ESイベントの名前。
DTMFブレイクアウトパターン

呼び出し中に、バーチャルエージェントが StudioスクリプトのDTMFBreakout 分岐にスキップする原因となる文字を入力します。

このフィールドは、それが音声バーチャルエージェントの場合にのみ完了します。

Google Protobuf JSONシリアライザーを使用する

GoogleProtobuf Serializerを使用するには、このオプションを有効にします。 応答をシリアライズして、応答のサイズおよびそれらの処理に必要なメモリを小さくすることで、パフォーマンスが向上します。 サイズを小さくすると、レスポンスが32KBを超える可能性が小さくなります。これは、スクリプト変数の一般的サイズ制限です。

NICE CXoneは、このオプションを有効にすることを推奨しています。 何らかの理由で無効にする必要がある場合は、問題が解決したらすぐに有効に戻すことをお勧めします。

2022年春バージョンのCXoneの前にGoogle Dialogflow ES連携を設定する場合は、ペイロード解析用のスクリプトを確認することが重要です。 これをどこで見つけた場合でも、このオプションを連携で有効にする前に、新しいスキーマからの解析で置き換える必要があります。 たとえば、スクリプトが現在このようなものを参照している場合: 

{parameters.fields.myfield.stringValue}

次のように変更します:

{parameters.myfield}

外部プロバイダーのタイムアウト

スクリプトがDialogflow ES からの応答を待機する秒数を入力します。 タイムアウトに達すると、コントロールはスクリプトに戻り、エラーブランチを取ります。

Google Dialogflow ESTTS出力を設定する

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

GoogleTTSサービスを使用する場合は、このセクションのステップを完了してください。 Virtual Agent HubDialogflowES構成のページで出力TTSの実行のオプションを有効にすると、次の画像のフィールドが表示されます。

  1. Virtual Agent Hubで、新しい構成アプリを追加し、このページのアプリを追加Virtual Agent Hubのセクションのステップに従って構成します。
  2. 出力TTSを実行するを有効化
  3. カスタム音声モデルを使用するには、カスタム音声を使用を有効化し、カスタム音声モデルのフィールドに使用するAutoMLモデルの名前を入力します。

  4. Google音声モデルを使用する場合は、ドロップダウンからTTS音声名を選択します。

  5. 音声を合成する際にGoogleTTSサービスに使用させたい機械学習モデルモデルバリアントを選択します。

  6. バーチャルエージェントの音声応答の最初に沈黙を追加するには、先頭の無音を追加のフィールドに追加する沈黙のミリ秒数を入力します。 推奨される無音の時間は500ミリ秒です。

  7. 発話速度ピッチ音量ゲインを入力し、TTS音声にどのように発音させたいかを構成します。

  8. このページのアプリを追加Virtual Agent Hubのセクションに戻り、構成アプリの追加を終了します。

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

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

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

  3. 「音声」ページの[音声連携オプション]の下で、ナビゲーション管理(CXone音声ボットゲートウェイ)を選択します。
  4. フォームでCXoneクラウドTTSを使用を選択できない場合は、戻るをクリックして構成ページに戻ります。 出力TTSの実行スライダーをクリックしてオフにします。 これで音声ページでCloud TTS Hubを有効にできます。

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

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

Google Dialogflow ESアプリをアクションに割り当てる

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

バーチャルエージェント閉じた コンタクトが発言または入力した内容の背後にある意味や目的。コンタクトが伝えたいことや達成したいこと。アプリを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. その他のオプション 3つのドットを縦に重ねたアイコン。をクリックして、バーチャルエージェントの他の側面をテストします。

  7. [リセット]をクリックして、テストを再開します。
  8. テストの結果に基づいて変更を加える必要がある場合は、次のことができます。

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