Zoom Virtual Agentのグローバルカスタム変数およびシステム変数の管理

変数を使用すると、チャットボットが情報を収集および保持して、ユーザーのエクスペリエンスをカスタマイズできるようになります。Zoom Virtual Agentの管理者は、グローバルカスタム変数を作成できます。これはアクセス可能になるよう設定され、さまざまなボットフロー全体で使用できます。さらに、デフォルトの変数であるシステム変数を表示して使用することで、チャットボットの異なる部分間でのデータ転送を容易にすることができます。

チャットボットのグローバル変数を使用すると、異なるインタラクション間で、言語の選択やコミュニケーションスタイルなどのユーザー設定を記憶できます。たとえば、チャットボットはグローバル変数を使用して、会話全体を通じてユーザーが好む言語を維持し、すべての返信が選択された言語で行われるようにすることができます。一方、システム変数は、ショッピングカートの合計、注文ステータス、ユーザー認証レベルなどの動的な情報を追跡するのに役立ち、さまざまなチャットボットフロー間で一貫した正確なデータ共有を可能にします。

変数を使用すると、HTTP呼び出し、スクリプト、または明確なユーザーテキスト入力やボタン選択を使用してユーザーに関する情報を収集し、その情報を使用してユーザーをルーティングし、ボットのエクスペリエンスを制御できます。

Zoom Virtual Agentのカスタム変数およびシステム変数の管理要件

• アカウントオーナーまたは管理者の特権、または関連するロール / 特権
• ベーシック、プロ、ビジネス、教育機関向け、またはエンタープライズアカウント
• Zoom Virtual Agentライセンス

システム変数およびカスタム変数の表示方法

1. Zoomウェブポータルにサインインします。
2. ナビゲーションメニューで、[AI Studio] > [バーチャルエージェント] の順にクリックします。
3. [設定] タブ > [変数] の順にクリックします。
4. 左側パネルの [カスタム変数グループ] の下で、関連する変数を表示する変数グループを選択します。
5. 歯車アイコンをクリックして、表示するテーブル列を選択します。
   次の情報が表示されます:
   • 変数名: 変数の内部表示名。
   • デフォルト値: デフォルト値が設定されている場合は、その変数のデフォルト値。省略記号（リーダー）アイコン が表示されている場合は、デフォルト値が定義されていないことを意味します。
   • グループタイプ: 変数タイプ。カスタム変数の場合は [カスタム]、システム変数の場合は [システム] が表示されます。
   • データタイプ: 変数のデータタイプ。
   • 説明: 変数の内部説明。
6. [確認] をクリックします。

カスタム変数のグループの作成方法

カスタム変数を追加する前に、カスタム変数を整理するためのカスタム変数グループを作成する必要があります。

1. Zoomウェブポータルにサインインします。
2. ナビゲーションメニューで、[AI Studio] > [バーチャルエージェント] の順にクリックします。
3. [設定] タブ > [変数] の順にクリックします。
4. 左側パネルで、[カスタムグループを追加] をクリックします。
5. 次の情報を入力します:
   • グループ名: カスタム変数グループを識別しやすくするための内部表示名を入力します。
   • 説明（オプション）: カスタム変数グループの説明を入力します。
6. [追加] をクリックします。
7. グループ内にカスタム変数を作成するには、次のセクションの指示に従ってください。

カスタム変数の作成方法

カスタム変数グループを作成した後は、そのグループに属するカスタム変数を作成できます。

1. Zoomウェブポータルにサインインします。
2. ナビゲーションメニューで、[AI Studio] > [バーチャルエージェント] の順にクリックします。
3. [設定] タブ > [変数] の順にクリックします。
4. 左側パネルの [カスタム変数グループ] の下で、カスタム変数を作成するカスタム変数グループを選択します。
5. [変数を追加] をクリックします。
6. カスタム変数の設定 を変更します。

カスタム変数のグループの編集または削除方法

1. Zoomウェブポータルにサインインします。
2. ナビゲーションメニューで、[AI Studio] > [バーチャルエージェント] の順にクリックします。
3. [設定] タブ > [変数] の順にクリックします。
4. 左側パネルの [カスタム変数グループ] の下で、編集するグループにホバーします。
5. 省略記号（リーダー）アイコン をクリックし、次のオプションのいずれかをクリックします:
   • 編集: グループの名前または説明を変更します。
   • 削除: グループ内のすべてのカスタム変数を含むカスタム変数グループを削除します。

カスタム変数の編集または削除方法

