ガイド内の変数

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

ガイド変数を使用すると、AI エージェントはガイド内で情報を渡すことができます。たとえば、ガイド内のステップ間の参照を使用し、会話中に Architect フローとデータを交換することで、顧客とのやり取りをより動的にすることができます。

ガイド変数を作成する

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

変数の例と説明

変数 = を考えてみましょう変数名 + 説明 + データ型 [+ 入出力分類] 。AI エージェントが変数を正しく理解して使用できるように、変数には意味のある名前、明確な説明、適切なデータ型が必要です。

たとえば、予約番号をキャプチャする場合、SEQ_1 + 8 桁の数字 + 文字列は期待どおりに機能しない可能性があります。代わりに、Reservation_Number + 予約を識別する 8 桁の予約番号 + 数値の方が、AI エージェントに収集する必要がある内容に関するより多くのコンテキストを提供するため、パフォーマンスが向上します。

変数のデータ型がビジネスニーズに合っていることを確認します。

重要:プロンプト生成を使用する場合、ガイドは与えられたタスクを完了するための変数を作成します。ただし、変数の名前、説明、タイプがビジネス ニーズに一致していることを確認する必要があります。

たとえば、数値または文字列の予約コードを取得する場合は、仕様に応じて適切なデータ型を選択します。

  • 数値 – 12345
  • 文字列 – 1234Oct

文字列に対して変数の型が数値に設定されている場合、AI エージェントはそれを (顧客からの) 誤った情報として認識するため、ガイドはそれをキャプチャできません。

メモ: 
  • ガイドを公開して Architect フローに接続すると、変数はロックされ、その説明のみを更新できるようになります。変数のデータ型などに大きな変更を加える必要がある場合は、新しい変数を作成するか、変数を複製して編集する必要があります。
  • 変数を入力、出力、またはその両方として分類できます。ガイド内で使用される情報の方向は、入力または出力の両方、またはいずれか一方にすることができます。
    • 入力:ガイドに取り入れたい情報、またはガイドで使用したい情報を示します
    • 出力:ガイドに保存または送信する情報を示します
  • 文字列変数が特定のオプションのセットである場合は、説明または質問でそれらを指定することをお勧めします。オプションまたは値が設定されたリストから選択する必要があることを説明すると、AI エージェントは顧客にそのリストから選択するように促します。
  • 日付の形式が適切であることを確認してください。AI エージェントは、現在の日付を伝えなければ日付を認識しません。正確に把握できるように質問を調整または言い換えます。 
    • 特にその情報をデータ アクションに渡す場合は、説明に必要な日付形式を指定します。
    • 日付と通貨は顧客に再生されるときに、実行時の言語にローカライズされることを考慮してください。たとえば、ガイドをオーストラリアで使用する場合、LLM によって生成された通貨記号は AUD$ に変換されます。

さらにいくつかの例を挙げます。

  • company_type:会社の規模。たとえば、小規模、中規模、大規模のいずれかです。
  • incident_location:自動車保険の請求事件が発生した場所を、番地、市町村、都市の形式で指定します。
  • branch_location:顧客が訪問した支店の所在地は、ダブリン、ゴールウェイ、またはコークのみです。

    変数を使用する

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