--- sourceDocument: Yokohama 対話型インターフェース sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/conversational-interfaces Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama 対話型インターフェース ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # 仮想エージェント API を使用しています # 仮想エージェント API を使用しています {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分 ServiceNow® 仮想エージェントAPI アプリを使用して、任意のチャットインターフェイスま\]たはボットを ServiceNow® 仮想エージェントまたはエージェントチャットと統合します。このアプリは ServiceNow® Store から入手できます。 ## 仮想エージェント APIの概要 {#virtual-agent-api__section_cxx_ldc_qmb} 仮想エージェント API は REST API です。この API は、Paris リリースから仮想エージェントで提供される会話型カスタムチャット統合フレームワークに基づいてビルドされています。API を使用すると、ServiceNow 開発者、上級ユーザー、およびアドミニストレーターは、次のいずれかの方法で仮想エージェントを使用できます。 スタンドアロンボット : 仮想エージェントを、エンタープライズと、または対話型インターフェースをサポートする他のサードパーティチャットインターフェイスと統合するスタンドアロンボットとして使用します。 エンドユーザーは、この統合を使用して、複数のチャネルを通じて仮想エージェントおよびエージェントチャットとやり取りできます。 セカンダリボット : プライマリボットにより複数の特殊なボットが管理されている環境では、仮想エージェントをセカンダリボットとして使用します。 このシナリオでは、プライマリボットがエンドユーザーに代わってセカンダリボットとの通信を管理します。プライマリボットは、IBM Watson Assistant、Microsoft LUIS、または自家製のプライマリボットなどです。 ServiceNow ボットなどのセカンダリボットは、サービスチケットや予約など、特定のタイプのエンドユーザー要求を処理する場合があります。 ボットインターコネクト : 多様なチャット環境でプライマリボットとして 仮想エージェント ボットインターコネクト を使用します。ボットインターコネクト は統一されたチャットエクスペリエンスを作成し、ServiceNow から利用可能な複数のチャネルとさまざまなエンタープライズタスクにエンドユーザーがアクセスできるようにします。 仮想エージェント API は、サーバー間の統合を作成する場合に便利です。ただし、既存のチャットインターフェイスでレンダリングする必要がある、サポートされていないコントロールの変換が必要な統合の場合は、[カスタムチャット統合フレームワーク](https://servicenow-prod.fluidtopics.net/YXa7k81i0uRnsdlHHYfg1Q "会話型カスタムチャット統合フレームワークは、ServiceNow 仮想エージェントを任意の対話型インターフェースに表示するためのスクリプト可能な API と構成で構成される強力なフレームワークです。")の使用を検討してください。 仮想エージェント API の URL 形式や、サポートされている要求および応答パラメーターなどの機能の詳細については、「[仮想エージェントボット統合 API](https://www.servicenow.com/docs/access?context=bot-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)」を参照してください。 ![仮想エージェントアカデミーへのビデオリンク。]()[仮想エージェント API を使用してエクスペリエンスを向上させる](https://www.youtube.com/watch?v=cyhmMyG4jKk) (仮想エージェントアカデミーのビデオ) ## 仮想エージェント API の仕組み {#virtual-agent-api__section_ivs_d2r_fnb} 次の図は、REST API がどのようにサードパーティチャットインターフェイスまたはプライマリボットからのユーザー入力を処理し、ボット応答を生成するかを示しています。 1. ユーザーは、プライマリボットまたはサードパーティのチャットインターフェイスに入力します。 2. ボットは、POST 要求の JSON を (スクリプト化された REST API を介して) 受信 REST エンドポイントに送信します。 3. Now Platform は、仮想エージェント またはライブエージェントに 送信される要求を認証して処理します。 4. Now Platform は、送信 REST エンドポイントから (REST API を介して) POST 応答 JSON をボットに送り返します。 5. プライマリボットまたはサードパーティのチャットインターフェイスに、ユーザーへの応答が表示されます。 {#virtual-agent-api__ol_pwf_jqc_kyb} 図 : 1. 仮想エージェント API の受信および送信 REST エンドポイント 仮想エージェント API のデモンストレーションと FAQ を確認するには、Community サイトの「[仮想エージェント API 入門 (Getting Started with Virtual Agent APIs)](https://community.servicenow.com/community?id=community_article&sys_id=080e3903dbc4e4107d3e02d5ca96198c)」を参照してください。 ## 制限事項 {#virtual-agent-api__section_xqy_r1l_2qb} 仮想エージェント API は、次の機能をサポートしていません。 * この仮想エージェント API 統合によるチャットの自社用カスタム設定 {#virtual-agent-api__ul_yqy_r1l_2qb} ## バージョンとリリースの互換性 {#virtual-agent-api__section_t11_5zb_dqb} {#virtual-agent-api__table_syv_gzb_dqb__entry__2} | バージョン | 互換リリース | |-|-| | 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 | [表 : 1. 仮想エージェント API のバージョンとリリースの互換性] {#virtual-agent-api__table_syv_gzb_dqb} 注: 仮想エージェント API には、仮想エージェント と同様の Pro ライセンスが必要です。 * **[仮想エージェント API 機能](https://servicenow-prod.fluidtopics.net/uGJ_~EvsU9nUvt1OcNQvOQ)** 仮想エージェント API を使用すると、仮想エージェントとエージェントチャットで利用可能な同じ機能の多くをチャット環境に統合できます。機能のサポートは、ServiceNow リリースと API のストアアプリバージョン番号によって異なります。 * **[ストアリリース 2.0.x で利用可能な仮想エージェント API 機能](https://servicenow-prod.fluidtopics.net/zBrhknS_gxlrTnCi_gYtpA#va-api-features-v2)** 仮想エージェント API バージョン 2.0.x では、仮想エージェントおよびエージェントチャットで利用可能な同じ機能の多くにアクセスできます。これには、リッチコントロールのサポートや通知が含まれます。 * **[ストアリリース 3.0.x で利用可能な仮想エージェント API 機能](https://servicenow-prod.fluidtopics.net/2BqwMTO0N4ljizhf0Udcsw#va-api-features-v3)** 仮想エージェント API バージョン 3.0.x では、仮想エージェントおよびエージェントチャットで利用可能な同じ機能の多くにアクセスできます。これには、プライベート URL からファイルをアップロードする機能や同期ハンドシェイクの機能拡張などが含まれます。 * **[仮想エージェント API のインストール](https://servicenow-prod.fluidtopics.net/L_tJ2PTF~1qrNY~MXvMvaA)** 仮想エージェント API アプリをインストールして、任意のチャットインターフェイスまたはボットを ServiceNow® 仮想エージェントまたはエージェントチャットと統合します。 * **[受信 REST エンドポイントの確認と受信認証の構成](https://servicenow-prod.fluidtopics.net/I0wD3oDDlyqszTkpZOv0NA)** 仮想エージェント API をインストールした後、スクリプト化された REST API リソースに移動してエンドポイントを確認し、認証を設定します。 * **[受信通信用のメッセージ認証の設定](https://servicenow-prod.fluidtopics.net/zf2NIGFCCICwt36TdVM7HQ)** 基本認証または OAuth 認証の代わりに仮想エージェント API のメッセージ認証を設定できます。メッセージ認証には、静的トークンまたはハッシュトークンの設定、プロバイダー認証の設定、およびチャネル ID の設定が含まれます。 * **[仮想エージェント API の出力応答 REST エンドポイントと送信認証の構成](https://servicenow-prod.fluidtopics.net/RlMm~gQ2VgiahFc3Yq11yg)** 仮想エージェント応答の投稿先となる送信エンドポイント URL を指定します。送信認証を構成します。 * **[仮想エージェントのボット間の統合](https://servicenow-prod.fluidtopics.net/RvWsmdF0D2P8lFQno~MHrw)** 仮想エージェント API は、複数のボットを使用する環境をサポートしています。この状況では、プライマリボットはサードパーティのセカンダリボット (ServiceNow ボットなど) と通信します。 * **[アイドル状態のボット間会話の終結](https://servicenow-prod.fluidtopics.net/04cfQbPjiR5L~8rMzsEbgQ)** ボット間の統合 (仮想エージェント API) では、1 時間を超えて「アイドル」状態になっている破棄された会話は、スケジュール済みジョブ \[Time Out Abandoned B2B Conversations\] によって自動的に終了されます。このジョブは毎日 1 時間ごとに実行されます。 * **[複数のプロバイダーアプリケーションの構成](https://servicenow-prod.fluidtopics.net/KEpz0hrXPt9ZilpxsUt80g)** 複数のプロバイダーアプリケーションを構成して、 仮想エージェント API を使用する複数のプライマリボットがあり、それらを区別する必要がある AI エージェントをサポートできます。 * **[仮想エージェント API の要求と応答の変換](https://servicenow-prod.fluidtopics.net/OkULnDhQVZrF65MK0NuyTw)** 仮想エージェント API で提供されるスクリプト化された拡張ポイントを通じて、仮想エージェント API の要求と応答をサポートされている形式に変換できます。 * **[仮想エージェント API での Now Assistエクスペリエンスの有効化](https://servicenow-prod.fluidtopics.net/AG~BxmHfAMfmK1rWAdN9IQ)** 仮想エージェント API で Now Assist エクスペリエンスを有効にして、複数のプロバイダーチャネルで生成 AI スキルをサポートします。