AI Agent Studioで受信カスタムイベントを設定します

1. AIエージェントの設定ページの「レスポンス 」タブで新しいレスポンスを作成してください。
2. 「デフォルトの応答」で、デフォルト （ウェブ）チャンネルの横にある「+」をクリックして音声チャンネルを追加します
3. 受信イベント名フィールドで、 エージェントが受信するイベント名を定義します。

フローデザイナーからカスタムイベントを呼び出します

1. Webex コンタクトセンターのフローデザイナーで、フロー内のバーチャルエージェント V2 アクティビティを設定します。
2. 州イベントの設定で、イベント名 -イベントデータ列に次の詳細を指定します。

   1. AI Agent Studioの AI エージェント設定ページの「レスポンス」タブで設定したカスタムイベント名を入力します。

   2. Flow Designerからスクリプト化されたAIエージェントに渡したいカスタムデータを入力してください。

AI Agent Studioのカスタムイベントデータにアクセスします

受信イベントを設定したデフォルトレスポンスセクションで、イベントデータ（フローデザイナーで設定）にアクセスできます。 次の図では、カスタムイベント名 "" とイベントデータ "custom_welcome" がフローデザイナーから AI Agent Studio に渡されていることがわかります。store name

AI Agent Studioでカスタムの終了イベントとペイロードを設定します

1. AI Agent Studioで、スクリプト化されたAIエージェントの設定ページに移動し、 Responseに移動して、コントロールをフローデザイナーに戻してください。

2. デフォルトの回答セクションにカスタムイベントを追加してください。

3. フローに戻したいイベント名とイベントペイロードデータをJSONに入力します。

この例では、 収集されたスロットはカスタム終了イベントでフローに戻されます “order_details”。

フローデザイナーでカスタムイベントデータにアクセスする

カスタムイベントとペイロードには、 Virtual Agent V2アクティビティの出力変数セクションからアクセスできます。

Event nameStateEventName は変数の下で返され、Event payload は次の図のように返されます。Metadata

AI エージェントスタジオのシステム値を更新します

コンテキスト、インテント、スロットなどのシステム値は、次の例に示すように 、 state_updateEvent payload特別なイベントと値を使用して更新できます。

{ 
 "intent": "order_status", 
 "slots": { 
 "first_name": "John" 
 } 
"context": {
    "track": 1
 }
} 

上の例では、スクリプトエージェントのインテントがに設定され order_status、そのインテント内のスロット「first_name」が「John」 に設定され、「トラック」というコンテキストがセッションに追加されます。

このイベントは、 スクリプト化されたエージェントの会話をフローロジックで制御する必要がある場合に役立ちます。 これが特に役立つユースケースには、次のものがあります。

• フローの履行に失敗した場合は、ユーザーに情報の入力を再度求めます

  エージェントがユーザーの予約をしているシナリオを考えてみましょう。 日付と時刻を収集した後、 この情報はカスタムイベントを介してフローに送信され、HTTPSリクエストアクティビティを使用して予定の予約が試みられます。 スケジュールの都合で予約が拒否された場合、 AIエージェントは別の時間帯をリクエストする必要があります。 これを処理するために、 開発者は次のイベントペイロードを使用できます。

  {
  "intent": "book appointment",
  "slots": {
  "time": ""
  }
  }

  この場合、時間として収集された値はクリアされ、 AIエージェントはユーザーに新しい値を入力するように促します。 開発者は条件付き応答を設定して、 前のスロットが利用できなかったことをユーザーに知らせたり、新しい時間をリクエストしたりできます。

• 別のインテントに移動してください

  ユーザーが残高の確認をリクエストしたが、前提条件として、 ユーザーが最初に本人確認を行う必要があるシナリオを考えてみましょう。 残高照会プロセスの一環として、 開発者はイベントペイロードを送信して、 ユーザーがすでに認証されているかどうかをフローに知らせることができます。 確認されれば、システムは残高の取得に進むことができます。確認されていない場合は、 フローはAIエージェントに次のイベントペイロードを使用してユーザー検証プロセスを開始するように促すことができます。

  {
  "intent": "verify user",
  }

  同じ例で、 認証にユーザーの生年月日とPINコードが必要だとしましょう。 フローのうち、CJDS経由でユーザーの生年月日に関する情報がすでに入っています。 それをスロットとして渡すことができ、収集できるのはPINコードだけです。 そのためのイベントペイロードは次のようになります：

  {
  "intent": "verify user",
  "slots": {
  "date of birth": "06/26/1993"
  }
  }

• 会話のコンテキストを紹介またはリセットする

  会話コンテキストを更新する必要がある場合、開発者はそれをイベントのイベントペイロードに含めることができます。 state_update たとえば、AI Agentは「ユーザーを検証」 インテントのスロットを収集した後、会話コンテキストを「検証」に設定します。 フローで検証が失敗した場合は、コンテキストをリセットして、ユーザーが「検証」 コンテキストを必要とするインテントにアクセスできないようにする必要があります。 このシナリオのイベントペイロードは次のようになります。

  {
  "intent": "verify user",
  "slots": {
  "date of birth": "",
  "pincode": ""
  },
  "context": {
  "verify": 0
  }
  }