AI エージェントの高度なシナリオとランタイムの問題プレイブックSummary :root { --ink: #1a1f36; --ink-light: #4a5068; --ink-muted: #8892a7; --surface: #f8f9fc; --card: #ffffff; --border: #e2e5ee; --accent: #2563eb; --accent-soft: #eff4ff; --accent-dark: #1d4ed8; --green: #059669; --green-soft: #ecfdf5; --amber: #d97706; --amber-soft: #fffbeb; --red: #dc2626; --red-soft: #fef2f2; --purple: #7c3aed; --purple-soft: #f5f3ff; --teal: #0891b2; --teal-soft: #ecfeff; --radius: 10px; --shadow-sm: 0 1px 3px rgba(26,31,54,0.06); --shadow-md: 0 4px 16px rgba(26,31,54,0.08); } *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; } body { font-family: 'DM Sans', -apple-system, sans-serif; background: var(--surface); color: var(--ink); line-height: 1.65; -webkit-font-smoothing: antialiased; } .hero { background: linear-gradient(135deg, #1a1f36 0%, #2a3158 50%, #1e3a5f 100%); color: white; padding: 56px 32px 48px; position: relative; overflow: hidden; } .hero-overlay { position: absolute; inset: 0; background: radial-gradient(ellipse at 70% 20%, rgba(37,99,235,0.2) 0%, transparent 60%), radial-gradient(ellipse at 20% 80%, rgba(8,145,178,0.15) 0%, transparent 50%); pointer-events: none; } .hero-inner { max-width: 960px; margin: 0 auto; position: relative; z-index: 1; } .hero-badge { display: inline-flex; align-items: center; gap: 6px; background: rgba(255,255,255,0.1); border: 1px solid rgba(255,255,255,0.15); padding: 5px 14px; border-radius: 20px; font-size: 12px; font-weight: 600; letter-spacing: 0.5px; text-transform: uppercase; margin-bottom: 20px; } .hero-badge .dot { width: 6px; height: 6px; border-radius: 50%; background: #34d399; } .hero h1 { font-size: 32px; font-weight: 700; line-height: 1.25; margin-bottom: 12px; } .hero p { font-size: 16px; color: rgba(255,255,255,0.75); max-width: 640px; line-height: 1.6; } .hero-meta { display: flex; flex-wrap: wrap; gap: 24px; margin-top: 24px; font-size: 13px; color: rgba(255,255,255,0.55); } .container { max-width: 960px; margin: 0 auto; padding: 0 24px; } .content { padding: 40px 0 80px; } .use-case:hover { box-shadow: 0 4px 16px rgba(26,31,54,0.08); } .toc a:hover { color: #2563eb; } .prop-table tr:nth-child(even) td { background: #fafbfd; } @media (max-width: 640px) { .hero { padding: 36px 20px 32px; } .hero h1 { font-size: 24px; } .toc-grid { grid-template-columns: 1fr; } .uc-header, .uc-body { padding-left: 20px; padding-right: 20px; } .prop-table { font-size: 12px; } .prop-table th, .prop-table td { padding: 8px 10px; } } ITSM、HR、CMDB、ITOM 全体で、プラグインのインストールの失敗、AI エージェントスタジオのセキュリティ制約、ナレッジグラフツールのエラー、エージェント命名の競合、プロバイダー構成、トリガーの誤発、ドメイン固有のエージェントの問題など、高度なランタイムシナリオをカバーする補足的なトラブルシューティングプレイブック。 📂 カテゴリ:AI エージェント:高度なシナリオとランタイム ⚡ 適用先:AI エージェントスタジオ ·ITSM ·HR ·CMDB ·ITOM ·ナレッジグラフ ·A2A ·Now Assist アドミン このプレイブックのユースケース 1プラグイン依存関係チェーンの障害 2SKU ロックアウト:高頻度の問題 31 文字のタイポで ITSM がクラッシュ 4ステータスの不整合: 終了と進行中 5緊急停止:暴走中のエージェント 6消失する OOB ワークフロー 7アップグレード後のエージェント記憶喪失 8名前変更による孤立 9プロバイダーゴースト:Azure AI の欠落 10ナレッジグラフの行き止まり 11CMDB タイムアウト:大規模なテーブルクエリ 12架空のトリガー:ゼロ実行 13予測の確率的ドリフト 14False "Excellent" 評価 15固定スキルが削除されない 1617 秒の BGE リランカー遅延 17A2A 構成マトリクス:非同期と Grant Type 18VA で不要な翻訳 19クローン後: 一意キー違反 20古いトピック:すべてのワークフローが停止 21作業メモに「null」ユーザー 🧭意思決定ツリー : どの修正が必要ですか? 📚 統合参照リンク 📦 ユースケース 1:プラグイン依存関係チェーンの失敗 — 「このアプリは依存関係としてのみインストールできます」 プラグイン 構成 問題 Now Assist プラグインをインストールしようとすると、「このアプリは依存関係としてのみインストールできます」(生成 AI コントローラーの場合) などのエラーでインストールが失敗したり、依存関係の競合により Now Assist スキルキット、OpenAI 生成 AI スポーク、または統合ハブアクションステップ:サーバー送信イベントをインストールできなかったりします。 根本原因 生成 AI コントローラー (sn_generative_ai) は、すべての Now Assist アプリケーションの依存関係として含まれています。製品ドキュメントによると、 個別にインストールすることはお勧めしません。Now Assist アプリケーションスイート (ITSM 向け Now Assist など) の一部としてインストールする必要があります。また、一部のプラグインでは、インストール前にエンタイトルメントの検証が必要です。 解決 1生成 AI コントローラーを個別にインストールしないでください。代わりに、Now Assist アプリケーションスイート ( Now Assist for Platform、 Now Assist for ITSM、 Now Assist for CSM、 Now Assist for FSO をインストールします。コントローラーは依存関係として含まれます。2インストールする前に、アドミンサポートチームに確認するか契約を確認して、カスタマーに Now Assist スイートのエンタイトルメントがあることを確認してください。3Now Assist アプリケーションがアプリマネージャーに表示されない場合は、 更新チェッカースクリプト を実行して、インスタンスと ServiceNow Store の接続を更新します。4事前に検証済みのスイートバージョンリストを使用して互換性を確認します。KB2666962を参照してください。 i️ インストール順序: Now Assist スイートアプリをインストールします (依存関係を自動的にプルします)。生成 AI コントローラー、プラットフォーム AI エージェント、Now Assist スキルキットを最初にスタンドアロンとしてインストールするのではなく、スイートアプリケーションからインストールしてください。 📘 KB2666962 - 事前検証済みのスイートバージョン 🔐 ユースケース 2:SKU ロックアウト:「セキュリティ上の制約」により AI エージェントスタジオへのアクセスがブロックされる (高頻度の問題) Config Licensing 問題 AI エージェントスタジオで「セキュリティ制約」バナーが表示されたり、「ライセンスの制限によりアクセスが制限されている」と表示されたりして、エージェントを構成またはテストできなくなります。この問題は、ACL now.agent-studio.*/ux_route がスクリプトレベルで失敗したことが原因で発生します。 根本原因 最近の分岐に結合された NAA (Now Assist アドミン) 履行者 SKU への変更は、最近のアップグレードを持つインスタンスに影響します。完全な ACL チェーン: ACL now.agent-studio.*/ux_route (sys_id: 669da2f1370caa10130b6c6655c06728) →calls sn_aia.AiAgentRuntimeUtil (sys_id: 206d92309f9312109a61bfbc2b0a1ceb) → calls sn_nowassist_admin.NowAssistSkillConfig.checkAccessForAssetSubscription → 「履行者向け Now Assist サブスクリプション」SKU がプロビジョニングされているかどうかを確認します。Now Assist アドミンコンソールのバージョン 6.6.4 以降は影響を受けます。SKU エンタイトルメントがない場合、このスクリプトによってアクセス制限がトリガーされます:answer=(new sn_aia.AiAgentRuntimeUtil.hasValidLicense); 解決 1回避策として、システムプロパティ sn_nowassist_admin.ignoreFulfillerSubscriptionCheck を true に設定します。2バックグラウンドスクリプトを使用してエンタイトルメントを確認します: gs.info(new sn_entitlement.GlideEntitlementAPI.hasLicenseForArtifact("family_id", "sn_gen_ai_platform_fulfiller", false, true)); — SKU が存在する場合は「true」を返し、存在しない場合は「false」を返します。3顧客の契約に、本番インスタンスと準本番インスタンスの両方にマッピングされた必要な Now Assist SKU エンタイトルメントが含まれていることを確認します。プロパティsys_id: d39fc7c7ff057210b97efffffffffff75。4エンタイトルメントが確認されてもエラーが解決しない場合は、価格設定ヘルプデスクチームに依頼してバックエンドマッピングを確認してください。 ⚠️ 重要:ignoreFulfillerSubscriptionCheck プロパティは回避策であり、永続的な解決策ではありません。根本原因は、適切なライセンスによって解決する必要がある SKU エンタイトルメントがないことです。 💥 ユースケース3:1文字のタイポですべてのITSMエージェントがクラッシュする — journalGRとjournalGr プラグイン 実行 問題 新しいバージョンの IT Service Management AI エージェントコレクションプラグインをインストールした後、「ITSM インシデント解決計画調査 AI エージェント:すべてのデータをフェッチ」ツールを使用する AI エージェントがクラッシュし、「申し訳ありませんが、問題が発生しました」という一般的なエラーが発生します。 根本原因 スクリプトインクルードの 入力ミス sn_itsm_aia.InvestigatingAndResolvingIncidentsUtilSNC プラグインの更新で導入されました。53 行目で、 journalGR.orderBy("sys_created_on") が誤った変数名 (小文字の r ではなく大文字の R ) を使用しています。 解決 1スクリプトインクルード sn_itsm_aia.InvestigatingAndResolvingIncidentsUtilSNC を最新の OOB バージョンに設定します。2次に、53 行目のタイプミスを修正し、 journalGR.orderBy("sys_created_on"); を journalGr.orderBy("sys_created_on"); (小文字の 'r') に変更します。3レコードを保存し、エージェントを再テストします。 🔴 PRB1998233:ITSM AI エージェントコレクションのスクリプトインクルードタイポ ⏹️ ユースケース 4:ステータスの非同期:ツールに「進行中」と表示されている間にエージェントが「終了」 実行 問題 AI エージェントプレイグラウンドでは、エージェントフローに「終了」ステータスが表示されますが、ツールの実行が正常に完了したにもかかわらず、ツールのステータスは「進行中」のままです。これにより、実際の実行状態について混乱が生じます。 解決 1実行計画と個々の実行タスクをチェックして、ツールが実際に完了したかどうかを確認します。2会話の生成 AI ログを確認して、問題がステータス表示のバグなのか、実際の実行の失敗なのかを特定します。3ツールが正常に完了してもエージェントが終了したと表示される場合は、UI ステータス同期の問題である可能性があります。現在のプラグインバージョンに既知の欠陥がないか確認し、修正がある場合はアップグレードしてください。 🛑 ユースケース 5:緊急停止:暴走中のエージェントの実行を停止 実行 構成 問題 AI エージェントまたはエージェント型ワークフローが意図せずトリガーされ (レコード作成時の自動トリガーなどによって)、現在は進行中ステータスになり、アシストとリソースが消費されています。アドミニストレーターはそれらを停止する必要があります。 解決 1sn_aia_execution_planテーブルに移動し、進行中の実行計画をフィルタリングします。2ステータスを更新することによって意図せずトリガーされた実行計画をキャンセルします。3AI エージェントスタジオで意図しない実行の原因となった自動トリガーを確認し、無効にします → ワークフロー → トリガー。4syslog でレート制限を確認します:filter source = sn_aia.AiAgentRuntimeUtilSNC AND message CONTAINS "Blocking AIA conversation"見つかった場合は、プラットフォームレート制限によって実行がアクティブにブロックされています。トリガーボリュームをすぐに調査してください。5再発を防ぐために、本番環境で有効にする前にトリガー条件を慎重に確認してください。 🔍 ユースケース 6:OOB ワークフローの消失 — アップグレード後に更新されないコレクションプラグイン プラグイン 構成 問題 OOB エージェント型ワークフロー (「問題解決のための計画の生成」など) は開発インスタンスには存在しますが、アップグレード後の QA および本番インスタンスには存在しません。 解決 1OOB ワークフローは、AI エージェントコレクションプラグイン (ITSM AI エージェントコレクション、CSM AI エージェントコレクションなど) を介して提供されます。これらのコレクションプラグインが、影響を受けるインスタンスにインストールされ、最新バージョンであることを確認します。2アプリマネージャーで AI エージェントコレクションプラグインの保留中の更新を確認し、適用します。3アップグレード後もワークフローがまだない場合は、関連する AI エージェントコレクションプラグインを修復します。4不足しているワークフローの sn_aia_usecase レコードが存在することを確認します。 🔄 ユースケース 7:アップグレード後のエージェント記憶喪失 - NAVA が既知のエージェントの選択を停止する ディスカバリー プラグイン 問題 新しいパッチバージョンにアップグレードすると、以前に NAVA で検出され選択可能だった AI エージェントは選択または呼び出されなくなります。エージェントは AI エージェントスタジオで動作しますが、NAVA はそれを取得しません。 解決 1すべての Now Assist ストアアプリケーションがプラットフォームパッチとともにアップグレードされていることを確認します (KB-0001、「ユースケース 3」を参照)。2アシスタントの設定を確認してください。アップグレード後も、エージェントが引き続き昇格され、アシスタントに対して有効になっていることを確認してください。3スキルのインデックス付きソースのインデックスを再作成します。4sys_cs_context_profileがアクティブで、sys_now_assist_deploymentが同期していることを確認します。 ✏️ ユースケース 8:名前変更による孤立 - 名前が変更されたエージェントがスキルディスカバリーから切断される 構成 問題 AI エージェントスタジオを使用して OOB AI エージェントの名前を変更する場合、名前の変更が対応する sys_gen_ai_skill_config レコードに伝播しないため、スタジオに表示されるエージェント名とディスカバリーで使用されるスキル名の間に不整合が発生します。 解決 1AI エージェントスタジオでエージェントの名前を変更した後、対応する sys_gen_ai_skill_config レコードを新しい名前と一致するように手動で更新します。2表示名が NAP ディスカバリーで使用されている場合は、 sys_gen_ai_skill レコードも確認して更新します。3名前を変更した後、スキルのインデックス付きソースのインデックスを再作成します。 ☁️ ユースケース 9:プロバイダーゴースト:インスタンスに Azure AI One Extend 定義がない Config LLM 問題 ユーザーが Now Assist プロバイダーを変更できないか、インスタンスで Azure AI One Extend 定義を使用できず、サードパーティ LLM プロバイダーを構成できません。 解決 1生成 AI コントローラープラグイン (sn_generative_ai) が最新バージョンであることを確認します。Azure AI サポートには特定の最小バージョンが必要な場合があります。2Azure AI One Extend レコードの sys_one_extend_definition テーブルを確認します。見つからない場合は、生成 AI コントローラープラグインを修復します。3sys_one_extend_capability_definitionを確認し、One Extend capability definition が正しくロードされていることを確認します。4インスタンスが最近アップグレードまたはクローンされた場合は、生成 AI コントローラーと関連プラグインを再修復します。 🔗 ユースケース 10:ナレッジグラフの行き止まり — 実行中の「ナレッジグラフが見つかりません」 ツール 実行 問題 AI エージェント内のナレッジグラフツールが機能せず、「ナレッジグラフが見つかりません」というエラーが返され続けます。エージェントは、ナレッジグラフ統合を通じてデータを取得できません。 解決 1ナレッジグラフプラグイン (sn_kg) がインストールされ、互換性のあるバージョンであることを確認します。2ナレッジグラフスキーマが適切に構成され、グラフがインデックス化されていることを確認します。3AI エージェントに、ナレッジグラフテーブルと API にアクセスするための適切な権限があることを確認します。4KG ツールの呼び出しに関連する特定のエラーメッセージについては、 sys_generative_ai_log を確認してください。5sn_ais_assist.enable_knowledge_graph_nlq プロパティが true に設定されていることを確認します。6ナレッジグラフコアプラグイン (sn_kg) が互換性のあるバージョン (キーバージョン:4.1.5、5.1.0) にあることを確認します。7TextToResult/KG NLQ を使用する場合: sn_ais_assist.kg.nlq.request_timeout = 20000 (デフォルト:10000 ミリ秒) でタイムアウトを増やす — PRB1950955の回避策。 ⚙️ sn_ais_assist.enable_knowledge_graph_nlq 🐌 ユースケース 11:CMDB 検索タイムアウト:大きなテーブルクエリがエージェントの制限を超えている ツール パフォーマンス 問題 「CMDB 検索」AI エージェントがタイムアウトして検索結果が遅くなり、エージェントの実行が失敗したり、時間がかかりすぎたりします。 解決 1CMDB データ量を確認します。検索ツールは、適切なフィルタリングを行わずに、レコード数が非常に多いテーブルをクエリしている可能性があります。2エージェントのツール構成内の検索クエリを確認して最適化します。フィルターを追加して結果セットを絞り込みます。3sn_cmdb_gen_ai.import_set_query_limit プロパティ (デフォルト:100) を確認し、必要に応じて調整します。4sn_cmdb_gen_ai.error_summary_max_length および sn_cmdb_gen_ai.error_summary_min_length プロパティで、精度とパフォーマンスのトレードオフを調整します。5CI 要約を使用する場合は、 sn_cmdb_gen_ai.ci_summarization_aggregation プロパティをチェックして、関連リストデータの処理方法を制御します。6sn_cmdb_gen_ai.error_summary_max_length と sn_cmdb_gen_ai.error_summary_min_length で、調整精度とパフォーマンスのトレードオフも確認します。7非常に大きなテーブルの場合:クエリされたフィールドにインデックスを付け、Record Operation から FDIH ツールに切り替えて、sn_aia_agent_tool_m2mにおいてタイムアウトを60秒以上に設定します。 🔔 ユースケース 12:ファントムトリガー — 起動は成功するが実行計画の作成はゼロ 実行 構成 問題 エージェント型ワークフローのトリガー (「HR ケースの解決」など) は、トリガーログに正常に実行されたことを示していますが、対応する AI エージェントの実行計画または実行は作成されません。ワークフローは実際には実行されません。 解決 1特定のレコードのトリガー条件が実際に満たされていることを確認し、トリガーのフィルター条件をレコードデータと照合します。2sn_aia_execution_planテーブルで、サイレント破棄された可能性のある失敗またはキャンセルされた計画がないか確認します。3エージェント型ワークフローがアクティブで、AI エージェントスタジオで適切に構成されていることを確認します。4トリガーが実行されるユーザーコンテキストに必要なロール (sn_aia.read およびドメイン固有のロール) があることを確認します。5トリガー実行時間前後のsn_aiaスコープからのエラーについて、システムログ (syslog_app_scope) を確認します。 🎯 ユースケース 13:確率的ドリフト — 予測エージェントが実行ごとに異なる結果を返す 実行 LLM 問題 予測インテリジェンス AI エージェント (「サービスの予測と HR ケースの転送」など) は、一貫性のない結果を生成します。正確な予測もあれば、失敗する場合もあれば、類似の入力データに対して誤った予測を生成する場合もあります。 解決 1これはLLMベースの予測に固有のものです。結果は確率的であり、決定的ではありません。同じ入力でも、実行間で異なる出力が生成される場合があります。2一貫性のない LLM 推論につながる可能性のあるあいまいさについて、エージェントの指示を確認します。3エージェントが予測インテリジェンスモデルに依存している場合は、予測モデルのトレーニングデータ量を増やします。4自動チャット評価機能を使用してテストし、複数の実行にわたる一貫性を測定し、失敗のパターンを特定します。5分類タスクを LLM に依存するのではなく、決定論的ロジック用のスクリプトツールを使用することを検討してください。 📊 ユースケース 14:False「優秀」 — アセスメントエージェントが空のレコードを高品質と評価する 実行 LLM 問題 「変更品質のアセスメント」AI エージェントは、データがほとんど入力されていない変更レコードであっても「優秀」の評価を返します。品質アセスメントは、実際のデータの完全性を正確に反映していません。 解決 1エージェントの指示とアセスメント基準のプロンプトを確認します。利用可能なデータが不十分な場合、LLM はデフォルトで肯定的な評価に設定されている可能性があります。2空のデータまたはまばらなデータを明示的に処理するようにエージェント指示を変更します。例:「必須フィールドが空の場合、または最小限のデータが含まれている場合は、品質を Poor または Insufficient と評価します。」3アセスメントのために LLM に渡す前にフィールドの完全性をチェックするスクリプトツールを使用して、検証ロジックを追加します。4さまざまな完全性レベルのレコードでテストし、期待される出力を調整します。 🗑️ ユースケース 15:固定スキル:Now Assist パネルからスキルを削除できない NAP 構成 問題 スキル (「変更要求の構成アイテム (CI) を提案」など) を Now Assist パネルから削除することはできません。スキルは、アシスタント構成の非アクティブ化または削除を試みた後も、引き続き表示されます。 解決 1スキルからアシスタントへのマッピングの sys_cs_context_profile_skill テーブルを確認します。不要なマッピングレコードを削除します。2sys_gen_ai_skillレコードとsn_aia_skill_metadataレコードを確認します。スキルレコードが表示されない場合は非アクティブ化します。3適切なアシスタント構成で Now Assist アドミンコンソールからスキルを非アクティブ化します。4削除後にスキルのインデックス付きソースのインデックスを再作成します。5キャッシュ (cache.do) をクリアして再テストします。 🐢 ユースケース 16:17 秒間のディスカバリー遅延 — エージェント呼び出しの BGE リランカーのボトルネック パフォーマンス ディスカバリー 問題 Now Assist VA でのエージェント検出中に BGE リランカーの応答が遅くなり、非同期呼び出しに 17 秒超かかります。これにより、エージェントの呼び出しが大幅に遅れ、ユーザーエクスペリエンスが低下します。 解決 1これは既知のパフォーマンスの問題であり、内部で追跡されています。BGE リランカーのレイテンシに対処する利用可能なパッチまたはホットフィックスを確認します。2スキルとエージェントの数を減らして、ディスカバリー中のリランカーの作業負荷を最小限に抑えます。3glide.cache.size.SkillDetailsCache プロパティを確認し、キャッシュミスを減らすためにそれを増やします。4生成 AI ログで「AIA エージェント呼び出し元」のタイミングを監視し、リランカーステップからの特定のレイテンシの寄与を測定します。 🔌 ユースケース 17:A2A 非同期呼び出しと Grant Type 構成の問題 A2A 構成 問題 A2A (エージェント間) 非同期呼び出しが失敗するか、インスタンス間の A2A 通信用に構成する正しいGrant Typeについてユーザーが質問しています。 解決 1非同期 A2A 呼び出しの場合は、インスタンスでプッシュ通知が有効になっていることを確認します。プッシュ通知がない場合、非同期モードではサブフローが無期限に待機してタイムアウトします。2AIA プレイグラウンドでの A2A テストには 同期モード を使用します。そこでは非同期はサポートされていません。3sys_cs_channel → AI Agent A2A Channel → synchronousフィールドが true であることを確認します。 (sys_id:5b6acb7eff426e50d635ffffffffffd8) 4 Grant Type の構成には、サーバー間通信に適した OAuth 2.0 の Grant Type (通常は client_credentials) を使用します。 5サーバーが複数のデータグラムを送信する場合は、 sn_mcp_client.wait_for_server_connection_close プロパティが true に設定されていることを確認します。 🌐 ユースケース 18:不要な翻訳 - VA は応答を英語以外のものに自動翻訳します NAVA I18N 問題 ユーザーが英語以外の発言を Now Assist 仮想エージェントに送信すると、VA は、顧客が翻訳を希望せず、入力言語に関係なくすべての回答を英語で希望する場合でも、応答をユーザーの言語に自動的に翻訳します。 解決 1sn_generative_ai.append_lang_in_prompt プロパティを確認します。true に設定すると、ユーザーの言語設定が LLM プロンプトに追加され、その言語で応答するようになります。2ユーザーの言語に関係なくすべての回答を英語にする必要がある場合は、 sn_generative_ai.append_lang_in_prompt を false に設定します。3または、エージェント/スキルのプロンプトを変更して、「入力言語に関係なく、常に英語で応答する」と明示的に指示します。4英語以外のユーザーが VA を介して英語の KB 記事を見つけることができない場合は、 glide.ais.global_searchable_filter.kb_knowledge プロパティを確認します。 💥 ユースケース 19:クローン後のデータベース破損 — 一意キー違反によるすべてのエージェントの強制終了 構成 実行 問題 クローン作成またはメンテナンスアクティビティの後、すべての AI エージェントがハングアップし、データベース内の「重複キー値が一意の制約に違反しています」エラーで実行に失敗します。実行計画は作成されますが、オーケストレーターステップで失敗します。GenAI ログには、実行は開始されても完了しないことが表示されます。 解決 1プラグインを依存関係順に修復します: com.glide.ai_record_activity → com.glide.identity.agent.security → Now Assist AI エージェント (sn_aia) →プラットフォーム AI エージェントとスキル。2修復で修正されない場合:データベース制約の修復については、プラットフォームエンジニアリングサポートにエスカレートしてください。3クローン後のチェックリスト:sn_aia テーブルに一意の制約違反がないことを確認します。複雑なワークフローを展開する前に、シンプルなエージェントでエージェントの実行をテストします。 📄 ユースケース 20:古いシステムトピック — すべてのエージェント型ワークフローが同時に停止する プラグイン 実行 問題 すべてのエージェント型ワークフローが「[topic_AIA-Agent Invoker] でのスクリプト評価エラー」または「TypeError: Method toString called on incompatible object (TypeError: Method toString called on incompatible object)」で同時に失敗します。システムトピックは、以前のサポートインタラクション (設計トピックバージョン≠ランタイムバージョン) で変更されました。 診断ステップ 1移動: sys_cs_topic_list.do →フィルター:「AIA-agent」のような名前または「AIA」のような名前。2各トピックの「システムアップデートバージョン」の日付を確認してください。3最新の OOB バージョン (ソース = 「ストアアプリケーション:Now Assist AI エージェント」) と比較します。例:2025-08-23 のトピックと OOB 2026-02-18 = 古い。 解決 1すべての AIA システムトピックを replace_on_upgrade = true で sys_update_xml でマークします。一括更新の場合は、トピックごとにアプリケーションスコープを変更します。2プラグインの修復: sn_aia および sn_nowassist_va。3修復後、AIA-Agent Invoker トピックが最新の OOB バージョンになっていることを確認します。。 🚫 繰り返し発生する問題: この正確な根本原因が 1 つの顧客アカウントで 3 回出現しました。これは繰り返し発生するパターンです。AIA システムトピックを直接変更しないでください。ステータスは、常に [アシスタントセットアップ] ページの UI で切り替えます。 👤 ユースケース 21:エージェントの作業メモに AI ID ではなく「Null」ユーザーが表示される 構成 実行 問題 AI エージェントワークフローによって投稿された作業メモまたはコメントには、ユーザーが「AI」または構成されたワーカーユーザー名ではなく「null」として表示されます。アクティビティストリームには「[Now Assist 生成]」と表示されますが、ユーザーは「Null」です。開発では「AI」として表示されますが、UAT では「null」として表示されます。 根本原因 AI エージェントの「別のユーザーとして実行」ユーザー構成がないか、非アクティブであるか、環境間で適切に同期されていません。ITSM ワーカー AI エージェントユーザーレコードがターゲットインスタンスに存在しないか、アクティブである可能性があります。 解決 1「ITSM ワーカー AI エージェント」ユーザーレコードが存在し、影響を受けるインスタンスでアクティブであることを確認します。2欠落している場合:更新セットを介してインポートするか、手動で作成します。「Platform AI Worker」ユーザーも確認します。3デフォルトのユーザーレコードを復元するための sn_aia プラグインを修復します。4エージェント型ワークフローの「別のユーザーとして実行」ユーザー構成を確認します。 🧭 意思決定ツリー — どの修正が必要ですか? プラグインのインストールまたはライセンスの問題ですか? 「このアプリは依存関係としてのみインストールできます」 → ユースケース 1AI エージェントスタジオの「セキュリティ制約」または「ライセンス制限」 → ユースケース 2プラグインの更新後にエージェントがクラッシュする → ユースケース 3 エージェントのステータスまたはライフサイクルの問題ですか? エージェントは終了しましたが、ツールは進行中を示しています → ユースケース 4意図せずにトリガーされたエージェントを停止する必要がある → ユースケース 5アップグレード後に OOB ワークフローがない → ユースケース 6アップグレード後に NAVA でエージェントが選択されない → ユースケース 7 構成または命名の問題ですか? 名前を変更したエージェントがスキル構成に反映されていません → ユースケース 8プロバイダー/Azure AI を利用できません → ユースケース 9NAP からスキルを削除できません → ユースケース 15 ツールまたはパフォーマンスの問題ですか? ナレッジグラフツールのエラー → ユースケース 10CMDB 検索タイムアウト/遅い → ユースケース 11BGE リランカーの遅いディスカバリー (17 秒超) → ユースケース 16 それは実行品質ですか、それともトリガーの問題ですか? トリガーは起動するが、実行は作成されない → ユースケース 12予測エージェントの一貫性のない結果 → ユースケース 13エージェントアセスメントから誤ったスコアが返される → ユースケース 14VA が応答を予期せず翻訳する → ユースケース 18A2A 非同期/Grant Typeの問題 → ユースケース 17クローン後にすべてのエージェントが停止した (一意キー) → ユースケース 19すべてのワークフローが停止しました (AIA エージェント呼び出し元のスクリプトエラー) → ユースケース 20エージェントの作業メモに「null」ユーザーが表示される → ユースケース 21 📚 統合参照リンク ServiceNow の KB 記事 📘 KB2666962 — 事前検証済みスイートバージョン 📘 KB2704710 — ServiceNow KB 📘 KB2709990 — AI 支援サポートの詳細 KB2507579 📘 — エージェント型 AI トラブルシューティングランディングページ 既知の問題と欠陥 🔴 PRB1998233:ITSM AI エージェントコレクションのスクリプトインクルードタイポ 🔴 PRB1994390:Status 503 Service Unavailable in logs 🔴 PRB1999517:Conversational Catalog does not check Autonomous setting 主要なプロパティ (高度なシナリオ) ⚙️ sn_nowassist_admin.ignoreFulfillerSubscriptionCheck ⚙️ sn_generative_ai.append_lang_in_prompt ⚙️ sn_ais_assist.enable_knowledge_graph_nlq ⚙️ sn_cmdb_gen_ai.import_set_query_limit ⚙️ sn_cmdb_gen_ai.ci_summarization_aggregation ⚙️ sn_cmdb_gen_ai.error_summary_max_length ⚙️ glide.ais.global_searchable_filter.kb_knowledge 主要なスクリプトインクルード ⚙️ sn_itsm_aia.InvestigatingAndResolvingIncidentsUtilSNC — 53 行目のタイプミスを確認 ⚙️ sn_aia.AiAgentRuntimeUtil — ライセンス検証チェック