1. Zoomウェブポータルにサインインします。
2. ナビゲーションメニューで、[AI Studio] > [バーチャルエージェント] の順にクリックします。
3. [設定] タブ > [変数] の順にクリックします。
4. 左側パネルの [カスタム変数グループ] の下で、そのカスタム変数が属するカスタム変数グループを選択します。
5. 最後の列で省略記号（リーダー）アイコン をクリックし、次のオプションのいずれかをクリックします:
   • 編集: カスタム変数の設定を変更します。
   • 削除: カスタム変数を削除します。

カスタム変数の設定

• 変数名: カスタム変数を識別しやすくするための内部表示名を入力します。
• 説明（オプション）: カスタム変数の説明を入力します。
• 変数タイプ
  • グローバル変数: これはグローバルカスタム変数として自動的に設定されるため、任意のフローで使用できます。
• 条件
  • レポートで使用: チャットボットパフォーマンスダッシュボードで変数をフィルタリングするときに変数を表示させたい場合は、このチェックボックスを選択します。
    • レポートでのフィルターを有効化: レポートでこの変数をフィルタリングできるようにします。
  • 変数データをマスキング（機密情報用）: フローエディタで変数のデータをマスクするには、このチェックボックスを選択します。
    注: このオプションは、機密情報を含めることができるデータタイプ（たとえば、メールまたは電話、E.164データタイプ）でのみ利用可能です。
  • Zoom Phoneに転送された通話での表示を許可: 選択すると、エージェントがVirtual AgentからZoom Phoneに通話を転送するときに、発信者番号通知ID、エージェント情報、本人確認ステータス、会話の要約などの関連データがZoom Phoneユーザーと共有されます。
• データタイプ: カスタム変数のデータタイプを選択します。
  • 文字列: 文字の集合
  • 数値: 計算または数量の数値
  • ブール値: trueまたはfalseの2つの値
  • 配列: 順序付けられたリストに保存された、通常は同じデータタイプの値のコレクション
  • Json: データをキーと値のペアとして保存する構造化フォーマット
  • 日付 / 時間: 日付と時間情報を保存するフォーマット
  • 通貨: 金銭的価値の表現
  • パーセント: 値をパーセンテージとして表すフォーマット
  • メール: メールアドレスを保存して検証するためのデータタイプ
  • URL: ウェブアドレスを保存するフォーマット
  • 電話: 電話番号を保存して検証するためのデータタイプ
  • ボットカスタムエンティティ: チャットボットシステムにおけるユーザー定義のエンティティ
  • ボットシステムエンティティ: チャットボットシステムにおける定義済みのエンティティ
• 値: 次のオプションのいずれかを選択します。
  • 未定義: カスタム変数にデフォルト値はありません。
  • デフォルト値: カスタム変数のデフォルト値を指定します。値は、データタイプに対して必要なフォーマットである必要があります。
  • ウェブサイトデータから: フロントエンドのウェブサイトデータからコンシューマーデータをスクラップします。
    注: この機能には、ウェブ開発とJavaScriptの経験が必要です。ウェブサイトデータが正常にスクラップされる保証はなく、ウェブサイトへの変更はスクラップが成功するかどうかに影響を与える可能性があります。この設定に対する構成をテストし、維持する必要があります。
    • ソース: データソースを選択し、必須フィールドに入力します。
  • コンシューマー認証から: 这是認証されたウェブチャットおよびウェブビデオのコンシューマーに対してのみ機能します
    • コンシューマーデータ を入力します。

ボットフローエディタでのカスタム変数の使用方法

フローエディタの条件または変数を設定ウィジェットでカスタム変数を使用できます。

• [入力を収集ウィジェット] : [入力を収集] ドロップダウンメニューが [テキスト入力] に設定されている場合、スラッシュ（/）を使用して [プロンプトメッセージ] 内でカスタム変数を参照できます。例: /variable「/」を入力すると、利用可能な変数のドロップダウンが表示されます。
• [条件ウィジェット] : [変数] 設定を使用してカスタム変数を選択し、変数の条件に基づいて終了設定をカスタマイズできます。
• [HTTP呼び出しウィジェット] : 二重の波括弧を使用して、[本文] フィールド内でカスタム変数を参照できます。例: { {変数}}のようにします。
• [ルーティング先ウィジェット] : 変数に基づいて、キューにルーティング したり、発信通話を行ったり できます。
• [変数を設定ウィジェット] : [変数] 設定を使用してカスタム変数を選択できます。

グローバルシステム変数の表示方法

フロー間でデータを渡すために使用できるデフォルトの変数であるシステム変数を表示することもできます。システム変数の設定を変更することはできません。

1. Zoomウェブポータルにサインインします。
2. ナビゲーションメニューで、[AI Studio] > [バーチャルエージェント] の順にクリックします。
3. [設定] タブ > [変数] の順にクリックします。
4. 左側パネルの [システム変数グループ] の下で、デフォルトのシステム変数を表示するグループを選択します。