Assistant V2 API の IBM Watson Assistant チャット統合の構成

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：8分

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

    始める前に

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

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

    このタスクについて

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

    IBM Watson Assistant V2 API により、Web チャットクライアントが Watson Assistant のインテント曖昧性除去機能を使用できるようになります。これにより、インテント予測の誤判定を削減できる可能性があります。ユーザーの発言が曖昧な場合、IBM Watson Assistant はユーザーが意図する内容に一致する可能性が高い追加のインテントを提示します。たとえば、ユーザーの発言が「レストラン」の場合、IBM Watson Assistant は 「レストランの予約」や「レストランのレビュー」など、考えられる他のインテントを提示できます。

    手順

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

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

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

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

    3. [ダイアログ] に移動し、曖昧性除去機能を適用するノードを選択し、そのノードがインテント提案の 1 つである場合にユーザーに対して表示されるノードの概要を指定します。
      曖昧性除去のための代替インテント選択項目としてユーザーに表示される、ノードの目的の概要が示されているダイアログノード。オプションのノードサマリーが強調表示されます。
    4. 使用する ServiceNow インスタンスで、次のプラグインを有効にします。
      • Glide 仮想エージェント (com.glide.cs.chatbot) (まだ有効化されていない場合 (サブスクリプションが必要))
      • IBM Watson Assistant 統合 V2 プラグイン (com.glide.cs.ibm.watson.assistant.topicV2)
    5. 仮想エージェントデザイナーで、 IBM Watson Assistant V2 トピックを公開します。
      1. 移動先 すべて > 対話型インターフェース > 仮想エージェント > デザイナー.
      2. [トピック] ページで、IBM Watson Assistant V2 トピックを選択して [トピックのプロパティ] ページを開きます。
        このトピックの [キーワード] が IBM Watson Assistant V2 であることに注意してください。
      3. [トピックのプロパティ] ページで [公開] を選択して、仮想エージェント Web クライアントにトピックを展開します。
    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. 移動先 サービスポータル > Service Portal の構成.
      2. [デザイナー] を選択し、サービスポータルのランディングページを選択します。
      3. 仮想エージェントウィジェットを検索し、ウィジェットを枠で囲まれている領域にドラッグします。
        紫色のチャットアイコンが右下隅に表示されます。

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

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

        サービスポータルでのインスタンスの動作を構成しない場合は、チャット Web クライアントを開くときに sysparm_topicおよび sysparm_skip_load_history パラメーターを含むインスタンス URL を指定できます。例：https://<使用するインスタンスの 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. [保存] を選択します。
        サービスポータル [インスタンス] ダイアログボックスが開いているデザイナーページ。[仮想エージェントクライアント URL パラメーター (Virtual Agent Client URL Parameters)] フィールドが強調表示されています。
    11. 曖昧性除去機能がトピックに対して機能することをテストします。
      Watson Assistant スキルと少なくとも 2 つのダイアログノードで曖昧性除去が有効になっていることを確認してください。次の例で、仮想エージェントは、ユーザーが選択できる 4 つの追加インテントを提供します。
      図 : 1. 曖昧性除去機能が設定されているトピックの例
      仮想エージェント 曖昧性除去機能によって検出された追加のインテントを示す会話。