仮想エージェント API の探索

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:3分
  • ServiceNow® 仮想エージェント API アプリを使用して、チャットインターフェイスまたはボットを ServiceNow® 仮想エージェント または エージェントチャット と統合します。アプリは ServiceNow® Store から利用できます。

    仮想エージェント APIの概要

    仮想エージェント API は REST API です。この API は、Paris リリース以降の仮想エージェントで提供される会話型カスタムチャット統合フレームワークに基づいて構築されています。API を使用すると、 ServiceNow 開発者、上級ユーザー、およびアドミニストレーターは、次のいずれかの方法で 仮想エージェント を使用できます。

    スタンドアロンボット
    仮想エージェント をスタンドアロンボットとして使用し、エンタープライズまたは会話型インターフェイスをサポートするその他のサードパーティチャットインターフェイスと統合します。

    エンドユーザーは、この統合を使用して、複数のチャネルを介して 仮想エージェントエージェントチャット とやり取りできます。

    セカンダリボット
    プライマリボットによって複数の特殊なボットが管理されている環境で、 仮想エージェント をセカンダリボットとして使用します。

    このシナリオでは、プライマリボットがエンドユーザーに代わってセカンダリボットとの通信を管理します。プライマリボットは、 IBM Watson Assistant または自家製のプライマリボットにすることができます。

    ServiceNowボットなどのセカンダリボットは、サービスチケットや予約など、特定のタイプのエンドユーザー要求を処理する場合があります。

    仮想エージェント API は、サーバー間の統合を作成するのに役立ちます。ただし、既存のチャットインターフェイスでレンダリングする必要がある、サポートされていないコントロールの変換が必要な統合の場合は、 カスタムチャット統合フレームワークの使用を検討してください。

    仮想エージェント API で URL 形式やサポートされている要求パラメーターと応答パラメーターなどの機能の詳細については、「仮想エージェントボット統合 API」を参照してください。

    仮想エージェントアカデミーへのビデオリンク。仮想エージェント API でエクスペリエンスを向上させる (仮想エージェントアカデミーのビデオ)

    仮想エージェント API の仕組み

    次の図は、REST API がサードパーティのチャットインターフェイスまたはプライマリボットからのユーザー入力を処理し、ボット応答を生成する方法を示しています。
    1. ユーザーは、プライマリボットまたはサードパーティのチャットインターフェイスに入力します。
    2. ボットは、(スクリプト化された REST API を介して) POST 要求の JSON を受信 REST エンドポイントに送信します。
    3. ServiceNow AI Platformは要求を認証して処理し、要求は仮想エージェントまたはライブエージェントに送信されます。
    4. ServiceNow AI Platformは、送信 REST エンドポイントから (REST API を介して) POST 応答 JSON をボットに送り返します。
    5. プライマリボットまたはサードパーティのチャットインターフェイスに、ユーザーへの応答が表示されます。
    図 : 1. 仮想エージェント API の受信および送信 REST エンドポイント
    仮想エージェント API の REST エンドポイントがユーザー入力と認証、およびボット応答と認証をどのように処理するかを示す図。

    仮想エージェント API のデモと FAQ を確認するには、コミュニティサイトの「仮想エージェント API の概要」を参照してください。

    制限事項

    仮想エージェント API は次の機能をサポートしていません。
    • この 仮想エージェント API 統合によるチャットのブランディング。
    • Now Assist 機能は非同期モードでのみサポートされています。