AI エージェントの作成と設定

詳細については、Webex AI Agent Studio 管理ガイドの 「スクリプト化された AI エージェントのセットアップ」 および 「自律型 AI エージェントのセットアップ」 セクションを参照してください。

フロー内で AI エージェントを構成する

AI エージェント ノードを使用して、コーパスまたはナレッジ ベースからの特定のクエリに回答できます。 マルチターン会話を有効にすることもできます。 AI エージェントは、フォローアップの質問をしたり、コンテキストを理解したり、パーソナライズされた応答を提供したりできます。

開始するには、AI エージェント ノードをビジュアル フロー ビルダーにドラッグ アンド ドロップするだけです。 このノードは、Webex AI Agent Studio 内で構成されたスクリプト化された自律型 AI エージェントを使用するのに役立ちます。

AI エージェントノードで入力変数と出力変数を構成する

AI エージェント ノードには 2 つのメソッドが含まれています。

• プロセス メッセージ: 選択したエージェントにユーザ メッセージを送信し、エージェントの応答を受け取ることができます。

• セッションを閉じる: AI エージェント内のセッションを閉じることができます。 特定のシナリオでは、既存の AI エージェント セッションを閉じて、新しいセッションを開始することが必要になる場合があります。 これは、AI エージェント ノード内の特定の方法を使用して実現できます。 たとえば、セッションが指定された期間非アクティブのままの場合、システムはリソースを最適化するためにセッションを自動的に閉じます。

1. プロセス メッセージ メソッドで、次の入力変数を構成します。

   • エージェント タイプ: フロー内で使用されるエージェントのタイプ (スクリプトまたは自律型など)。

   • エージェント: ユーザ メッセージを処理し、応答を取得するエージェント。

     アクセスできる AI エージェントは、Webex AI エージェント スタジオで確認できます。 Webex AI Agent Studio でユーザとエージェントを管理する方法の詳細については、 「ユーザ ロール」 を参照してください。

   • メッセージ: 選択された AI エージェントに送信された顧客からのメッセージを含む変数名

   • 言語: 選択した AI エージェントが多言語の場合、[言語] ドロップダウン リストで受信メッセージの言語を選択できます。 AI エージェント設定の言語に基づいてドロップダウン リストに情報を入力します。

     注: 単一言語のエージェントの場合、このドロップダウン リストは無効になります。

   • チャネル: システムが顧客のメッセージを受信するチャネルの名前。

   • ユーザ識別子: 選択したチャネルのユーザの一意の識別子を提供します。

   • カスタムパラメータ (オプション): 顧客に関する追加情報をキーと値のペアとして Webex AI Agent Studio に渡すことができます。 この情報はユーザのプロフィールと関連付けられ、後の会話に使用されます。 たとえば、ユーザが新規顧客であるか既存顧客であるかを指定できます。

     カスタム パラメータとして渡されたキーは、エージェント応答で ${consumerData.extra_params.<your_key>} としてアクセスできます。

     現在、カスタム パラメータは、デジタル チャネルを介したスクリプト化された AI エージェントに対してのみサポートされています。

   • メッセージパラメータ (オプション): 現在の交換に関する追加情報を、キーと値のペアとして Webex AI Agent Studio に渡すことができます。

     このメッセージは保存されず、次のエージェントの応答でのみ使用されます。 メッセージ パラメータとして渡されたキーは、エージェント応答で ${extra_params.<your_key>} としてアクセスできます。

2. プロセス メッセージ メソッドで次の出力変数を構成します。

   • テキストレスポンス: AI エージェント内で構成されたテキスト出力。他の種類のリッチ要素または特殊要素が存在しない場合にのみ機能します。 また、応答に複数のテキスト項目がある場合、最初のテキスト項目が返されます。

   • フルレスポンス: エージェントからの出力に含まれるすべてのリッチ要素と複数のメッセージを含む完全な応答。

   • データストア: エージェント内のすべてのユーザ定義セッション変数の JSON/dict

   • トランザクション ID : Webex AI Agent Studio のリクエストのトランザクション ID

   • セッション ID : Webex AI Agent Studio のセッション/会話 ID

   • 消費者 ID : Webex AI Agent Studio の顧客 ID

   • メッセージメタデータ: 設定されたエージェントからの現在の応答に関連付けられたメタデータ

   • SessionMetadata: 設定されたエージェントからの現在の応答のセッションに関連付けられたメタデータ

     現在、MessageMetadata と SessionMetadata は、デジタル チャネルを介したスクリプト化された AI エージェントに対してのみサポートされています。

   • ResponsePayload: Webex AI Agent Studio からの完全なレスポンスペイロード

3. Close Session メソッドで次の入力変数を構成します。

   • エージェント: ユーザ メッセージを処理し、応答を取得するエージェント。

     アクセスできる AI エージェントは、Webex AI エージェント スタジオで確認できます。 Webex AI Agent Studio でユーザとエージェントを管理する方法の詳細については、 「ユーザ ロール」を参照してください。

   • セッション ID: AI エージェント セッションを閉じます。 セッション ID は、プロセス メッセージ メソッドの出力変数として使用できます。

ノード結果

このノードの可能なノード結果のリストを表示できます。 編集 (鉛筆) アイコンを使用してノード ラベルをカスタマイズできます。 ノードは、ノードの結果に対応するノード エッジの 1 つを通って終了します。 各 AI エージェント ノードはノード結果に対応します。 ノード結果のリストを次に示します。

• エラー (赤): 次のことを示します。

  • onError: エージェントがメッセージで応答しなかった場合。

  • onInvalidCustomerID: 顧客識別子が欠落している場合。

  • onInvalidMessage: メッセージの値が欠落している場合。

• 成功 (緑): 次のことを示します。

  • onSuccess: エージェントがメッセージで応答したとき。

  • onAgentHandover: エージェントがエージェントへのハンドオーバー要求を発行したとき。

• タイムアウト (黄色/アンバー): 次のことを示します。

  • onTimeOut: エージェントが 15 秒以内に応答しなかった場合。