---
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) 所要時間：2分

仮想エージェント API を使用すると、仮想エージェントとエージェントチャットで利用可能な同じ機能の多くをチャット環境に統合できます。機能のサポートは、ServiceNow リリースと API のストアアプリバージョン番号によって異なります。

仮想エージェント API の要求と応答テンプレートの詳細、および一般的なユースケースの例については、「[仮想エージェントボット統合 API](https://www.servicenow.com/docs/access?context=bot-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)」を参照してください。

## 主な機能 {#va-api-features__section_yps_1fc_qmb}

バージョン 1.0.9 以降の仮想エージェント API の主な機能は次のとおりです。

* 静的認証、ハッシュ認証、およびトークンベース認証を使用したプロバイダー認証
* パーソナライズされたエクスペリエンスのための、ServiceNow アカウントへのユーザー ID の自動リンク
* エージェントチャットでのライブエージェントへの仮想エージェントの転送
* 次の戦略によるボット間の統合におけるインテント分類：
  * プライマリボットはユーザーのインテントを決定し、対応するトピックがユーザーに表示されるように、ユーザー要求を仮想エージェントに送信します。
  * プライマリボットは、インテントを検出して予測信頼スコアを返すことができるように、ユーザーの発言を仮想エージェントに送信します。信頼スコアが高いほど、予測されたトピックがユーザーの発言とより正確に一致していることを示します。
  {#va-api-features__ul_n2c_nfc_qmb}
{#va-api-features__ul_y2x_cfc_qmb}

## バージョン 1.0.12 の機能 {#va-api-features__section_fxf_22h_kqb}

[アイドル状態のボット間会話を自動的に終了](https://servicenow-prod.fluidtopics.net/04cfQbPjiR5L~8rMzsEbgQ "ボット間の統合 (仮想エージェント API) では、1 時間を超えて「アイドル」状態になっている破棄された会話は、スケジュール済みジョブ [Time Out Abandoned B2B Conversations] によって自動的に終了されます。このジョブは毎日 1 時間ごとに実行されます。")
:   アイドル状態が 1 時間を超えている会話を自動的に終了することができます。\[Time Out Abandoned B2B Conversations\] ジョブは毎日 1 時間ごとに実行され、要求者が破棄したアイドル状態の会話を自動的に終了します。

[仮想エージェントインタラクションレコードの会話進捗状況と理由コード](https://servicenow-prod.fluidtopics.net/P5Xqji70SlUrCvIzi~7FSg "仮想エージェント の会話が発生するたびに、インタラクションレコードは、インタラクション [interaction] テーブルで会話全体をキャプチャします。レコードには、会話で使用されるすべてのトピック要素と、ライブエージェントの転送が含まれます。")
:   ユーザーまたはプライマリボットが会話を終了すると、仮想エージェントはステータスコードと理由コードをインタラクションレコードに記録します。たとえば、エンドユーザーは「End」と入力して会話を停止するか、\[X\] ボタンをクリックしてチャットを閉じることができます。

会話の終了時に通知
:   仮想エージェントまたはエージェントチャットの会話が終了すると、プライマリボットに通知されます。プライマリボットが会話を制御する必要がある場合にも、プライマリボットに通知されます。仮想エージェントは次のフラグを使用します。

    * completed：仮想エージェントまたはライブエージェントとの会話が終了したときに送信されます。
    * takeControl：プライマリボットが制御する必要がある場合に送信されます。これは通常、仮想エージェントが 2 回連続して試行した後に会話のインテントを判断できない場合に発生します (デフォルト値)。va.bot.to.bot.take.control_times システムプロパティを追加して、仮想エージェントが会話インテントを決定しようと試みるデフォルトの試行回数を変更できます。

    {#va-api-features__ul_dqs_51h_kqb}

    詳細については、「[仮想エージェントボット統合 API](https://www.servicenow.com/docs/access?context=bot-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)」を参照してください。

インテントによる変更
:
    * 仮想エージェントで NLU が有効になっている場合は、インテント一致の NLU 信頼スコアを共有します。
    * エンドユーザーがプライマリボットによるインテント一致に基づいてトピックに直接ジャンプできるようにします。
    {#va-api-features__ul_gbx_mz3_kqb}

## バージョン 1.3.0 の機能 {#va-api-features__section_aj4_22h_kqb}

バージョン 1.3.0 以降、仮想エージェント API はシステムプロパティ (va.bot.to.bot.logging_enabled) としてのログ記録をサポートしています。