Google Dialogflow CXを統合する

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

スクリプトを作成

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

インタラクションをバーチャルエージェントへルーティングするには、少なくとも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メール、チャットなどの手段。.

バーチャルエージェントとのSIP閉じた 音声通話やビデオ通話などのマルチメディア通信セッションのシグナリングと制御に使用されるプロトコル。バックチャネル接続を使用している場合、CXoneアカウント担当者までお問い合わせください。

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

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

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

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

  • DialogflowCXは、DialogflowESのようにデータをDialogflowインテント閉じた コンタクトが発言または入力した内容の背後にある意味や目的。コンタクトが伝えたいことや達成したいこと。に渡すためにコンテキストを使用しません。
  • カスタムデータはJSONキー値ペアを使用してDialogflow CXに渡すことができます。 スクリプト内のSnippetactionで、ダイナミックcustomPayloadオブジェクトを作成して、それにキー値ペアを追加します。 例:

    DYNAMIC customPayload
    customPayload.ani = ani
    customPayload.contactID = contactId
    customPayload.masterContactId = masterId
    customPayloadJSON = "{customPayload.asJSON()}"	
  • スクリプトのExchangeまたはConversationアクションで、値asJSON()関数を持つ変数でcustomPayloadプロパティを構成します。 この変数はcustomPayloadオブジェクトにあります。
  • QueryParametersPayloadプロパティを使用して、customPayloadJSONをバーチャルエージェントに渡します。 Google Dialogflow CX用のQueryParameters中央から右上隅の外側方向に向いた矢印を持つ正方形。に関するGoogleのドキュメンテーションを参照してください。
  • QueryParametersによってパスされるデータはDialogflowCXのwebhookが受け取ります。 パスされるデータを処理するために、Dialogflow CXコンソールでコードとを作成することができます。
  • customPayloadオブジェクトの中にオブジェクトをネストしないでください。 ネストされたオブジェクトはリテラル文字列として送信されます。
  • DialogflowCXバーチャルエージェントからスクリプトにカスタムデータを渡すには、DialogflowCXコンソールのカスタムペイロードフィールドを使用します。 CXoneで使用している仮想エージェントのコンソールにいることを確認してください。 スクリプトの音声またはチャットStudioアクションでcustomPayloadVarName (out)変数を使用して、これをスクリプトにマッピングします。 たとえば、これを使用して次のプロンプトの動作を設定できます。
  • customPayloadを使用して設定されたパラメーターは、外部Webhookでのみ使用できます。 外部Webhookの外部で使用するパラメーターを設定する場合は、session_paramsフィールドを持つSnippetアクションにそれらを設定します。 例:

    {
    	"session_params":
    	{ 
    		"name": "Winnie Le Pooh"
    		"job": "Food critic"
    		"location": "Hundred Acre Wood"
    	}
    }

    次の構文を使用して、DialogflowCXエージェントインテントのセッションパラメタにアクセスします。

    $session.params.name = Winnie Le Pooh

    $session.params.job = Food critic

    $session.params.location = 100 Acre Wood

    セッションパラメーターは、DialogflowCXバーチャルエージェントでのみ使用されます。 DialogflowESボットで同様の結果を得るには、コンテキストを使用します。

  • スピーチコンテキストのヒントは、speechContextsパラメーターにカスタムペイロードで渡すことができます。 speechContexts.phrases の値は、提供したいヒントのGoogleクラストークン中央から右上に向かって矢印が伸びている正方形。でなければなりません。 このトークンは、コンタクトの言語およびロケールと一致している必要があります。 例:

    DYNAMIC customPayload
    customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
    customPayload.speechContexts.boost=10		
  • VOICEBOT EXCHANGEを使用するとき:コンタクトが話している途中一時停止したときにバーチャルエージェントが待機する時間を構成するには、maxPostEnergySilenceMSパラメーターNext Prompt BehaviorsまたはDefault Next Prompt BehaviorsSnippetアクションに追加します。

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

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

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

