ガイド内の変数

前提条件 
  • 仮想エージェントが有効組織内で。詳細については、担当のカスタマーサクセスマネージャーにお問い合わせください。 。
  • ガイド用の AI Studio 権限。必要な権限の詳細については、以下を参照してください。 AI Studioの権限。 

ガイド変数を使用すると、AI エージェントは会話中に Architect フローにデータを送信したり、Architect フローからデータを受信したりできるため、顧客とのやり取りがより動的になります。ガイド内の変数を使用すると、Virtual Agent で有効化された Architect フローとガイド間のスムーズな移行が可能になり、ユーザーにクエリを繰り返すように要求することなく会話を継続できます。

ガイド変数を作成する

  • Architect フローと情報を交換する必要がある場合にのみ変数を作成します。ガイド内のステップ間で参照を使用するには、変数ではなくプレーンテキストを使用することを検討してください。
  • Architect にデータを送信したり、Architect からデータを受信したりする場合を除き、データ アクション パラメータの変数を作成しないでください。ガイドでデータアクションパラメータを使用するには、パラメータの正確な名前を指定します。例:new_delivery_date 。データアクションを使用してガイドを外部サービスに接続する方法の詳細については、以下を参照してください。データアクションを使用してガイドを外部サービスに接続する。

  1. 管理をクリックします。
  2. AI Studioの下でクリックガイド。 
  3. 既存のガイドを開くか、新しいガイドを作成します。
  4. 開く変数タブをクリックして作成する。変数の作成パネルが開きます。
  5. 「変数の作成」で、次の操作を行います。
    1. の中で名前フィールドに変数名を入力します。
      注記：変数名の最大長は 80 文字です。
    2. からデータ型ドロップダウン リストで、次のいずれかのデータ型を選択します。
      • 弦：これは標準のテキスト文字列です。
      • ブール値：ブール値は、true または false のいずれか 1 つの値のみを持つことができます。
      • 番号：数値には、小数点を含むあらゆる数値が含まれます。
      • 整数：整数は 987 や 5 などの整数です。
        注記：データ型が意図した値と正しく一致していることを確認します。これにより、LLM による情報の識別と収集の精度が向上します。
         
    3. （オプション）説明テキスト ボックスに、説明と簡単な例を入力します。たとえば、ポリシー番号は「XXX-####-YY##」という形式の一意の識別子です。 
    4. から可用性ドロップダウン リストで、適切なデータ転送方向を選択します。 
      • 入力：これを使用して、Architect フローにデータを送信します。 
      • 出力：Architect フローからデータを受信するためにこれを使用します。 
      • 入力と出力：これを使用して、Architect フローにデータを送信したり、Architect フローからデータを受信したりします。
  6. クリック作成する。この変数をガイドで使用できるようになりました。

    変数を使用する

    1. 既存のガイドを開くか、新しいガイドを作成します。
    2. の中で説明書タブで、変数を挿入する場所にカーソルを置き、「/」と入力します。 
      データ アクションまたは変数を挿入するためのオプションを示すポップアップ ダイアログ ボックスが表示されます。
    3. 選択変数。ダイアログ ボックスに使用可能な変数が一覧表示されます。 
    4. 必要な変数を選択します。エディターは、ガイド内に存在する変数を緑の下線で強調表示します。
    5. クリック保存ガイドを保存するか、公開ガイドを公開します。
      メモ: 
      • ガイドが下書きモードの間は、必要に応じてガイド変数を変更できます。ガイドを公開した後は、既存の変数の名前、タイプ、または可用性を変更することはできませんが、新しい変数を追加することはできます。
      • 1 つのガイドに含めることができる変数の最大数は 5 です。