NLU から LLM への移行ログ

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:6分
  • トピック移行の実行アイテム [topic_migration_execution_item.list] テーブルには、 自然言語理解 (NLU) (NLU) トピックを大規模言語モデル (LLM) トピックに移行するときのデータ (移行ステータス、移行の問題、移行または公開されたトピック情報など) が含まれています。

    このトピックの移行データにアクセスするには、ナビゲーションペインで topic_migration_execution_item.list を検索するか、.テーブルの CSV ファイルバージョン。トピックを移行した後、ダウンロード可能な .CSV ファイルには、トピック移行ワークフローの [トピックを移行] ステップの [ 移行ログを確認 ] オプションからアクセスできます。

    図 : 1. [移行ログを確認] オプションの例
    移行ログの確認は、トピックの移行完了後に利用可能なオプションで、移行の進行ステータスバーに関連して表示されます。

    トピック移行の実行アイテム [topic_migration_execution_item.list] テーブルには、デフォルトで次の列が含まれます。

    • 説明
    • 問題
    • LLM トピック
    • 移行の実行
      注:
      [ 移行の実行 ] 列には、各移行バッチに対して生成される一意の ID が含まれます。たとえば、10 個のトピックが同時に移行された場合、テーブルには 10 個のトピック行が含まれ、各行には同じ移行実行値が含まれます。
    • 移行ステータス
    • NLU トピック
    • ステータス
    • タイプ
    図 : 2. トピック移行の実行アイテムテーブルデータの例
    トピック移行の実行アイテムログの例のデフォルト列は、[説明]、[問題]、[LLM トピック]、[移行の実行]、[移行ステータス]、[ NLU トピック]、[ステータス]、および [タイプ] です。

    トピックの移行プロセス中に一般的な問題が発生する可能性があります。次の表には、[問題] 列で発生する可能性のある具体的な一般的な問題と、その問題がトピックの公開をブロックしているかどうかを示します。

    表 : 1. 問題列の詳細
    問題列の値 問題のタイプ トピックを公開できますか?
    一部のトピックプロパティを生成できませんでした。公開するには、次のノードを手動で確認して編集します。 [ノード名のリスト] ノードレベルの問題:これらの問題は検証エラーメッセージであり、名前や説明などのフィールドの欠落が含まれる場合があります。 なし。

    トピックを公開する前に問題を修正する必要があります。

    トピックでスクリプトを使用したため、一部のトピックプロパティを生成できませんでした。公開するには、次のノードを手動で確認して編集します。 [ノード名のリスト] スクリプトレベルの問題:これらの問題は、 NLU 入力ノードの [プロンプト ] フィールドにスクリプトまたはデータピルがある場合に発生します。 はい。

    [詳細な説明] フィールドに [ノード名] を収集 (Collect [Node Name])] が入力されているため、この問題のあるトピックは公開できますが、[詳細な説明] フィールドの値を変更して改善する必要があります。

    一部のトピックプロパティを生成できませんでした。トピックを公開する前に編集してください。 トピックレベルの問題:これらの問題は、説明、キーワード、その他の必須フィールドの欠落など、トピックレベルでの検証エラーです。 なし。

    トピックを公開する前に問題を修正する必要があります。

    トピックの説明を生成できませんでした。公開する前に、[公開] ページまたは仮想エージェントデザイナーのトピックプロパティページから説明フィールドを編集します。 LLM が生成する説明の問題:これらの問題は、LLM が有効なトピックの説明を生成できない場合に発生します。 はい。

    [トピック名] が [トピックの説明] フィールドに入力されるため、この問題のあるトピックは公開できますが、[トピックの説明] フィールドの値を変更して改善する必要があります。

    マッピングされたインテントが見つからなかったため、トピックの説明を生成できませんでした。公開する前に、[公開] ページまたは仮想エージェントデザイナーのトピックプロパティページから説明フィールドを編集します。 NLUインテントの複雑さに関連する LLM で生成された説明の問題:これらの問題は、NLUモデルとインテントがトピックにマップされているが、sys_nlu_modelテーブルまたはsys_nlu_intentテーブルにない場合、またはこれらの値がトピックに誤ってマップされている場合に発生します。 はい。

    [トピック名] が [トピックの説明] フィールドに入力されるため、この問題のあるトピックは公開できますが、[トピックの説明] フィールドの値を変更して改善する必要があります。

    インテントとキーワードの両方がないため、トピックの説明を生成できませんでした。公開する前に、[公開] ページまたは仮想エージェントデザイナーのトピックプロパティページから説明フィールドを編集します。 NLUインテントの複雑さに関連する LLM で生成された説明の問題:これらの問題は、NLUモデルのインテントとキーワードがトピックにマップされていない場合に発生します。 はい。

    [トピック名] が [トピックの説明] フィールドに入力されるため、この問題のあるトピックは公開できますが、[トピックの説明] フィールドの値を変更して改善する必要があります。

    移行ツールは、このトピックから 1 つ以上の動的トピックブロックノードを変換できませんでした。動的トピックブロック内で使用されるトピックブロックは、手動で移行する必要があります。次のノードは、次の動的トピックブロックを使用します。 [ノード名のリスト] 動的トピックブロックの問題:これらの問題は、移行されていない動的トピックブロックを持つノードがある場合に発生します。 はい。

    トピックブロック名が動的トピックブロックのスクリプトを使用し、 NLU トピックブロックを使用して期待どおりに動作し続けるため、この問題のあるトピックを公開できます。この問題が発生した場合は、[トピックの選択] ステップから移行対象のトピックブロックを選択し、スクリプトのトピックブロック名を更新します。

    移行ツールで、このトピックから 1 つ以上のトピック切り替えスクリプトを変換できませんでした。トピック切り替えスクリプト内で使用されるトピックは、手動で移行する必要があります。次のノードは、これらのトピック切り替えスクリプトを使用します。 [ノード名のリスト] トピックスクリプトの切り替えの問題:これらの問題は、ノードに移行されていないトピック切り替え機能がある場合に発生します。 はい。

    トピックスクリプトは移行まで NLU トピックを使用し続けるため、この問題のあるトピックを公開できます。この問題が発生した場合は、[トピックの選択] ステップから移行対象のトピックを選択します。

    このトピックを移行できませんでした。サポート ServiceNow お問い合わせください。 プロセス障害の問題:これらの問題は、特定の移行プロセス中にエラーが発生するたびに発生します。 なし。

    トピックを公開する前に、 ServiceNow 従業員が問題を修正する必要があります。

    NLU ノードから LLM ノードへの変換に失敗したため、このトピックを移行できませんでした。サポート ServiceNow お問い合わせください。 プロセス障害の問題:これらの問題は、 NLU ノードから LLM ノードへの変換中にエラーが発生するたびに発生します。 なし。

    トピックを公開する前に、 ServiceNow 従業員が問題を修正する必要があります。

    公開ペイロードの生成に失敗したため、このトピックを移行できませんでした。サポート ServiceNow お問い合わせください。 プロセス障害の問題:これらの問題は、特定の移行プロセス中にエラーが発生するたびに発生します。 なし。

    トピックを公開する前に、 ServiceNow 従業員が問題を修正する必要があります。

    トピックの説明を追加するまで、このトピックは公開できません。 プロセス障害の問題:これらの問題は、特定の移行プロセス中にエラーが発生するたびに発生します。 なし。

    トピックを公開する前に問題を修正する必要があります。公開する前に、公開ステップで、またはトピックのプロパティページから、 仮想エージェントデザイナー から説明フィールドを編集します。