本文へスキップ

AI運用の判断と根拠を引く

トップへ戻る

モデル/Prompt/Agent 成果物 Registry

用語・参照用語・参照公式仕様のみ公式仕様のみ現行現行として扱う

記事状態: 公開 · 最終確認: 2026-10-20

要点

「登録物の版、来歴、評価、承認、実際の取得物を結び付ける基盤として利用できる」。一方、「登録済みだから安全」「エイリアス名が同じなら内容も同じ」「ハッシュ一致で業務品質まで証明済み」とはしない。

現在の判断

「登録物の版、来歴、評価、承認、実際の取得物を結び付ける基盤として利用できる」。一方、「登録済みだから安全」「エイリアス名が同じなら内容も同じ」「ハッシュ一致で業務品質まで証明済み」とはしない。

どこまで当てはまるか

モデル/Prompt/Agent 成果物 Registry

詳しく理解する

要点と前提

AIの成果物レジストリは、モデル、プロンプト、エージェントの実行定義を識別し、評価や承認の記録と結び付けて利用先へ渡す管理面である。ファイルを置くことだけでは足りない。「何を評価したか」「何を承認したか」「実際に何が読み込まれたか」を同じ識別子へ結び付けることが目的になる。レジストリを導入しても、登録物の品質、データ利用権、ツール操作の安全性が自動的に保証されるわけではない。

管理対象と識別単位

モデルの重みを保存する場合と、外部モデルAPIの名前だけを登録する場合は、再現性の範囲が違う。後者は外部提供者が公開する版情報、設定、取得時刻を残せても、重みの不変性を自社で検証できないことがある。これを「モデル全体の保管」と表現しない。

プロンプトは本文に加え、テンプレート変数、出力スキーマ、推奨モデル設定、利用上の制約を持つ。エージェントは、実行コード・依存ライブラリ、プロンプト、モデル、ツール定義、認可ポリシー、検索先への参照が組み合わさる。単一のZIPだけでなく、依存物の版と関係を解決できる構造が必要になる。検索文書や秘密情報を無条件に同梱するのではなく、管理境界、参照先、保持責任を分ける。

情報例固定・更新の扱い
内容の識別ファイルの暗号学的ハッシュ、レジストリ版承認済み内容を上書きせず、新版を作る
依存の識別コードコミット、プロンプト版、モデル版、インデックス版参照解決した組合せを保存する
可変ポインタ本番環境、champion等のエイリアス変更者、旧値、新値、承認、適用時刻を記録する
評価・承認評価集合と結果、用途・環境、期限対象の内容識別子へ結び付ける
来歴ソース、ビルド主体、実行条件、生成物信頼できる主体と検証手順を別途定める
利用制約ライセンス、機密区分、ツール権限配備先の権限制御へ反映し、単なるタグで済ませない

ここで示す横断的な登録項目は設計提案であり、一製品がすべて同じ形式で実装するという意味ではない。

不変の版と可変エイリアス

MLflowのPrompt Registryは、不変のプロンプト版と、版への可変エイリアスを区別する。[S1] モデル Registryにもモデル版を参照するエイリアスがある。[S2] 「本番環境を評価した」という記録だけでは、後日にポインタが変更されたとき、当時の実体を特定できない。評価時と昇格時には参照を解決し、その結果を保存する。

エイリアスの変更だけで迅速に昇格できることは利点だが、依存の一部分だけが進む危険もある。たとえばエージェントの出力パーサが旧JSON形式を期待する一方、プロンプトの本番環境だけが新形式へ変わると、個々の登録物が正常でも連鎖は失敗する。対策は、互換性を評価した組合せのリリース定義を作り、配備先がその定義から全参照を解決すること。複数の独立したエイリアスを順次書き換える場合には、部分適用時の挙動と復旧手順も設計する。

登録から利用まで

登録時には形式、必要ファイル、ハッシュ、利用許諾、秘密情報混入を検査する。形式検査を通過した状態と、業務利用を承認された状態を区別する。評価結果には入力集合と評価器の版、失敗例、利用可能な範囲を含め、内容のハッシュへ紐付ける。評価後に内容を上書きできれば承認の意味が崩れるため、承認対象は不変の版とする。

昇格時には、申請者と承認者の権限、対象環境、期限、依存物の利用可能性を確認する。取得側は登録された名前だけでなく、解決した版と取得物のハッシュを照合し、起動記録へ残す。ランタイムが参照や内容をキャッシュする構成では、ポインタ変更直後にすべての実行が切り替わるとは限らない。更新方式、キャッシュの失効条件、稼働版の読戻しを、実装に応じて確認する。

