仮想エージェント API ストアリリース 4.0.x で利用可能な機能

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：4分

    • 仮想エージェント APIバージョン 4.0.x では、ServiceNow AI Platform® とサポートされているサードパーティのチャットアプリケーションとの間で拡張されたエージェントチャットエクスペリエンスを提供する機能など、仮想エージェント および エージェントチャット で利用可能な同じ機能の多くにアクセスできます。

    仮想エージェント API の要求と応答テンプレートの詳細、および一般的なユースケースの例については、「仮想エージェントボット統合 API」を参照してください。

    仮想エージェント API バージョン 4.0.0 の機能拡張

    • 仮想エージェント API ライブエージェントとプライマリボットの間のメッセージテキストとメッセージの配信ステータスを更新します。

    • 仮想エージェント API は、プライマリボットに応答してインタラクション ID とメッセージ ID (ライブエージェントとの会話の場合はエージェント ID) を送信します。

      インタラクションレコードには、エンドユーザーとの会話ごとに、サポートされているサードパーティのチャットアプリケーション (またはプライマリボット) によって送信された clientSessionId が保存されます。この動作は、次の構成によって制御されます。
      1. [すべて] に移動して、フィルターに「sys_cs_provider_application.list」と入力します。
      2. VA ボット間プロバイダーアプリケーションレコードを選択して開きます。
      3. [プロバイダーチャネル ID] フォームで、[ プロバイダー ID のプロパティ ] 関連リストを選択し、[ 新規] をクリックします。
      4. [カスタムアダプタプロパティ] フォームで、フィールドに入力します。
        表 : 1. [カスタムアダプタプロパティ] フォーム
        フィールド 説明
        名前 顧客アダプタプロパティの名前 ( third_party_chat など)。
        値 「true」と入力します。
        説明 このプロパティの説明を入力します。 サポートされているサードパーティアプリケーションによるクライアントセッションをインタラクションレコードに含めるカスタムアダプタプロパティ。
      5. [Submit (送信)] を選択します。
    • プライマリボットとエンドユーザーとの会話のチャット履歴には、個々のメッセージのタイムスタンプが含まれます。ライブエージェントは、このチャット履歴を個々のメッセージまたは単一のブロックで表示できるようになりました。この動作は、次の構成によって制御されます。
      1. [すべて] に移動して、フィルターに「sys_cs_provider_application.list」と入力します。
      2. VA ボット間プロバイダーアプリケーションレコードを選択して開きます。
      3. [プロバイダーチャネル ID] フォームで、[ プロバイダー ID のプロパティ ] 関連リストを選択し、[ 新規] をクリックします。
      4. [カスタムアダプタプロパティ] フォームで、フィールドに入力します。
        表 : 2. [カスタムアダプタプロパティ] フォーム
        フィールド 説明
        名前 顧客アダプタプロパティの名前 ( store_history_as など)。
        値 次のいずれかの入力を入力します。
        • マルチテキスト:チャット履歴は個々のメッセージに表示されます。
        • テキスト:チャット履歴は 1 つのブロックに表示されます。
        • html:チャット履歴は HTML で表示されます。
        説明 このプロパティの説明を入力します。 プライマリボットとエンドユーザー間のチャット履歴を拡張付きで表示するカスタムアダプタプロパティ。
      5. [Submit (送信)] を選択します。
    • プライマリボットのロゴを設定して、エージェントチャットインターフェイスをカスタマイズできます。この動作は、次の構成によって制御されます。
      1. [すべて] に移動し、フィルターに「live_profile.list」と入力します。
      2. [New (新規)] を選択します。
      3. [ライブプロファイルの新規レコード (Live Profile New Record)] フォームで、フィールドに入力します。
        表 : 3. ライブプロファイルフォーム
        フィールド 説明
        名前 ライブプロファイルの名前 ( ボットのロゴなど)。
        タイプ ライブプロファイルのタイプ。その他を入力します。
        ドキュメント ライブプロファイルに関連付けられたテーブル。
        1. 検索アイコン [検索] アイコンを選択します。
        2. [ドキュメントを選択] ダイアログボックスで、次の情報を指定します。
          • テーブル名: プロバイダーチャネル ID [sys_cs_provider_application] を選択します。
          • ドキュメント: ボットのプロバイダー アプリケーションを選択します。VA ボット間プロバイダーアプリケーションを選択します。
        3. [OK] を選択します。
        写真 ボットプロファイルの画像 (ロゴ)。
        簡単な説明 ライブプロファイルを説明するテキスト。
      4. [Update (更新)] をクリックします。

    詳細については、「仮想エージェントボット統合 API」を参照してください。