Now Assist パネル (NAP) トラブルシューティングガイド:一般的な問題とソリューション (翻訳)

[naoto kadowaki]

本稿はこちらの記事の翻訳です。最新の情報は元となる記事をご覧ください。
このトピックの一部は機械翻訳で処理されている場合があります。

この包括的なガイドは、コミュニティでの頻繁なディスカッションと ServiceNow サポートケースに基づいて、最も一般的な Now Assist パネルの問題に対処し、それらを解決するためのステップバイステップのソリューションを提供します。

問題 #1:Now Assist パネルをオンにできない。 ([オンにする] ボタンが非アクティブ化されている。)

問題の説明

ユーザーが Now Assist アドミンコンソールで Now Assist エクスペリエンスに移動すると、Now Assist パネルがライセンスに含まれていることがわかっていても、[オンにする] ボタンが非アクティブ化されます。

根本原因

ユーザーには sn_nowassist_admin.user ロールがあります。このロールは読み取りアクセスのみを許可し、顧客が Now Assist パネルをオンにできないようにします。

ソリューションステップ

1. ユーザーロールの確認:[ユーザー管理] > [ユーザー] に移動します。
2. 影響を受けるユーザーを見つけ、アサインされたロールを確認します。
3. 問題のあるロールを削除:影響を受けるユーザーから sn_nowassist_admin.user ロールを削除します。
4. 適切な管理ロールをアサインする:ユーザーに適切な Now Assist 管理権限があることを確認します
5. 機能をテストする:Now Assist アドミンコンソールに戻り、[オンにする] ボタンがアクティブになっていることを確認します。

予防のヒント

• 常に最小特権の原則に従ってロールを割り当てます。
• ユーザーの責任に基づいて、適切な Now Assist アドミンロールを使用します。
• ロールの詳細については、Now Assist アドミンロールのドキュメントを参照してください。

問題 #2: Now Assist パネルが内部サーバーエラー 500 をスローする。

問題の説明

ヘッダーの Now Assist パネルを使用しようとすると、それをクリックして、com.glide.rest.util.NotFoundException というメッセージを含む内部サーバーエラー 500 エラーが発生します。

根本原因

この問題は、Now Assist パネルコンテキストプロファイルのモデルタイプ構成が正しく設定されていない場合に発生します。

ソリューションステップ

1. sys_cs_context_profile.list に移動します。
2. [Now Assist パネル:プラットフォーム] の [モデルタイプ] をオンにします。
3. [Now Assist パネル] に設定されていることを確認します。
4. 別に設定されている場合は、「Now Assist パネル」に戻してレコードを保存します。

重要な注意

本番環境でこれらの変更を行う前に、必ず準本番環境で動作をテストしてください。

追加の検証手順

1. 変更後にブラウザのキャッシュをクリアします。
2. さまざまなユーザーアカウントでテストして一貫性を確認します。
3. システムログに関連エラーがないか監視します。

問題 #3: Now Assist パネルが無限ロード状態でスタックする。

問題の説明

バックエンドの Now Assist パネルが応答せず、常にロードされているようです。

1. インスタンスにログインします。
2. ネイティブ UI で Now Assist パネルをクリックします。
3. ロードステータスのままです。

根本原因

Now Assistパネル の sys_cs_context_profileレコードが非アクティブです。

ソリューションステップ

1. Now Assist パネルのsys_cs_context_profileレコードは、次のプラグインから取得されます。:com.glide.cs.genai
2. プラグインを修復するとレコードがアクティブになり、問題が解決します。
3. sys_cs_context_profile の URL は https://<instance-name>.service-now.com/sys_cs_context_profile.do?sys_id=e93cab98c7c03110b65579a988c260c4 です。

詳細な修復手順

1. プラグインに移動: システム定義>プラグインに移動します。
2. プラグインを見つけます。「com.glide.cs.genai」を検索します。
3. プラグインの修復: 右クリックして [修復] を選択します。
4. 修復プロセスを監視する:システムログで完了を確認します。
5. コンテキストプロファイルを確認します。上記のsys_cs_context_profile URL に移動します。
6. パネルのテスト:Now Assist パネルを再度ロードしてみてください。

問題 #4:アクティベーション後に Now Assist パネルが表示されない。

問題の説明

ユーザーから、Now Assist パネルを正常にアクティブ化した後でも、ヘッダーまたはインターフェイスに表示されないという報告があります。

トラブルシューティング手順

1. ブラウザの互換性を確認
• サポートされているブラウザバージョンを使用していることを確認します。
• ブラウザのキャッシュと Cookie をクリアします。
• ブラウザ拡張機能を一時的に無効にします。
2. ユーザー権限を検証
• ユーザーが Now Assist パネルにアクセスするための適切なロールを持っていることを確認します。
• ユーザーが正しいグループに属しているかどうかを確認します。
3. インスタンス構成チェック
• Now Assist パネルプラグインがアクティブであることを確認します。
• Now Assist 構成のシステムプロパティを確認します。
• インスタンスに適切なライセンスがあることを確認します。

問題 #5:Now Assist サイドパネルで実行されていない AI エージェントのユースケース

問題の説明

ユーザーは AI エージェントのユースケースを作成しましたが、他のコンテキストでは機能しますが、Now Assist サイドパネルに出力は表示されません。

トラブルシューティング手順

1. ユースケース構成を検証
   • ユースケースが適切に公開されていることを確認します。
   • AI エージェントがユースケースに正しく関連付けられていることを確認します。
   • ユースケースがアクティブであり、ドラフトステータスではないことを確認します。
2. パネル統合を確認
   • ユースケースがサイドパネル表示用に構成されていることを確認します。
   • パネルの権限とアクセス制御を確認します。
   • 競合する構成がないか確認します。
3. さまざまなコンテキストでのテスト
   • サイドパネルの外側でユースケースをテストします。
   • 作業シナリオと非作業シナリオの比較します。
   • システムログで統合エラーを確認します。

免責事項

一部の日本語は、翻訳ソフトウェアを使用してお客様の便宜のために翻訳されています。正確な翻訳をご提供できるよう相当な努力を払っておりますが、いかなる自動翻訳も人間の翻訳者に代わることはなく、そのようなことは意図されておりません。翻訳は「現状のまま」提供されています。他言語への翻訳の的確性、信頼性または正確性については、明示または黙示を問わず、いかなる保証も行われません。翻訳ソフトには限界があるため、一部のコンテンツが正確に翻訳されていない場合があります。これらの資料の公用言語は英語です。翻訳の際に生じる相違または不一致は、コンプライアンスまたは履行の目的に関しては拘束力を有さず、法的効力はないものとします。