SIP閉じた 音声通話やビデオ通話などのマルチメディア通信セッションのシグナリングと制御に使用されるプロトコル。バックチャネル接続をバーチャルエージェントで使用している場合は、この種の接続をセットアップするための手順に従ってください。

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

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

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

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

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

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

  10. トランスクリプトのページで、会話のトランスクリプトとインテント情報をキャプチャするかどうかのオプションを選択します。 このオプションは、テキストバーチャルエージェントと発話ベースの音声バーチャルエージェントにのみ有効です。 SIP閉じた 音声通話やビデオ通話などのマルチメディア通信セッションのシグナリングと制御に使用されるプロトコル。バックチャネル接続を使用する音声連携に対応していません。

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

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

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

Google Dialogflow CX設定ページの詳細

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

SIP閉じた 音声通話やビデオ通話などのマルチメディア通信セッションのシグナリングと制御に使用されるプロトコル。バックチャネル接続を使用するためにDialogflowCXをセットアップする場合は、このセクションの手順ではなく、接続のセットアップ手順に従ってください。

フィールド

詳細

連携バージョン

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

  • バージョン1.0.0これはVirtual Agent Hubの最初のバージョンです。 カスタムペイロードオブジェクトはcustomPayload.payload.xxxxとして返されます。
  • バージョン2.0.0このバージョンではGoogle Dialogflow CXで使用されるスキーマが更新されました。 これはcustomPayloadオブジェクトの構造に影響します。
  • バージョン3.0.0:このバージョンでは、StandardBotが導入され、CXoneがバーチャルエージェントプロバイダーと通信する方法が標準化されました。 customPayloadオブジェクトは、customPayloadscriptPayloads[n].xxxxのように配列として返す。 このバージョンはすべてのプロバイダーで利用可能です。
設定済みSIP このバーチャルエージェントでSIPバックチャネル接続を使用する場合はここをクリックします。 SIPバックチャネル接続のセットアップは、別のプロセスです。
JSONサービスアカウント

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

サービスアカウントキーは、次の例のような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"
}

JSONサービスアカウントには、Dialogflow API管理者の役割中央から外側方向の右上隅に向いた矢印を持つ正方形。が必要です。

言語

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

リージョン Virtual Agent Hubに追加しているGoogle Dialogflow CXバーチャルエージェントが位置する領域。 これは必須フィールドです。
エージェント Virtual Agent Hubに追加するGoogle Dialogflow CXバーチャルエージェントの名前。 バーチャルエージェントのDialogflowCXコンソールで名前を見つけて、名前をコピーのオプションを使用して名前をクリップボードにコピーできます。 これは必須フィールドです。
環境 このDialogflowアプリで使用する環境のGUIDを入力します。 DialogflowCXでは、同じバーチャルエージェントの異なるバージョンを環境と呼びます。 環境のGUIDは、Google Dialogflow CXコンソールのエージェント設定で確認できます。
出力TTSを実行する

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

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

タイムアウトイベントハンドラー タイムアウト時にトリガーするGoogle Dialogflow CXイベントの名前。
DTMFブレイクアウトパターン 指定された文字が押されると、スクリプトはOnDTMFBreakout 分岐に直接スキップします。
外部プロバイダーのタイムアウト

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

Google Dialogflow CXTTS出力を設定する

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

GoogleTTSサービスを使用する場合は、このセクションのステップを完了してください。 Virtual Agent HubDialogflowCX構成のページで出力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のセクションに戻り、構成アプリの追加を終了します。

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

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

音声バーチャルエージェントでSIPバックチャネル接続を使用している場合は、代わりにSIPバックチャネルのセットアップのステップに従います。

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

  3. 「音声」ページの[音声連携オプション]の下で、ナビゲーション管理(CXone音声ボットゲートウェイ)を選択します。
  4. Text-to-Speechオプションの下で、CXoneTTSオプションを使用したい場合はCXoneクラウドTTSを使用を選択します。 代わりにバーチャルエージェントプロバイダーのTTSサービスを使用するには、このチェックボックスをオフにし、ウィザードの構成ページでTTS出力を構成します

    フォームでCXoneクラウドTTSを使用を選択できない場合は、戻るをクリックして構成ページに戻ります。 出力TTSの実行スライダーをクリックしてオフにします。 これで音声ページでCloud TTS Hubを有効にできます。

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

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

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

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

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