登録済みモデルバージョンのキー値を管理する¶
After you register a model, you can add key values and edit existing (user-created) key values from the Registry. キー値の詳細については、ドキュメントをご覧ください。
Runtime parameter key values
You cannot create or edit runtime parameter key values in the Registry, those are defined in the Model workshop.
キー値を追加¶
登録済みモデルバージョンに新しいキー値を追加するには:
-
モデルディレクトリページの登録モデルのテーブルで、キー値を管理するバージョンを含む登録済みモデルをクリックして、バージョンのリストを開きます。
-
バージョンのリストで編集するバージョンをクリックし、登録済みモデルバージョンパネルを開きます。
-
概要タブをクリックし、キー値セクションを見つけます。
-
キー値カテゴリーのグループボックスで、+ 追加をクリックします(または、そのカテゴリーに1つまたは複数のキー値が存在する場合は、+ タグを追加、+ 指標を追加などをクリックします)。
-
キー値を追加ダイアログボックスで、次のいずれかを選択します。
登録済みモデルバージョンに新しいキー値を追加するには、次のフィールドを設定します。
設定 説明 カテゴリー デフォルトは、+ 追加をクリックしたグループボックスのカテゴリーです。 新しいキー値に対して以下のいずれかのカテゴリーを選択し、目的別にキー値を整理します。 - トレーニングパラメーター
- 指標
- タグ
- アーティファクト
値のタイプ 新しいキー値に対して、次のいずれかの値タイプを選択します。 - 文字列
- 数値
- ブーリアン
- URL
- JSON
- YAML
名前 キーと値のペアのキーにわかりやすい名前を入力します。 値 以下の値タイプのいずれかを選択した場合は、適切なデータを入力します。 - 文字列:4 KBまでの任意の文字列を入力します。
- 数値:整数または浮動小数点数を入力します。
- ブール値:TrueまたはFalseを選択します。
- URL:
scheme://location
形式のURL。例:https://example.com
。 DataRobotは、URLを取得したり、ユーザーインターフェイスでこのURLへのリンクを提供したりしませんが、ダウンロードされたコンプライアンスドキュメントでは、URLがリンクとして表示されることがあります。 - JSON:JSONを文字列として入力またはアップロードします。 このJSONは正しく解析する必要があります。そうでない場合、DataRobotでは受け付けません。
- YAML:YAMLを文字列として入力またはアップロードします。 DataRobotではこのYAMLを検証しません。
説明 _(オプション)_キー値の目的の説明を入力します。 以前に登録したモデルバージョンからキー値をコピーするには、すべてのカテゴリーまたは単一のカテゴリーを選択し、追加をクリックしてキー値をコピーします。
新しいバージョンに同じ名前のキー値が存在し、読み取り専用でない場合、古いバージョンの値がそれを上書きします。 それ以外の場合、その名前の新しいキー値が新規バージョンで作成されます。 いずれかのキー値を編集して別のファイルを使用しても、他のキー値は影響を受けず、ファイルは共有されなくなります。 システムキーの値は一括コピーには含まれません。たとえば、新しいバージョンの
model.version
は古いバージョンの値では上書きされません。APIを介してキー値をインポートするには、クリップボードにコピーをクリックして、キー値をインポートするためのPythonコードスニペットをコピーします。
これは、キー値を登録済みモデルバージョンに追加するためのPythonテンプレートです。
fetch_values()
の実装を指標、タグ、パラメーター、アーティファクトを取得するコードに置き換えて、DataRobotモデルバージョンのキー値としてインポートします。 APIキーを環境変数として指定する必要があります:export MLOPS_API_TOKEN=<value of API token from Developer Tools page>
。 -
追加をクリックしてキー値を保存します。 選択したカテゴリーのリストに新しいキーが表示されます。
モデレーションと評価のガードモデルにキー値を追加¶
本機能の提供について
Evaluation and moderation guardrails are a premium feature. この機能を有効にする方法については、DataRobotの担当者または管理者にお問い合わせください。
機能フラグ:モデレーションのガードレールを有効にする(プレミアム)、モデルレジストリでグローバルモデルを有効にする(プレミアム)、予測応答で追加のカスタムモデル出力を有効にする
モデルがテキスト生成(LLM)モデルの評価とモデレーションのためのカスタムデプロイガードモデルとして使用されることを意図している場合は、登録モデルのバージョンで入力列名と出力列名を定義できます。これにより、各ユーザーが評価とモデレーションの設定時にモデルを選択する際、この情報を指定する必要がなくなります。 そのためには、カスタムモデルバージョンに対して、命名規則を使用して以下のキー値を定義します。 カスタムモデルのバージョンに対して書き込み権限を持つユーザであれば誰でも、評価とモデレーションの入出力列を定義できます。 入力列名と出力列名を定義するには、レジストリ > モデルディレクトリで、ガードモデルとしてデプロイしたい(またはデプロイした)登録モデルのバージョンを開きます。 キー値セクションでタグパネルを展開し、以下を実行します。
-
+ タグを追加をクリックして、タグカテゴリーに新しいキー値を作成します。 値のタイプを文字列に、名前を
moderations.input_column_name
に設定します。 値には、モデルが入力として読み込むデータフレーム列の名前を入力します(例:promptText
)。 -
+ タグを追加をクリックして、タグカテゴリーに新しいキー値を作成します。 値のタイプを文字列に、名前を
moderations.output_column_name
に設定します。 値には、モデルが出力として読み込むデータフレーム列の名前を入力します(例:sincerity_sincere_PREDICTION
)。
この情報が設定されると、登録モデルのバージョンをデプロイできます。デプロイが(プレイグラウンドまたはモデルワークショップで)カスタムデプロイの評価に選択されると、入力列および出力列フィールドが自動的に設定されます。
キー値を編集または削除¶
追加、コピー、またはインポートされたキー値を編集または削除するには:
-
モデルディレクトリページの登録モデルのテーブルで、キー値を管理するバージョンを含む登録済みモデルをクリックして、バージョンのリストを開きます。
-
バージョンのリストで編集するバージョンをクリックし、登録済みモデルバージョンパネルを開きます。
-
概要タブをクリックし、キー値セクションを見つけ、以下のいずれかを実行します。
-
検索をクリックして、編集または削除するキー値を見つけます。
-
タグ、指標、トレーニングパラメーター、ランタイムパラメーター、アーティファクトのセクションを参照して、編集可能なキー値を見つけます。
-
-
作成したキー値については、編集()および削除()アイコンをクリックできます。