実行中のエージェントが途中で別版を読み込むことも避けたい。長い処理では開始時にリリース定義を固定し、後続ステップにも引き継ぐ設計を検討する。ただし脆弱性対応や権限失効を、その固定を理由に無期限に延期しない。緊急停止や再認可を行う制御は、通常の版固定とは別の運用責任として定める。

来歴と信頼の限界

SLSAの来歴は、生成物とその作成過程を追跡する情報である。[S3] ハッシュが一致しても、その生成物が安全なコードであること、学習データの権利が適切であること、回答が正しいことまでは分からない。署名を用いるなら、誰の鍵を信頼するか、検証をどこで強制するか、鍵失効後に何を拒否するかを決める。署名ファイルを置くだけでは取得側の検証にならない。

機密プロンプトを誰でもダウンロードできるレジストリへ集約すれば、監査可能性は上がっても漏えい範囲が広がる。登録、承認、取得、削除の権限を分け、用途ごとのアクセスと監査ログを設計する。プロンプトにAPIキーを埋め込まず、実行時に適切な権限で秘密管理先から取得する。ログや評価データにも、プロンプトと同じ機密性が及ぶ場合がある。

失敗時の復旧と反証

誤った版を昇格した場合、以前のポインタへ戻す操作と、実行環境が以前の内容を取得して稼働することを区別する。復旧対象の依存物が削除されている、外部モデルが廃止されている、データ形式が変わっている場合には単純復旧できない。保持期限、依存物の保全、実際の取得試験、互換性検査を事前に行う必要がある。

一方、全ての実験を永続登録すると、探索の速度と管理コストが悪化する。短期実験と、他者が再利用する版、業務配備の承認版では保持と検査の強度を変えてよい。ただし配備したものを後から特定できない状態は避ける。「統合レジストリ一つに集約すること」自体が目的ではなく、複数の保管先をまたいでも参照と承認の対応を追えることが重要である。

出典・確認範囲

2026-10-20に一次資料を確認。横断設計と事例は本稿の提案。

よくある失敗・反証

  • 誤った版を昇格した場合、以前のポインタへ戻す操作と、実行環境が以前の内容を取得して稼働することを区別する。復旧対象の依存物が削除されている、外部モデルが廃止されている、データ形式が変わっている場合には単純復旧できない。保持期限、依存物の保全、実際の取得試験、互換性検査を事前に行う必要がある。

    一方、全ての実験を永続登録すると、探索の速度と管理コストが悪化する。短期実験と、他者が再利用する版、業務配備の承認版では保持と検査の強度を変えてよい。ただし配備したものを後から特定できない状態は避ける。「統合レジストリ一つに集約すること」自体が目的ではなく、複数の保管先をまたいでも参照と承認の対応を追えることが重要である。

まだ確認できていないこと

  • EA-263-UNKNOWN-01
    • 利用する製品のエージェント成果物形式、認証方式、署名検証、削除・保持条件、依存解決の原子性は未確定。
    • 実レジストリへの登録、エイリアス切替、取得ハッシュ検証、キャッシュ失効、緊急失効・復旧の試験はNOT_RUN。
    • 旧EA-263退避記録は所在調査のみ。既存の完成候補は確認できず、本候補は独立した記事・パッケージとして監査に渡す。

根拠資料

  • 研究資料研究資料

    [S1] MLflow Prompt Registry:

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    [S2] MLflow モデル Registry:

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    [S3] SLSA v1.2 出典・来歴:

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    歴史的所在記録:

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

更新履歴

  1. EA-263-RESEARCH-20261020-R1: 正式な 監査/publication 対応付け

出典ID・検証情報・機械可読データ

根拠の種類と情報の鮮度は、ラベルとアイコンで確認できます。

記事ID
EA-263
最終確認日
2026-10-20
提供元・モデル・プラン・利用環境
—
対象地域
—
元資料の全文と収録照合記録
要点と前提

AIの成果物レジストリは、モデル、プロンプト、エージェントの実行定義を識別し、評価や承認の記録と結び付けて利用先へ渡す管理面である。ファイルを置くことだけでは足りない。「何を評価したか」「何を承認したか」「実際に何が読み込まれたか」を同じ識別子へ結び付けることが目的になる。レジストリを導入しても、登録物の品質、データ利用権、ツール操作の安全性が自動的に保証されるわけではない。

管理対象と識別単位

モデルの重みを保存する場合と、外部モデルAPIの名前だけを登録する場合は、再現性の範囲が違う。後者は外部提供者が公開する版情報、設定、取得時刻を残せても、重みの不変性を自社で検証できないことがある。これを「モデル全体の保管」と表現しない。

プロンプトは本文に加え、テンプレート変数、出力スキーマ、推奨モデル設定、利用上の制約を持つ。エージェントは、実行コード・依存ライブラリ、プロンプト、モデル、ツール定義、認可ポリシー、検索先への参照が組み合わさる。単一のZIPだけでなく、依存物の版と関係を解決できる構造が必要になる。検索文書や秘密情報を無条件に同梱するのではなく、管理境界、参照先、保持責任を分ける。

