---
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


---

# 仮想エージェント と IBM Watson Assistant for Assistant V2 API の統合

# 仮想エージェント と IBM Watson Assistant for Assistant V2 API の統合 {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分

IBM Watson Assistant の Assistant V2 API を使用して作成されたダイアログスキル (会話) を実行できるように、IBM Watson Assistant チャット統合を構成します。V2 API を使用すると、 仮想エージェント チャットウィジェットは、Watson Assistant のインテント曖昧性除去機能を使用してトピックディスカバリーを改善するトピックを実行できます。

## 始める前に

注:  
仮想エージェント にNow Assistをインストールし、Now Assistトピックスキルをオンにすると仮想エージェントデザイナー、更新されたユーザーインターフェイスが利用可能になります。このコンテンツは、このスキルがアクティブ化されており、リストビューを表示できることを前提としています。このスキルがアクティブ化されていない場合は、従来の UI とトピックページが表示されます。詳細については、「[Virtual Agent Designer legacy topics page (仮想エージェントデザイナーの従来のトピックページ)](https://servicenow-prod.fluidtopics.net/GpSHVV9N1NIbiKqLjMXIpw "仮想エージェントデザイナーレガシーホームページには、インスタンスで利用可能なトピックのカードが一覧表示されます。")」を参照してください。

IBM Watson Assistant v2 API チャット統合を使用すると、チャットウィジェットはワークスペースではなくアシスタントと通信します。ワークスペースはダイアログスキルと呼ばれます。IBM Watson Assistant の詳細については、IBM Watson Assistant ドキュメントの「[v2 API への移行](https://cloud.ibm.com/docs/services/assistant?topic=assistant-api-migration&locale=en-us#overview)」を参照してください。

必要なロール：virtual_agent_admin または admin

## このタスクについて

この統合は、チャットウィジェットで仮想エージェントトピックとしてIBM Watson Assistantダイアログを実行します。自然言語理解 (NLU) (NLU) を有効にしたり、IBM Watson Assistant NLU を 仮想エージェント の NLU サービスプロバイダーとして設定したりする必要はありません。

IBM Watson Assistant V2 API を使用すると、チャット・ウィジェットで Watson Assistant インテントの曖昧性除去機能を使用できます。これにより、誤検出インテントの予測を減らすことができます。ユーザーの発言が曖昧な場合、IBM Watson Assistant はユーザーが意図する内容に一致する可能性が高い追加のインテントを提示します。たとえば、ユーザーの発言が「<kbd class="ph userinput">レストラン</kbd>」の場合、IBM Watson Assistant は 「<kbd class="ph userinput">レストランの予約</kbd>」や「<kbd class="ph userinput">レストランのレビュー</kbd>」など、考えられる他のインテントを提示できます。

## 手順

1. IBM Watson Assistant を構成します。
   1. 自分のアシスタントを作成して、ダイアログのスキルを追加します。  
      詳細については、IBM Watson Assistant ドキュメントの「[アシスタントの作成](https://cloud.ibm.com/docs/services/assistant?topic=assistant-assistant-add)」を 参照してください。
   2. \[リソースリスト (Resource list)\] ページで、チャット統合を設定するために必要な API キーと URL を見つけて記録します。  
   3. 縦に 3 つのドットアイコン \[ ![その他のアクション\] アイコン]() を選択し、\[ 設定\] を選択します。  
      * \[API の詳細\] タブを選択します。
      * \[Assistant の設定 (Assistant Settings)\] ページで、\[Assistant ID\] キーを見つけます。

      {#configure-watson-assistant-topicV2__ul_iyb_qn1_hlb}

      使用するダイアログスキルの
   {#configure-watson-assistant-topicV2__substeps_alx_zm1_hlb}
2. IBM Watson Assistant で曖昧性除去機能を有効にします (Premium および Plus のユーザーのみ)。  
   スキルごとに曖昧性除去機能を有効 (または無効) にできます。また、曖昧性除去メッセージと、エンドユーザーに対して表示する提案の数を指定することもできます。
   1. スキルにアクセスするには、スキルツリーアイコン スキル ![ツリーアイコン を選択します。]() パネル内。  
   2. 移動先 オプション曖昧さ回避 曖昧性除去を有効にし、曖昧性除去機能を設定します。  
      次の例は、設定できる曖昧性除去機能 (曖昧性除去メッセージ、エンドユーザーに対して表示される提案の数など) 示しています。

   {#configure-watson-assistant-topicV2__substeps_qpx_mt1_hlb}
3. \[ダイアログ\] に移動し、曖昧性除去機能を適用するノードを選択し、そのノードがインテント提案の 1 つである場合にユーザーに対して表示されるノードの概要を指定します。  
4. 使用する ServiceNow インスタンスで、次のプラグインを有効にします。  
   * Glide 仮想エージェント (com.glide.cs.chatbot) (まだ有効化されていない場合 (サブスクリプションが必要))
   * IBM Watson Assistant 統合 V2 プラグイン (com.glide.cs.ibm.watson.assistant.topicV2)
   {#configure-watson-assistant-topicV2__ul_kww_tgg_hlb}
5. 仮想エージェントデザイナーで、 IBM Watson Assistant V2 トピックを公開します。
   1. 移動先 対話型インターフェース仮想エージェントデザイナー をクリックし、 NLU/キーワード の切り替えを選択します。すべて対話型インターフェース仮想エージェントデザイナー.
   2. 仮想エージェントデザイナー ホームページで、IBM Watson Assistant V2 トピックを選択して \[トピックのプロパティ\] ページを開きます。  
      このトピックの \[キーワード\] が IBM Watson Assistant V2 であることに注意してください。
   3. \[トピックのプロパティ\] ページで \[ 公開 \] を選択して、トピックを 仮想エージェント チャットウィジェットに展開します。
   {#configure-watson-assistant-topicV2__substeps_gvk_v2g_hlb}
6. \[すべて\] に移動してから、フィルターに「<kbd class="ph userinput">sys_properties.list</kbd>」と入力します。
7. 次のプロパティを更新します。  
   * watson_assistant.v2.assistantID--- \[値\] フィールドに、アシスタントの Watson Assistant ID を入力し、\[更新\] をクリックします。

   * watson_assistant.v2.service_endpoint--- \[値\] フィールドで、既存の値を Watson Assistant URL に置き換え、\[更新\] を選択します。

     注:  
     \[値\] フィールドに、サービスインスタンスの URL のロケーション部分のみを指定できます。たとえば、IBM Watson サービスエンドポイントのベース URL が https://gateway.watsonplatform.net/assistant/api の場合、\[値\] フィールドにはサービスインスタンスのロケーション (<kbd class="ph userinput">gateway.watsonplatform.net</kbd>) のみを入力できます。

     Watson Assistant が Dallas 以外のデータセンター (Washington DC など) でホストされている場合、ベース URL は https://gateway-wdc.watsonplatform.net/assistant/api です。\[値\] フィールドに「<kbd class="ph userinput">gateway-wdc.watston.platform.net</kbd>」と入力します。
   {#configure-watson-assistant-topicV2__ul_djy_yck_hlb}
8. Watson Assistant API キーを IBM Watson Assistant プロファイルのパスワードとして設定します。
   1. \[すべて\] に移動し、フィルターに <kbd class="ph userinput">sys_auth_profile_basic.list</kbd> と入力します。
   2. IBM Watson Assistant プロファイルレコードを開きます。
   3. \[基本認証構成\] フォームの \[パスワード\] フィールドに Watson Assistant API キーを入力して、\[更新\] を選択します。  
   {#configure-watson-assistant-topicV2__substeps_jjt_z13_hlb}
9. 仮想エージェント (Web チャット) クライアントを サービスポータル に追加します。
   1. 移動先 サービスポータルサービスポータル構成.
   2. \[デザイナー\] を選択し、サービスポータルのランディングページを選択します。
   3. 仮想エージェントウィジェットを検索し、ウィジェットを枠で囲まれている領域にドラッグします。  
      紫色のチャットアイコンが右下隅に表示されます。

   {#configure-watson-assistant-topicV2__substeps_kdn_hmh_hlb}
10. 編集アイコン ![編集アイコン]()を選択して、仮想エージェント ウィジェットを構成します。チャットクライアントに渡される URL パラメーターを設定し、フローティングチャットボタンの色を変更します。
    1. \[仮想エージェントクライアントの URL パラメーター\] フィールドに sysparm_skip_load_history=true パラメーター (これにより、チャットクライアントにトピック履歴が表示されなくなります) と、実行する公開済みの IBM Watson Assistant V2 トピックの sys_id を指定した sysparm_topic パラメーターを入力します。  
       トピックの sys_id は、トピック \[sys_cs_topic\] テーブルにあります。

       インスタンスの動作を サービスポータル で構成しない場合は、チャットチャットウィジェットを開いたときに、 sysparm_topic パラメーターと sysparm_skip_load_history パラメーターを使用してインスタンス URL を指定できます。例：<kbd class="ph userinput">https://&lt;使用するインスタンスの URL&gt;$sn-va-web-client-app.do?sysparm_skip_load_history=true&amp;sysparm_topic=<var class="keyword varname">&lt;sys_id&gt;</var></kbd> (<var class="keyword varname">&lt;sys_id&gt;</var> は、公開された、実行対象の IBM Watson Assistant V2トピックの sys_id)。  
       重要:  
       `sysparm_topic` パラメーターは、サービスポータルのチャットクライアントに指定されたトピックをロードするか、IBM Watson Assistant のチャット統合 (com.glide.cs.ibm.watson.assistant.topic および com.glide.cs.ibm.watson.assistant.topicV2 プラグイン) を使用する場合にのみ使用してください。このパラメーターでは、ユーザーは新しい会話を開始したり、ライブエージェントに転送したりできません。また、コンテキストメニューも無効になり、他のサードパーティチャットクライアントはサポートされません。
    2. フローティングボタンの色を変更するには、\[フローティングボタンの色\] フィールドに新しい色 (RGB 16 進数形式) を入力します。
    3. \[保存\] をクリックします。  
    {#configure-watson-assistant-topicV2__substeps_fw3_1p3_hlb}
11. 曖昧性除去機能がトピックに対して機能することをテストします。  
    Watson Assistant スキルと少なくとも 2 つのダイアログノードで曖昧性除去が有効になっていることを確認してください。次の例で、仮想エージェントは、ユーザーが選択できる 4 つの追加インテントを提供します。  
    図 : 1. 曖昧性除去機能が設定されているトピックの例