|
|
セルフサービスを統合します仮想エージェント TextBot Exchange
このアクションをダブルクリックすると、仮想エージェントハブが開き、すべての仮想エージェントボットを管理できます。 |
サポートされているスクリプトタイプ
|
|
|
|
|
| Eメール | チャット | SMS | デジタル |
サポートされている仮想エージェント
このアクションは、次の仮想エージェントをサポートします。
- Amazon Lex V1
- CXone SmartAssist Powered by Amelia
- Google Dialogflow CX
- Google Dialogflow ES
- Microsoft Azure
このアクションに仮想エージェントを割り当てる前に、仮想エージェントハブで仮想エージェントにアプリを追加して構成する必要があります。各仮想エージェントに必要なアプリは1つだけです。スクリプト内の複数の仮想エージェントアクションに同じアプリを割り当てることができます。構成の詳細については、使用しているバーチャルエージェントプロバイダーのヘルプページを参照してください。
類似アクションの比較
以下のアクションには同様の機能がありますが、いくつかの重要な相違点があります。
-
-
- Voicebot Conversation：このactionは、非常にシンプルなバーチャルエージェントにのみ適しています。ターンごとの仮想エージェントの行動をカスタマイズすることはできません。SIPバックチャネル接続を使用する場合でバーチャルエージェントでサポートされている場合、Voicebot Conversationを使用する必要があります。
-
入力プロパティ
これらのプロパティは、アクションが実行時に使用するデータを定義します。
このアクションのプロパティの中には、Snippetアクションにカスタムコードを必要とするものが1つ以上あります。
| プロパティ | 詳細 |
|---|---|
| Caption |
スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。アクションアイコンにカーソルを合わせるとキャプションが表示されます。 |
| virtualAgentID |
仮想エージェントハブで選択された仮想エージェントの名前。仮想エージェントハブのStudioアクションに仮想エージェントアプリを割り当てると、このプロパティが自動的に設定されます。名前は、仮想エージェントハブアプリのVirtual Agent (Bot) Nameフィールドで使用される名前です。 |
| automatedIntent |
収集されたユーザー入力を仮想エージェントに解釈させるのではなく、仮想エージェントが応答する特定のインテントを名前で入力します。一般的な使用例は、仮想エージェントから最初のウェルカムメッセージを引き出すことです。Welcomeは、最初の挨拶の標準文字列です。 |
| userInput |
コンタクトがチャットウィンドウに書き込んだメッセージは、テキスト入力として仮想エージェントに渡されます。 |
| customPayload |
このプロパティは、カスタムペイロードデータを仮想エージェントに渡す必要がある場合にのみ設定します。カスタムペイロードオブジェクトはStudioスクリプトから設定されます。これを使用して、ウェルカムメッセージで使用されるCRM スクリプトから仮想エージェントにデータを渡すJSONオブジェクトの名前を入力します。Snippetアクションでカスタムペイロードオブジェクトを定義する必要があります。オブジェクトはスニペットまたはcustomPayloadプロパティのいずれかでJSONに変換する必要があります。 特定の仮想エージェントプロバイダーの要件:
仮想エージェントがスクリプトに返すデータを処理する必要がある場合は、このプロパティを使用しないでください。代わりにcustomPayloadVarName (out)変数を使用します。 |
| botSessionState |
バーチャルエージェントプロバイダーは、コンタクトとバーチャルエージェント間の各会話に、一意の識別子を割り当てます。この識別子は、会話のターンごとに新しいセッションが作成されるのを防止できます。プロバイダーは、会話の開始時に識別子を作成し、最初の応答とともにスクリプトに渡します。スクリプトは、 仮想エージェントが正しく動作するには、このプロパティが適切に設定されている必要があります。設定方法の詳細については、ボットセッション状態スニペットヘルプページを参照してください。 |
出力プロパティ
これらのプロパティには、実行したアクションから返されたデータを保持する変数が含まれています。これらはアクションが完了したときに参照・使用することができます。
|
プロパティ |
説明 |
|---|---|
| nextPromptVarName (out) |
次の会話ターンでユーザーにプロンプトを表示するための動作を定義します。 |
| customPayloadVarName (out) |
仮想エージェントからスクリプトにカスタムJSONデータを返します。仮想エージェントが提供するデータをスクリプトで処理する場合は、この変数を使用します。フルフィルメントデータが含まれる場合があります。 仮想エージェントにデータを提供する場合は、customPayloadプロパティを使用します。 |
| errorDetailsVarName (out) |
エラーインテントシーケンスを要求します。ライブエージェントへの転送につながる可能性があります。 |
| intentInfoVarName (out) |
現在のユーザーの意図を示す仮想エージェントからの詳細を保持する変数。 |
| botSessionStateVarName (out) |
仮想エージェントプロバイダーから送信されたボットセッション状態識別子をスクリプトが格納するための変数を保持します。変数の内容はbotSessionStateプロパティに渡されます。 仮想エージェントが正しく動作するには、このプロパティが適切に設定されている必要があります。設定方法に関する詳細は、ボットセッション状態スニペットのヘルプページを参照してください。 |
結果ブランチ条件
結果の分岐条件を使用すると、アクションが実行されたときにさまざまな結果を処理できるように、スクリプトにブランチを作成できます。
|
状態 |
説明 |
|---|---|
| Default | スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。他のブランチが定義されていない場合にも使用されます。 |
| OnPromptAndCollectNextResponse |
仮想エージェントがインタラクションを継続することを決定し、コンタクトからの人間の入力の準備ができている場合に取られるパス。会話の次のターンのプロンプト。 |
| OnError | 予期しない問題（たとえば、接続不良、構文エラーなど）が発生したときに使用されるパス。_ERR変数には、問題の簡潔な説明を入力する必要があります。 |
| OnReturnControlToScript |
仮想エージェントが会話の終了を示し、通話を転送または終了するための制御をStudioスクリプトに戻す場合に使用されるパス。customPayload結果で処理されるフルフィルメントデータがある場合があります。 |
Snippetアクションコード
このアクションのプロパティの中には、Snippetactionに次のカスタムコードを必要とするものが1つ以上あります。
Google Dialogflow CXを使用したカスタムペイロードのベストプラクティス
Google Dialogflow CXで、このアクションを使用する場合、カスタムペイロードを統合するためには、以下のベストプラクティスに従ってください。
- DialogflowCXは、DialogflowESのようにデータをDialogflowインテント
連絡先の発言/入力する内容の背後にある意味または目的。連絡先が伝えたいこと、または達成したいこと。に渡すためにコンテキストを使用しません。 -
カスタムデータはJSONキー値ペアを使用してDialogflow CXに渡すことができます。スクリプト内のSnippetアクションに、ダイナミックcustomPayloadオブジェクトを作成して、それにキー値ペアを追加します。たとえば。
DYNAMIC customPayload customPayload.ani = ani customPayload.contactID = contactId customPayload.masterContactId = masterId customPayloadJSON = "{customPayload.asJSON()}" - スクリプトの交換または会話アクションで、値にasJSON()関数を持つ変数を使用してcustomPayloadプロパティを構成します。この変数はcustomPayloadオブジェクトにあります。
-
に関するGoogleのドキュメンテーションを参照してください。 -
- 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ボットで同様の結果を得るには、コンテキストを使用します。
- コンタクトが話しの途中一時停止したときにバーチャルエージェントが待機する時間を構成するには、maxPostEnergySilenceMSパラメーターをnextPromptBehaviorsまたはdefaultNextPromptBehaviorSnippetアクションに追加します。
Google Dialogflow ESを使用したカスタムペイロードのベストプラクティス
Google Dialogflow ESで、このアクションを使用する場合、カスタムペイロードを統合するためには、以下のベストプラクティスに従ってください。
- CustomPayloadはインテント 連絡先の発言/入力する内容の背後にある意味または目的。連絡先が伝えたいこと、または達成したいこと。のためにコンテキストを渡すために使用します。コンテキストはバーチャルエージェントがユーザーのインテントを理解するために役立ちます。コンテキストは必須ではありませんが、バーチャルエージェントが発話 連絡先が言うことまたはタイプすること。をインテントに一致させるために役立ちます。
- スクリプトのSnippet アクションで、RESTリソース用のGoogle Dialogflow ESドキュメンテーションで概説されている形式に従うcustomPayloadオブジェクトを作成します: projects.agent.sessions.contextStudioオンラインヘルプには、ダナミックデータ変数およびオブジェクトに関する詳細情報が用意されています。
- また、コンテンツなしのcustomPayloadでカスタムデータを渡すことができます。そのためには、標準JSONキー値ペアをDYNAMICオブジェクトに含めるようにします。
- スクリプト例に示すように、customPayloadDYNAMICオブジェクトはJSONのバーチャルエージェントパラメーターとして渡されます。
カスタムペイロードを統合するためのスクリプト例を見る
このスクリプトは、Google Dialogflow ESバーチャルエージェントとカスタムペイロードを統合する方法の例です。このスクリプトではVoicebotExchange アクションを使用しますが、カスタムペイロードの統合プロセスは同じです。