情報例固定・更新の扱い
内容の識別ファイルの暗号学的ハッシュ、レジストリ版承認済み内容を上書きせず、新版を作る
依存の識別コードコミット、プロンプト版、モデル版、インデックス版参照解決した組合せを保存する
可変ポインタproduction、champion等のエイリアス変更者、旧値、新値、承認、適用時刻を記録する
評価・承認評価集合と結果、用途・環境、期限対象の内容識別子へ結び付ける
来歴ソース、ビルド主体、実行条件、生成物信頼できる主体と検証手順を別途定める
利用制約ライセンス、機密区分、ツール権限配備先の権限制御へ反映し、単なるタグで済ませない

ここで示す横断的な登録項目は設計提案であり、一製品がすべて同じ形式で実装するという意味ではない。

不変の版と可変エイリアス

MLflowのPrompt Registryは、不変のプロンプト版と、版への可変エイリアスを区別する。[S1] Model Registryにもモデル版を参照するエイリアスがある。[S2] 「productionを評価した」という記録だけでは、後日にポインタが変更されたとき、当時の実体を特定できない。評価時と昇格時には参照を解決し、その結果を保存する。

エイリアスの変更だけで迅速に昇格できることは利点だが、依存の一部分だけが進む危険もある。たとえばエージェントの出力パーサが旧JSON形式を期待する一方、プロンプトのproductionだけが新形式へ変わると、個々の登録物が正常でも連鎖は失敗する。対策は、互換性を評価した組合せのリリース定義を作り、配備先がその定義から全参照を解決すること。複数の独立したエイリアスを順次書き換える場合には、部分適用時の挙動と復旧手順も設計する。

登録から利用まで

登録時には形式、必要ファイル、ハッシュ、利用許諾、秘密情報混入を検査する。形式検査を通過した状態と、業務利用を承認された状態を区別する。評価結果には入力集合と評価器の版、失敗例、利用可能な範囲を含め、内容のハッシュへ紐付ける。評価後に内容を上書きできれば承認の意味が崩れるため、承認対象は不変の版とする。

昇格時には、申請者と承認者の権限、対象環境、期限、依存物の利用可能性を確認する。取得側は登録された名前だけでなく、解決した版と取得物のハッシュを照合し、起動記録へ残す。ランタイムが参照や内容をキャッシュする構成では、ポインタ変更直後にすべての実行が切り替わるとは限らない。更新方式、キャッシュの失効条件、稼働版の読戻しを、実装に応じて確認する。

実行中のエージェントが途中で別版を読み込むことも避けたい。長い処理では開始時にリリース定義を固定し、後続ステップにも引き継ぐ設計を検討する。ただし脆弱性対応や権限失効を、その固定を理由に無期限に延期しない。緊急停止や再認可を行う制御は、通常の版固定とは別の運用責任として定める。

来歴と信頼の限界

SLSAの来歴は、生成物とその作成過程を追跡する情報である。[S3] ハッシュが一致しても、その生成物が安全なコードであること、学習データの権利が適切であること、回答が正しいことまでは分からない。署名を用いるなら、誰の鍵を信頼するか、検証をどこで強制するか、鍵失効後に何を拒否するかを決める。署名ファイルを置くだけでは取得側の検証にならない。

機密プロンプトを誰でもダウンロードできるレジストリへ集約すれば、監査可能性は上がっても漏えい範囲が広がる。登録、承認、取得、削除の権限を分け、用途ごとのアクセスと監査ログを設計する。プロンプトにAPIキーを埋め込まず、実行時に適切な権限で秘密管理先から取得する。ログや評価データにも、プロンプトと同じ機密性が及ぶ場合がある。

失敗時の復旧と反証

誤った版を昇格した場合、以前のポインタへ戻す操作と、実行環境が以前の内容を取得して稼働することを区別する。復旧対象の依存物が削除されている、外部モデルが廃止されている、データ形式が変わっている場合には単純復旧できない。保持期限、依存物の保全、実際の取得試験、互換性検査を事前に行う必要がある。

一方、全ての実験を永続登録すると、探索の速度と管理コストが悪化する。短期実験と、他者が再利用する版、業務配備の承認版では保持と検査の強度を変えてよい。ただし配備したものを後から特定できない状態は避ける。「統合レジストリ一つに集約すること」自体が目的ではなく、複数の保管先をまたいでも参照と承認の対応を追えることが重要である。

