---
sourceDocument: Xanadu 対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/conversational-interfaces
Release :
- xanadu
ft:locale :
- ja-JP
ft:publication_title :
- Xanadu 対話型インターフェース
ft:clusterId :
- convint
bundleId :
- convint
workflow :
- Platform
---
# Assistant V2 API の IBM Watson Assistant チャット統合の構成
# Assistant V2 API の IBM Watson Assistant チャット統合の構成 {#ariaid-title1}
* リリースバージョン: 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 への移行](https://cloud.ibm.com/docs/services/assistant?topic=assistant-api-migration&locale=en-us#overview)」を参照してください。
必要なロール：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 ドキュメントの「[アシスタントの作成](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. 移動先 すべて対話型インターフェース仮想エージェントデザイナー.
2. \[トピック\] ページで、IBM Watson Assistant V2 トピックを選択して \[トピックのプロパティ\] ページを開きます。
このトピックの \[キーワード\] が IBM Watson Assistant V2 であることに注意してください。
3. \[トピックのプロパティ\] ページで \[公開\] を選択して、仮想エージェント Web クライアントにトピックを展開します。
{#configure-watson-assistant-topicV2__substeps_gvk_v2g_hlb}
6. \[すべて\] に移動してから、フィルターに「sys_properties.list」と入力します。
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 の場合、\[値\] フィールドにはサービスインスタンスのロケーション (gateway.watsonplatform.net) のみを入力できます。
Watson Assistant が Dallas 以外のデータセンター (Washington DC など) でホストされている場合、ベース URL は https://gateway-wdc.watsonplatform.net/assistant/api です。\[値\] フィールドに「gateway-wdc.watston.platform.net」と入力します。
{#configure-watson-assistant-topicV2__ul_djy_yck_hlb}
8. Watson Assistant API キーを IBM Watson Assistant プロファイルのパスワードとして設定します。
1. \[すべて\] に移動し、フィルターに sys_auth_profile_basic.list と入力します。
2. IBM Watson Assistant プロファイルレコードを開きます。
3. \[基本認証構成\] フォームの \[パスワード\] フィールドに Watson Assistant API キーを入力して、\[更新\] を選択します。
{#configure-watson-assistant-topicV2__substeps_jjt_z13_hlb}
9. 仮想エージェント (Web チャット) クライアントを サービスポータル に追加します。
1. 移動先 サービスポータルService Portal の構成.
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\] テーブルにあります。
サービスポータルでのインスタンスの動作を構成しない場合は、チャット 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. \[保存\] を選択します。
{#configure-watson-assistant-topicV2__substeps_fw3_1p3_hlb}
11. 曖昧性除去機能がトピックに対して機能することをテストします。
Watson Assistant スキルと少なくとも 2 つのダイアログノードで曖昧性除去が有効になっていることを確認してください。次の例で、仮想エージェントは、ユーザーが選択できる 4 つの追加インテントを提供します。
図 : 1. 曖昧性除去機能が設定されているトピックの例