watsonx Assistant に関する FAQ
よくある質問に対する回答と、よくある問題の簡単な解決方法を紹介します。
watsonx Assistant に関する FAQ
watsonx Assistant とは何ですか?
IBM® watsonx™ Assistant は、バーチャル・アシスタントを構築、公開、改善するための改良された方法である。 会話を作成するには、アクションを使用します。 アクションは、誰でも簡単にアシスタントを作成できる方法です。 詳しくは、 入門ガイド または 資料 を参照してください。
watsonx Assistantでクラシック・エクスペリエンスを使用して作成したアシスタントが表示されないのはなぜですか?
IBM® watsonx™ Assistant は、あなたのクラシック体験と同じ インスタンスで、まっさらな状態である。 IBM Cloud 一方のエクスペリエンスで作成したアシスタントは、もう一方のエクスペリエンスでは表示されません。 ただし、作業が失われることなくエクスペリエンスを切り替えることができます。 詳しくは、 watsonx Assistant とクラシック・エクスペリエンスの切り替え を参照してください。
クラシック・エクスペリエンスと watsonx Assistant を切り替えるとどうなりますか?
一方の経験で作り上げたアシスタントは、もう一方の経験には引き継がれない。 ただし、エクスペリエンスを切り替えたり、作業に戻ったり、アシスタントを作成/使用したりすることはできます。 乗り換えても何も損はしない。 経験を変更しても、同じインスタンスの他のユーザーには影響しない。 詳しくは、 watsonx Assistant とクラシック・エクスペリエンスの切り替え を参照してください。
クラシック・エクスペリエンスはまだ使用可能ですか?
IBM はクラシックな体験を打ち切る予定はない。 しかし、 watsonx Assistant の利点と機能をぜひお試しください。 詳しくは、 入門ガイドを参照してください。 watsonx Assistantでダイアログを引き続き使用することもできます。 詳しくは、watsonx Assistantへのマイグレーションを参照してください。
watsonx Assistant、検索スキルとチャンネル統合はどこにあるのか?
左側のナビゲーションで**「統合」** をクリックします。 「統合」ページでは、検索、チャネル、および拡張機能の統合をアシスタントに追加できます。 詳しくは、統合の追加を参照してください。
新しい製品エクスペリエンスでは、アシスタント ID はどこにありますか?
アシスタント ID は、 アシスタント設定にあります。
アシスタント設定では、アシスタント ID は 「アシスタント ID と API の詳細 (Assistant IDs and API details)」 セクションにあります。
ログインできない理由は?
サービス・インスタンスにログインできなかったり、 unable to fetch access token
や 400 bad request - header or cookie too large
などのトークンに関するメッセージが表示されたりする場合は、ブラウザのキャッシュをクリアする必要がある可能性があります。 プライベート・ブラウザー・ウィンドウを開いてから、もう一度試してください。
- プライベートブラウジングウィンドウで問題が解決する場合は、常にプライベートウィンドウを使用するか、ブラウザのキャッシュをクリアすることを検討してください。 ブラウザーのプライバシーとセキュリティーの設定には、一般的に、キャッシュをクリアしたり Cookie を削除したりするオプションがあります。
- プライベート・ブラウジング・ウィンドウで問題が解決しない場合は、インスタンスのAPIキーを削除し、新しいものを作成してみてください。
繰り返しログインを要求される理由は?
「you are getting redirected to login
」のようなメッセージが続く場合は、以下のいずれかが原因となっている可能性があります。
- ご利用中のライトプランの有効期限が切れました。 ライト・プランは 30 日間使用しないと失効します。 再び開始するには、IBM Cloud にログインし、watsonx Assistant の新規サービス・インスタンスを作成します。
- その月のプランの制限を超えると、インスタンスがロックされます。 ログインを正常に行うには、プランの制限の合計がリセットされる翌月の開始日まで待ってください。
「分析」ページが表示されない理由は?
**「分析」**ページを表示するには、サービス役割「マネージャー」と、最低でもプラットフォーム役割「ビューアー」が必要です。 アクセス役割、およびアクセス役割の要求を変更する方法について詳しくは、リソースに対するアクセス権限の管理を参照してください。
API 詳細、API キー、サービス資格情報を表示できない理由は?
API の詳細やサービス資格情報を表示できない場合は、そのリソースが作成されているサービス・インスタンスに対する管理者権限を持っていない可能性があります。 サービス資格情報を使用できるのは、インスタンスに対してマネージャー権限を持つユーザーのみです。
カスタム拡張のタイムアウト・パラメーターを構成できますか?
いいえ。カスタム拡張のタイムアウト値は構成できません。 外部APIへの呼び出しは48秒以内に完了しなければならない。
インテント、エンティティ、ダイアログノードが編集できません
ダイアログを編集するには、サービスインスタンスへのWriterサービスアクセスと、少なくともViewerのプラットフォームロールが必要です。 アクセス役割、およびアクセス役割の要求を変更する方法について詳しくは、リソースに対するアクセス権限の管理を参照してください。
「分析 (Analytics)」ページからユーザー会話をエクスポートすることはできますか?
会話ページから会話を直接はエクスポートできません。 しかし、 /logs
APIを使用すると、ユーザーとアシスタントの間で発生した会話のトランスクリプトからイベントをリストアップすることができます。 詳細については、 V2 APIリファレンスを参照のこと。 あるいは、 Python スクリプトを使用してログをエクスポートすることもできます。
詳しくは、 export_logs_pyを参照してください。
ダイアログ・ノードをエクスポートおよびインポートすることはできますか?
いいえ。製品ユーザー・インターフェースからダイアログ・ノードをエクスポートおよびインポートすることはできません。
あるダイアログから別のダイアログにダイアログノードをコピーしたい場合は、以下の手順に従ってください:
- ダイアログノードをコピーしたいダイアログと、ノードをコピーしたいダイアログの両方をJSONファイルとしてダウンロードします。
- テキストエディタで、ダイアログノードをコピーしたいダイアログのJSONファイルを開きます。
dialog_nodes
配列を見つけてコピーします。- テキスト・エディターで、ダイアログ・ノードのコピー先となるダイアログ・スキルの JSON ファイルを開き、
dialog_nodes
配列を貼り付けます。 - 前のステップで編集した JSON ファイルをインポートして、必要なダイアログ・ノードで新しいダイアログ・スキルを作成します。
削除されたダイアログを復元することは可能ですか?
不用意な削除による問題を防ぐため、定期的にデータをバックアップする。 バックアップがない場合、削除されたダイアログを復元できる可能性があります。 削除された直後に、サポートで Case を開き、データをリカバリーできるかどうか確認してください。 Case には以下の情報を含めてください。
- スキルID
- インスタンス ID または名前
- ダイアログが削除されたサービスインスタンスがホストされているリージョン
プランをライト・プランに変更できますか?
いいえ、エンタープライズプランまたはプラスプランからライトプランへの変更はできません。
watsonx Assistant のライト・プラン・インスタンスはいくつ作成できますか?
watsonx Assistant の Lite プランインスタンスは、リソースグループごとに 1 つだけ持つことができます。
ログ・ファイルはどのくらいの期間保持されますか?
メッセージの保持期間は、サービス・プランに応じて異なります。 詳しくは、ログの制限を参照してください。
Web フックを作成するにはどうすればいいですか?
Webhook を定義してその詳細を追加するには、「稼働環境 (Live environment)」 ページに移動して**「環境設定」**ページを開きます。 **「環境設定」ページで「Webhook」>「プリメッセージ Webhook (Pre-message webhook)」**をクリックします。 Webhook に関する詳細を追加できます。 詳しくは、メッセージを処理する前に呼び出しを行うを参照してください。
Web フックの URL フィールドに複数の項目を作成することはできますか?
いいえ。1 つのアクションに定義できる Webhook URL は 1 つのみです。 詳しくは、Web フックの定義を参照してください。
Web フックの時間制限は延長できますか?
いいえ Webhook から呼び出すサービスは、8 秒以内に応答を返す必要があります。そうしないと、呼び出しは取り消されます。 この時間制限は延長できません。
Web フックによって使用されている IP アドレスの範囲はありますか?
残念ながら、 watsonx Assistant がウェブフック( URL )を呼び出すIPアドレスの範囲は変更される可能性があるため、静的ファイアウォール構成では使用できない。 httpsトランスポートを使用し、ウェブフックへのアクセスを制御するために認可ヘッダーを指定します。
ダイアログをインポートしたときに「クエリーがキャンセルされました (Query cancelled)」というメッセージが表示されるのはなぜですか?
このメッセージは、ダイアログノードやシノニムなどのダイアログ内のアーティファクトがプランの制限を超えたためにダイアログのインポートが停止した場合に表示されます。
ダイアログのサイズが原因でタイムアウトが発生したが、プランの制限を超えていない場合は、インポートされるエレメントの数を減らすことができます。
- インポートしようとしている JSON ファイルのコピーを作成します。
- エディターで JSON ファイルのコピーを開き、
entities
配列を削除します。 - 編集した JSON ファイルを新しいスキルとしてインポートします。
- この手順を正常に実行し終えたら、JSON ファイルの元のコピーを編集します。
dialog_nodes
、intents
、およびcounterexamples
の各配列を削除します。- API を使用してスキルを更新します。 以下の例に示すように、ワークスペース ID と
append=true
フラグを必ず含めてください。
curl -X POST -H "content-type: application/json" -H "accept: application/json" -u "apikey:{apikey}" -d@./skill.json "url/api/v1/workspaces/{workspace_id}?version=2019-02-28&append=true"
トレーニング・プロセスが停滞していると思われる場合にすることは?
もしトレーニングのプロセスが止まってしまったら、まず クラウドステータスのページでサービスが停止していないか確認してください。 新規トレーニング・プロセスを開始して、現在のプロセスを停止してから開始することができます。
watsonx Assistant で自分の月別アクティブ・ユーザーを確認する方法は?
月次アクティブ・ユーザー (MAU) を表示するには、以下の手順に従ってください。
- https://cloud.ibm.com にサインインします
- 管理] メニューをクリックし、[ 請求と使用状況 ]を選択します。
- **「使用量」**をクリックします。
- watsonx Assistant について**「プランの表示 (View Plans)」**を選択します。
- Time Frameで必要な月を選択します。
- プラス・プランまたはプラス・トライアル・プランを選択して、月次アクティブ・ユーザーと API 呼び出しを表示します。
エラー: 新しいオフ・トピックはサポートされていません
ダイアログの JSON ファイルを編集し、スキル言語を英語から別の言語に変更すると、エラー New Off Topic not supported
が表示されます。
この問題を解決するには、off_topic
を false
に設定して JSON ファイルを変更します。 この機能について詳しくは、無関係なものの定義を参照してください。
ユーザーが watsonx Assistantで使用している Web ブラウザーを確認できますか?
V2 API およびエンタープライズ・プランでは、セグメント拡張を使用して、メッセージの送信に使用されたブラウザーを確認できます。 詳しくは、「 セグメントへのイベントの送信」を参照してください。
スキルごとにインテントの数を増やすことはできますか
いいえ。スキルごとにインテントの数を増やすことはできません。