Dialogflow Botアクションを呼び出す

前提条件 

統合 > 統合 > 見る 権限の任意に割り当てられたユーザー 役割

Call Dialogflow Botアクションを使用して、顧客をエージェントにルーティングする前またはルーティングする代わりに、フロー内でセルフサービスアプリケーションを実行します。

メモ: 
  • このアクションは、通話、チャット、およびメッセージフローで使用できます。
  • Architect でコール ダイアログフロー ボットアクションを有効にするには、まず Genesys AppFoundry から Google ダイアログフロー統合を取得する必要があります。 次に、Genesys Cloudで設定し、GoogleコンソールでGoogle Dialogflowボットを作成します。
  • 少なくとも 1 つのアクティブな Google ダイアログフロー統合を有効にする必要があります。 詳細については、 Google Dialogflow統合について.
  • Googleは、Google Dialogflowボットに加えた変更コンソールに表示されるまで数分かかることがArchitect 。
  • Google Dialogflowボットの割り込み機能性を有効にするには、 Google Dialogflowボットの介入を有効にする.
  • 管理者は、Architect フローで使用可能な任意のテキストからスピーチへのプロバイダを使用して、インストール済みの Bot 統合を使用できます。 詳細については、以下を参照してください。 テキスト音声変換(TTS)統合について.
  • Google Dialogflowの設定に関する詳細については、 Google Dialogflow統合について そして Google Dialogflowのよくある質問.
名前 説明
名前フィールド アクションの識別名を入力してください。 ここで入力するラベルは、タスクシーケンスに表示されるアクションの名前になります。
Dialogflow CX エージェント

使用する特定のダイアログフロー ボット (エージェントとも呼ばれます)。 このバージョンは、Google コンソール作成するエージェントボットです。
環境

実行時にフローで使用する Google Dialogflow 環境を選択します。

 メモ：   ドラフト環境は、Dialogflowエージェントでは常に使用できます。 選択した Dialogflow エージェントに対して環境を作成しなかった場合は、[ドラフト] のみを使用できます。 そうでない場合は、公開された環境のリストがドラフトに加えて表示されます。

環境は、流れがGoogleのDialogflowエージェントのバージョンを選択するための方法を提供するArchitect流れで通話ランタイム 。 ArchitectでのGoogle Dialogflow環境の使用の詳細については、 Architect Google Dialogflow環境を使用する. 詳細については、を参照してください。 バージョンと環境 Google DialogflowCXのドキュメントにあります。
初期イベント名

インタラクションの開始時にトリガーする Dialogflow エージェント イベントの名前。
エージェント入力テキスト

Dialogflow Agent に送信する文字列変数テキスト。

 メモ：   通常、このフィールドは、ボット アクションをチェーンする場合にのみ使用します。
セッション パラメーター

ボットに渡したり、ボットから取得できる情報。 変数の名前と割り当てる値を入力します。 複数の変数を追加したり、それらを並べ替えることができます。

入力

入力は、指定された名前のGoogle Cloud Dialogflow CXセッションパラメータを、DialogflowCXセッションの開始時に指定された値で設定します。

  • キー名 この値は、DialogflowCXセッションパラメータの名前を表します。 詳細については、を参照してください。 バージョンと環境 Google DialogflowCXのドキュメントにあります。
  • 割り当てる値 DialogflowCXセッションの開始時に指定された値。

出力

出力を使用して、指定されたGoogle Cloud Dialogflow CXセッションパラメータの値を読み取り、その値に割り当てるアーキテクト変数を設定します。

 メモ：   キー名は大文字と小文字が区別されます。

  • キー名
  • 割り当てる変数
ライブ エージェント ハンドオフ メタデータ

Google Cloud DialogflowCXから返された値をアーキテクト変数にマップします。 これらの値は、Google Cloud DialogflowCXエージェントで指定した「ライブエージェントハンドオフ」フルフィルメントペイロードから取得されます。 LiveエージェントハンドオフフルフィルメントペイロードはJSONオブジェクトである必要があります。 キー名は、JSONオブジェクトのキーの名前です。 詳細については、を参照してください。 インテントをキャンセルする Google DialogflowESのドキュメントにあります。
フォローアップ応答タイムアウト

Google Cloud Dialogflow CX ボットは、ユーザーからフォローアップ情報を取得する場合があります。 ここで、ボットがユーザーの応答を待つ時間を入力します。

デフォルトの応答タイムアウトは12時間で、最小許容値は0秒です。 システムは、 または即時の負の期間。

 メモ：   注意：フォローアップ応答タイムアウトは各顧客の応答に適用されます。 顧客が応答してボットから別のプロンプトを受信するたびに、タイムアウトはリセットされます。

たとえば、ボットが「希望の日付は何ですか」と尋ねた場合、顧客からの応答を最大12時間待ちます。 12時間の時間枠内の日付とボットの回答と顧客応答した場合、「ありがとう、あなたは別の選択肢を持っているか、」フローは再起動しタイムアウト 。 フローは代替日付に関する応答をさらに12時間待ちます。
失敗の出力

Dialogflowボットによって返される障害データ値に割り当てる変数を選択します。

データ値 変数
errorType
  • FeatureNotEnabledError: Call Dialogflow Botアクションは、組織では使用できません。
  • 内部サーバーエラー: Dialogflow Botの呼び出しアクション中に予期しないエラーが発生しました。 通常、受信した応答は無効な形式です。 連絡先 Genesys Cloudカスタマーケア.
  • NoInputError: コールDialogflowボットの行動は、いかなるせずにタイムアウトしたユーザー入力。
  • NoMatchError： Dialogflow CXボットが受け取ったユーザー入力は、どの文法要素とも一致しませんでした。
  • NoResourceError： Dialogflow CXボットの応答には、アクセス可能なリソースが含まれていません。
     メモ：   このエラーは、クレジット カードの有効期限が切れているなど、請求に関する問題によって発生することもあります。
  • VersionMismatchError： Dialogflowボットから成功を受け取りましたが、不一致が発生しました。 たとえば、返されたインテントは、アクションで設定されたインテントと一致しませんでした。 フローを再ロードして再公開してください。
エラーメッセージ： ローカライズされていないメッセージ。 この文字列変数は、空またはNOT_SETにすることができます。

 メモ：   変数のリストを展開または折りたたむには、横の矢印をクリックします 失敗の出力.

意図パスと障害パスの構成

名前 説明
成功率

Google Dialogflowボットのドラフトは、これらのパスを指示します。
障害出力パス

このパスは、アクションの実行中にエラーが発生したか、または結果の処理中に問題が発生したことを示しています。  

 メモ：   ネットワークで接続の問題が発生した場合、このアクションは自動的にこの失敗経路をたどります。

適切なアクションをFailureパスの下にドラッグして、やり取りする経路を指示します。 たとえば、発信者を援助のためにエージェントに送信する転送アクション。