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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：8分

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

    始める前に

    注:
    仮想エージェントにNow Assistをインストールし、Now Assistトピックスキルをオンにすると、更新されたアシスタントデザイナー資産ライブラリのユーザーインターフェイスを使用できます。このコンテンツは、このスキルがアクティブ化されており、リストビューを表示できることを前提としています。このスキルがアクティブ化されていない場合は、従来の UI とトピックページが表示されます。詳細については、「Virtual Agent Designer legacy topics page (仮想エージェントデザイナーの従来のトピックページ)」を参照してください。

    IBM Watson Assistant v2 API チャット統合を使用すると、チャットウィジェットはワークスペースではなくアシスタントと通信します。ワークスペースはダイアログスキルと呼ばれます。IBM Watson Assistantの詳細については、IBM Watson Assistant ドキュメントの「v2 API への移行」を参照してください。

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

    このタスクについて

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

    IBM Watson Assistant V2 API を使用すると、チャット・ウィジェットで Watson Assistant インテントの曖昧性除去機能を使用できます。これにより、誤検出インテントの予測を減らすことができます。ユーザーの発言が曖昧な場合、 IBM Watson Assistant ユーザーの真の意図により一致する可能性のある追加のインテントが提案されます。たとえば、ユーザーの発言が レストランである場合、 IBM Watson Assistant レストラン の予約 や レストランのレビューなど、考えられる他のインテントを提案できます。

    手順

    1. IBM Watson Assistant を構成します。
      1. アシスタントを作成し、ダイアログスキルを追加します。
        詳細については、IBM Watson Assistantドキュメントの「アシスタントの作成」を参照してください。
      2. [リソースリスト] ページで、チャット統合の設定に必要な API キーと URL を見つけて記録します。
        アシスタントの API キーと URL 値が表示されている IBM Watson Assistant の [リソースリスト] ページ。
      3. 縦に 3 つのドットアイコン [ その他のアクション] アイコン を選択し、[ 設定] を選択します。
        • [ API の詳細 (API details )] タブを選択します。
        • [アシスタント設定 (Assistant Settings)] ページで、 アシスタント ID キーを見つけます。

        IBM Watson Assistant 使用するダイアログスキルの設定。ここでは、API の詳細とアシスタント ID が強調表示されています。

    2. IBM Watson Assistant で曖昧性除去機能を有効にします (プレミアムおよびプラスのユーザーのみ)。
      スキルごとに曖昧性除去機能を有効 (または無効) にすることができます。また、曖昧性除去メッセージと、エンドユーザーに対して表示する提案の数を指定することもできます。
      1. スキルにアクセスするには、スキルツリーアイコン スキル ツリーアイコン を選択します。 パネル内。
        スキルツリーアイコンが強調表示された IBM Watson Assistant のアシスタントリスト。
      2. 移動先 オプション > 曖昧さ回避 曖昧性除去を有効にし、曖昧性除去機能を設定します。
        次の例は、設定できる曖昧性除去機能 (曖昧性除去メッセージ、エンドユーザーに対して表示する提案されたインテントの数など) を示しています。

        IBM Watson Assistant の曖昧さ回避フォーム。[曖昧性除去 (Disambiguation)] タブ、オン/オフの切り替え、曖昧性除去メッセージ、その他のメッセージ、および提案の最大値が強調表示されます。

    3. [ ダイアログ] に移動し、曖昧性除去機能を適用するノードを選択し、それがインテント提案の 1 つである場合にユーザーに表示されるノードの概要を提供します。
      曖昧性除去のための代替インテント選択肢としてユーザーに表示されるノードの目的の概要を含むダイアログノード。オプションのノードサマリーが強調表示されます。
    4. ServiceNowインスタンスで、次のプラグインを有効にします。
      • Glide 仮想エージェント (com.glide.cs.chatbot) (まだアクティブ化されていない場合) (サブスクリプションが必要)
      • IBM Watson Assistant Integration V2 プラグイン (com.glide.cs.ibm.watson.assistant.topicV2)
    5. 仮想エージェントデザイナー で、IBM Watson Assistant V2 トピックを公開します。
      1. 移動先 対話型インターフェース > 仮想エージェント > デザイナー をクリックし、 NLU/キーワード の切り替えを選択します。すべて > 対話型インターフェース > 仮想エージェント > デザイナー.
      2. 仮想エージェントデザイナー ホームページで、IBM Watson Assistant V2 トピックを選択して [トピックのプロパティ] ページを開きます。
        このトピックの キーワード が IBM Watson Assistant V2 であることに注意してください。
      3. [トピックのプロパティ] ページで [ 公開 ] を選択して、トピックを 仮想エージェント チャットウィジェットに展開します。
    6. [ すべて] に移動し、フィルターに 「sys_properties.list 」と入力します。
    7. 次のプロパティを更新します。

      • watson_assistant.v2.assistantID — 「値」 フィールドに、アシスタントの Watson Assistant ID を入力し、「 更新」を選択します。

        watson_assistant.v2.assistantID プロパティの [システムプロパティ] フォーム。Watson Assistant ID 値の例と [更新] ボタンが強調表示されています。

      • watson_assistant.v2.service_endpoint — 「値」 フィールドで、既存の値を Watson Assistant URL に置き換え、「 更新」を選択します。

        watson_assistant.v2.service_endpoint プロパティのフォーム。URL 値の例が表示され、[更新] ボタンが強調表示されています。
        注:
        [ 値] フィールドには、サービスインスタンス URL の場所部分のみを指定できます。たとえば、IBM Watson サービスエンドポイントのベース URL が https://gateway.watsonplatform.net/assistant/api の場合は、[値] フィールド gateway.watsonplatform.net サービスインスタンスの場所のみを入力できます。

        Watson Assistant が Dallas 以外のデータ・センター (Washington DC など) でホストされている場合、ベース URL は https://gateway-wdc.watsonplatform.net/assistant/api です。[値] フィールドに gateway-wdc.watston.platform.net を入力します。

    8. Watson Assistant API キーを IBM Watson Assistant プロファイルのパスワードとして設定します。
      1. [ すべて] に移動し、フィルターに「 sys_auth_profile_basic.list 」と入力します。
      2. IBM Watson Assistantプロファイルレコードを開きます。
      3. 「基本認証構成」フォームで、「 パスワード」 フィールドに Watson Assistant API キーを入力し、「 更新」を選択します。
        IBM Watson Assistant の基本認証構成[パスワード] フィールドと [更新] ボタンがハイライト表示されたプロファイル。
    9. 仮想エージェント (Web チャット) クライアントをサービスポータルに追加します。
      1. 移動先 サービスポータル > サービスポータル構成.
      2. [ デザイナー] を選択し、 サービスポータル のランディングページを選択します。
      3. 仮想エージェント ウィジェットを検索し、ウィジェットを輪郭付き領域にドラッグします。
        紫色のチャットアイコンが右下隅に表示されます。

        サービスポータル仮想エージェント サービスポータルウィジェット、デザインキャンバス、チャットアイコンが強調表示されたデザイナーページ。

    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 を指定できます。例:https://<Your instance URL>$sn-va-web-client-app.do?sysparm_skip_load_history=true&sysparm_topic=<sys_id> ここで<sys_id>は、実行する公開済み 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. [Save (保存)] を選択します。
        サービスポータル [インスタンス] ダイアログボックスが開いているデザイナーページ。[仮想エージェントクライアント URL パラメーター] フィールドが強調表示されます。
    11. 曖昧性除去機能がトピックに対して機能していることをテストします。
      Watson Assistant スキルと少なくとも 2 つのダイアログノードで曖昧性除去が有効になっていることを確認してください。次の例では、仮想エージェントは、ユーザーが選択できる 4 つの追加インテントを提供します。
      図 : 1. 曖昧性除去機能付きトピックの例
      仮想エージェント 曖昧性除去機能によって検出された追加のインテントを示す会話。