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パスの下にドラッグして、やり取りする経路を指示します。 たとえば、発信者を援助のためにエージェントに送信する転送アクション。