仮想エージェント API の使用

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:3分
  • ServiceNow® 仮想エージェントAPI アプリを使用して、任意のチャットインターフェイスま]たはボットを ServiceNow® 仮想エージェントまたはエージェントチャットと統合します。このアプリは ServiceNow® Store から入手できます。

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

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

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

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

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

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

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

    ボットインターコネクト
    多様なチャット環境でプライマリボットとして 仮想エージェント ボットインターコネクト を使用します。ボットインターコネクト は統一されたチャットエクスペリエンスを作成し、ServiceNow から利用可能な複数のチャネルとさまざまなエンタープライズタスクにエンドユーザーがアクセスできるようにします。

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

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

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

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

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

    仮想エージェント API のデモンストレーションと FAQ を確認するには、Community サイトの「仮想エージェント API 入門 (Getting Started with Virtual Agent APIs)」を参照してください。

    制限事項

    仮想エージェント API は、次の機能をサポートしていません。
    • この仮想エージェント API 統合によるチャットの自社用カスタム設定

    バージョンとリリースの互換性

    表 : 1. 仮想エージェント API のバージョンとリリースの互換性
    バージョン 互換リリース
    3.14.3 Yokohama
    3.14.2 Xanadu
    3.14.1 Xanadu
    3.10.0 Washington DC
    3.9.x Vancouver
    3.8.x Vancouver
    3.7.x Utah
    3.5.x Tokyo
    3.0.x San Diego
    2.0.x Rome

    機能のサブセットは Quebec と互換性があります。

    1.3.0 Quebec
    1.0.12 Quebec
    1.0.9 Paris
    注:
    仮想エージェント API には、仮想エージェント と同様の Pro ライセンスが必要です。