更新セットへの NLU モデルの追加

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:5分
  • 更新セットを使用して、 自然言語理解 (NLU) (NLU) モデルをあるインスタンスから別のインスタンスに移動します。更新セットには、ターゲットインスタンスでモデルが機能するために必要なすべてのレコードが含まれています。

    始める前に

    • NLU ワークベンチ プラグイン、NLU ワークベンチ Core プラグイン、および 予測インテリジェンス プラグインがすべてインスタンスにインストールされ、アクティブ化されていることを確認します。
    • 次の手順は、仮想エージェント および AI 検索NLU モデルに適用されます。
    • 必要なロール:admin

    このタスクについて

    更新セットを使用して、ソースインスタンスからターゲットインスタンスにモデルを転送します。ターゲットインスタンスには、ソースインスタンスのモデルのスコープと同じスコープが既に存在している必要があります。

    更新セットへのモデルの追加には、以下のリソースが含まれます:
    • モデルコンテンツ (インテント、発言、エンティティ、注釈、語彙、およびデフォルトのテストセット)
    • 関連語彙ソース
    • 対応する最新のアクティブな ML ソリューション
    • ML モデルのアーティファクト
    • ML ソリューションと定義 (最近の 3 回の実行。そのうちの 1 回が成功した場合)

    更新セットの詳細については、「 システムアップデートセット」を参照してください。

    別の更新セットにモデルを追加する場合は、その更新セットを現在の更新セットにする必要があります。「Create and select an update set as the current set」を参照してください。

    移植性を最適化するために、 NLU モデルをシステムのデフォルトの更新セットではなく、新しい専用の更新セットに追加します。これを行うには、新しい更新セットをモデルのスコープに手動で作成する必要があります。現在の更新セットがスコープのデフォルトである場合は、エラーが表示されます。このエラーには、新しい更新セットを手動で作成するためのリンクが含まれています。

    語彙テーブルなど、モデルに複数のスコープのレコードが含まれている場合、その更新セットは 親子 (バッチ) 構造である必要があります。ステップ5の手順に従って、親子更新セットを作成します。

    モデル (グローバルまたはスコープ対象) を更新セットを使用して移動しても、転送後もトレーニングと公開のステータスは変わりません。したがって、更新セットに追加される前にトレーニングおよび公開されたモデルでは、ターゲットインスタンスでの再トレーニングや再公開は必要ありません。

    親子更新セットの詳細については、「 Update set batching」を参照してください。次のビデオでは、このプロセスのデモを行います。

    手順

    1. [All] を選択し、ナビゲーターに「sys_nlu_model.list」と入力します。

      sys_nlu_model.list が入力されたシステムナビゲーター。

    2. モデルの モデル名 を選択します。

      NLU モデルシステムリスト。

      表示名は、モデルの作成時に付けた名前です。モデル名は、システムによってモデルに与えられます。

    3. オプション: グローバルが現在のアプリケーションである場合は、上部のプロンプトに従ってレコードを編集します。

      現在のアプリケーションスコープに関するメッセージ。レコードを編集して更新セットに追加するには、「ここ」をクリックしてください。

    4. [関連リンク] セクションで、[現在の更新セットにモデルを追加] をクリックします。

      [現在の更新セットにモデルを追加] ボタンが強調表示された [モデル] ページ。

      モデルのレコードがすべて 1 つのスコープ内にある場合、システムはモデルを現在の更新セットに追加します。完了すると、レコードはsys_update_setテーブルで見つけることができます。

      ただし、指定されたスコープがデフォルトスコープの場合はエラーが表示されます。次の手順に進みます。

    5. 「システムのデフォルトの更新セットにレコードを追加しようとしています」というエラーが表示された場合は、この手順の残りの手順に進みます。
      更新セットにモデルを追加中にエラーが発生しました。新しいローカル更新セットを作成するオプションが強調表示されています。

      エラーバナーで、[ 新しいローカル更新セット ] リンクを選択して、デフォルトではない新しい更新セットを作成します。親子更新セットの場合、親は最初にモデルのスコープ内に作成されます。(子更新セットは後のステップで作成されます)。

      新しいローカル更新セット は、sys_update_setテーブルに新しいレコードを開きます。
    6. 新しい更新セットレコードの場合は、名前を指定し、アプリケーションスコープを含む他の値を確認してから、[ 送信して最新にする] を選択します。
      [送信] および [現在にする] ボタンが強調表示された、新しい更新セットのフォーム。
      新しい更新セットが作成され、sys_nlu_modelテーブル内のモデルのレコードが再び開きます。
    7. sys_nlu_modelのモデルのレコードで、[関連リンク] の下にある [現在の更新セットにモデルを追加] を選択します。
      モデルのレコードが複数のスコープにある場合、この手順ではグローバルスコープを持つ子更新セットを作成します。
      注:
      モデルのレコードがすべて 1 つのスコープ内にある場合、システムはモデルを現在の更新セットに追加します。完了すると、レコードはsys_update_setテーブルで見つけることができます。
    8. モデルが非グローバルスコープ内にある場合: [更新セット] テーブルsys_update_setで、親の更新セットとその子の更新セットを見つけます (必要に応じてページを更新します)。
      • 親更新セットの [親] 列の値は 空です
      • 子更新セットには、[親] 列に親の名前があり、[アプリケーション] 列には [グローバル ] があります。
      • 親と子の両方の更新セットの [バッチベース] 列に同じ値が含まれています。
      [更新セット] テーブルで、親行がハイライト表示された親子更新セット。
    9. sys_update_set で親のレコードを開き、[ ステータス ] フィールドを [完了] に設定します。
      [確認] ダイアログボックスがポップアップ表示されます。[はい] を選択して確定します。これにより、親とすべての子の更新セットが [完了] に設定されます。
    10. 更新セットファイルを移行するには、sys_update_set の親のレコードで [更新セットバッチを XML にエクスポート ] を選択します。
      親と子の更新セットが一緒にパッケージ化されてエクスポートされます。

    次のタスク

    ターゲットインスタンスで、[ 取得済み更新セット ] に移動し、[ XML から更新セットをインポート] を選択します。パッケージ化を解除すると、親とすべての子が [取得済み更新セット] テーブルに一覧表示されます。親を開き、[ 更新セットバッチをプレビュー] を選択します。

    ソースインスタンスの参照レコードがターゲットインスタンスに存在しない場合、更新セットの適用中にエラーが発生することがあります。たとえば、sys_nlu_intentの origin フィールドは、ターゲットインスタンスに存在しない別のモデルのインテントを参照できます。失敗したレコードの [リモート更新を承認 ] をクリックして、更新セットをコミットできます。