OPEN_UNKNOWN
  • 利用する製品のエージェント成果物形式、認証方式、署名検証、削除・保持条件、依存解決の原子性は未確定。
  • 実レジストリへの登録、エイリアス切替、取得ハッシュ検証、キャッシュ失効、緊急失効・復旧の試験はNOT_RUN。
  • 旧EA-263退避記録は所在調査のみ。既存の完成候補は確認できず、本候補は独立した記事・パッケージとして監査に渡す。
SAFE_WORDING

「登録物の版、来歴、評価、承認、実際の取得物を結び付ける基盤として利用できる」。一方、「登録済みだから安全」「エイリアス名が同じなら内容も同じ」「ハッシュ一致で業務品質まで証明済み」とはしない。

出典・確認範囲

2026-10-20に一次資料を確認。横断設計と事例は本稿の提案。

  • EVD-EA-263-URL-118388C854B6研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    [S1] MLflow Prompt Registry:

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-263-URL-118388C854B6
    検証箇所
    出典・確認範囲 · S1 · - [S1] MLflow Prompt Registry: https://mlflow.org/docs/latest/genai/prompt-registry/
    適用範囲
    出典・確認範囲
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-263-URL-B3B7EFD6E280研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    [S2] MLflow Model Registry:

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-263-URL-B3B7EFD6E280
    検証箇所
    出典・確認範囲 · S2 · - [S2] MLflow Model Registry: https://mlflow.org/docs/latest/ml/model-registry/
    適用範囲
    出典・確認範囲
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-263-URL-CADCB59633F1研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    [S3] SLSA v1.2 Provenance:

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-263-URL-CADCB59633F1
    検証箇所
    出典・確認範囲 · S3 · - [S3] SLSA v1.2 Provenance: https://slsa.dev/spec/v1.2/provenance
    適用範囲
    出典・確認範囲
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-263-URL-FB87768384BB研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    歴史的所在記録:

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-263-URL-FB87768384BB
    検証箇所
    出典・確認範囲 · - 歴史的所在記録: https://docs.google.com/document/d/1Vd0BP7G2UyPDRQs_-8dPvTgQ78Tk6kcVGuMJjqNdr84/edit
    適用範囲
    出典・確認範囲
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EA-263-CURRENT-APPROVAL研究資料研究資料根拠の出所: AUDITED_CANONICAL_RESEARCH_PACKET

    現行本文の監査・revision対応

    裏付ける内容
    現行台帳のAUDIT_PASSと候補・revision・本文ハッシュの対応を確認しています。
    確認日
    —
    出典・実験ID
    MANUAL-EA263-DRAIN-20261020-C1
    検証箇所
    1KqhJtiSb2S84rWmeYVwKcT_76dBwZ_B0ZZuAWQqH0rQ/EA_REVISION_LEDGER#ea_id=EA-263&revision_id=EA-263-RESEARCH-20261020-R1&candidate_id=MANUAL-EA263-DRAIN-20261020-C1 · EA-263-RESEARCH-20261020-R1
    適用範囲
    —
    出典・来歴
    CURRENT_CANONICAL_APPROVAL_READBACK
    限界
    監査状態と来歴の記録です。外部根拠の最新性や本文の全主張を追加保証しません。
  • EA-263-CURRENT-BODY-READBACK実装資料実装資料根拠の出所: IMPLEMENTATION_READBACK

    現行本文の収録照合

    裏付ける内容
    公開生成入力の本文SHA-256が、監査済み候補に結び付いたハッシュと一致しています。
    確認日
    2026-10-21
    出典・実験ID
    BODY-SHA256:a40670963a4d8599a612db4733538e09f8a99c9050078621e8ea8bf1b5ff1f95
    検証箇所
    content/staging/EA-263.md · a40670963a4d8599a612db4733538e09f8a99c9050078621e8ea8bf1b5ff1f95 · EA-263-RESEARCH-20261020-R1
    適用範囲
    —
    出典・来歴
    CURRENT_APPROVED_BODY_HASH_MATCH
    限界
    本文の同一性の検査です。外部システムの挙動や全主張の真偽を実証したものではありません。
出典ID
MANUAL-EA263-DRAIN-20261020-C1, SRC-EA-263-URL-118388C854B6, SRC-EA-263-URL-B3B7EFD6E280, SRC-EA-263-URL-CADCB59633F1, SRC-EA-263-URL-FB87768384BB, BODY-SHA256:a40670963a4d8599a612db4733538e09f8a99c9050078621e8ea8bf1b5ff1f95
追跡中のUNKNOWN ID
EA-263-UNKNOWN-01
再確認のきっかけ
正式な 改訂版/publication 状態 change · 本文 成果物 hash change · 出典 現行性 change · new contradiction or 実装 結果の照合

機械検査: 通過 — 機械検査の結果です。情報の正確性や実行の承認を保証するものではありません。

    同じ記事IDの機械可読データです。