AI Engineering Tools

生成AIエンジニアリング

AIプロンプト管理・運用用語

本番環境AIシステムで使用されるプロンプトの登録、バージョン管理、構成、承認、デプロイ、追跡、ロールバック、および廃止方法を学習します。

16

アセットとレジストリ

プロンプトアセット

Prompt asset

意味

プロンプトとその関連メタデータ、変数、例、構成、テスト、および所有権情報。

使用場面

プロダクションプロンプトを、匿名コピーされたテキストではなく、管理対象のアプリケーション資産として扱います。

活用例

アセットには、テンプレート、スキーマ、所有者、モデルのバインディング、テストスイート、リスクレベル、およびリリースノートが含まれます。

アセットとレジストリ

プロンプトレジストリまたはストア

Prompt registry or store

意味

プロンプト資産を発見、バージョン管理、比較、および取得できる管理されたカタログ。

使用場面

プロダクションの指示が、ソースファイル、ドキュメント、および個人的なメモに散らばらないようにするために使用します。

活用例

レジストリをユースケース、所有者、ステータス、モデルファミリー、および環境で検索します。

アセットとレジストリ

プロンプトID

Prompt ID

意味

リビジョン間で、論理的なプロンプトの安定した識別子。

使用場面

コード、テレメトリー、および承認に使用し、バージョンによって正確なコンテンツを識別します。

活用例

prompt_id: support.case_summary

バージョンライフサイクル

プロンプトのバージョン

Prompt version

意味

プロンプトの内容と関連する構成の識別可能なリビジョン。

使用場面

再現可能な評価、デプロイメント、インシデント、およびロールバックのために、不変のバージョンを使用します。

活用例

support.case_summary@17 に、内容の要約と sha256: ... が含まれています

バージョンライフサイクル

ドラフト版と公開版

Draft and published version

意味

アプリケーションで使用できる承認された不変の修正と、対比される変更可能な作業修正。

使用場面

イテレーションのためにドラフトを使用し、必要なテストと承認が完了した後にのみ公開します。

活用例

ドラフト18は編集可能ですが、本番環境は引き続き公開されているバージョン17を参照しています。

設定

プロンプト変数

Prompt variable

意味

実行時にリクエスト固有のデータでパブリッシュされる名前付きプレースホルダー。

使用場面

各変数について、型、必須フィールド、エスケープ処理、長さ制限、および信頼レベルを定義します。

注意

承認された設計で明示的に必要とされ、保護されていない限り、機密情報をプロンプト変数に含めないでください。

活用例

Summarize {{case_notes}} for {{audience}} using {{output_schema}}.

設定

プロンプト構成

Prompt configuration

意味

プロンプトに関連付けられているモデル、推論パラメータ、ツール定義、出力スキーマ、およびその他の設定。

使用場面

プロンプトテキストとともに、動作を大きく変更する可能性のあるバージョン設定。

活用例

設定:モデルファミリー、温度、最大出力、スキーマバージョン、有効なツール、タイムアウト。

設定

モデルバインディング

Model binding

意味

プロンプトのバージョンが設計およびテストされる、宣言されたモデルまたはモデルファミリー。

使用場面

テストされていないモデルの移行が、静かに動作を変更しないようにするために使用します。

活用例

プロンプト v17 は、モデルファミリー A のバージョン 2026-05 のみに適用されます。

配信

環境の昇格

Environment promotion

意味

承認されたプロンプトのバージョンを、開発、ステージング、および本番環境に移動します。

使用場面

環境間でテキストを手動でコピーする代わりに、同じ不変バージョンを推奨します。

活用例

dev -> evaluation passed -> staging approval -> production

配信

プロンプトデプロイメント

Prompt deployment

意味

選択されたプロンプトのバージョンと構成を、アプリケーションまたはワークフローで使用できるようにします。

使用場面

ヘルスチェック、監視機能、およびドキュメント化された復旧手順を備えた、識別子でデプロイします。

活用例

`support.case_summary@17`を対象トラフィックの10%にデプロイし、リリースメトリックを監視します。

配信

プロンプトのロールバック

Prompt rollback

意味

問題が見つかった後、承認済みのプロンプトのバージョンにトラフィックを戻します。

使用場面

本番環境へのリリース前に、ロールバックを準備し、リハーサルを行います。

活用例

必須フィールドの精度が閾値を下回った場合は、編集せずにバージョン16を復元します。

ガバナンス

プロンプト変更承認

Prompt change approval

意味

定義された使用および環境のために、プロンプトのバージョンを承認する、文書化されたレビュー決定。

使用場面

外部に公開される、規制対象、財務的、または安全に関わる行動に対して、適切な承認を要求します。

活用例

承認記録には、レビュー担当者、範囲、証拠、制限事項、バージョン、および有効期限が含まれます。

ガバナンス

プロンプトの所有権

Prompt ownership

意味

プロンプトの品質、アクセス、レビュー、インシデント、更新、および廃止に関する責任を割り当てます。

使用場面

プロンプトを本番環境で使用する前に、サービス所有者とバックアップを割り当てます。

活用例

所有者: Support Platform; レビュー担当者: Compliance; 次回レビュー: 2026-10-01。

ガバナンス

プロンプト監査ログ

Prompt audit log

意味

プロンプトの変更、承認、デプロイ、アクセス、およびロールバックの改ざん防止履歴。

使用場面

インシデントを調査し、誰がいつ何を変更したのか、そしてその理由を説明するために使用します。

活用例

actor、timestamp、prompt ID、before、およびafter、versions、action、ticket、およびenvironmentをログに記録します。

観測可能性

プロンプトのトレース

Prompt trace

意味

プロンプトのバージョン、入力、モデル構成、ツールアクティビティ、出力、および評価信号をリンクする、リクエストレベルのレコード。

使用場面

適切な最小化とアクセス制御によるデバッグとパフォーマンス分析に使用します。

注意

トレースには、個人情報、機密情報、または著作権で保護された情報が含まれる可能性があるため、必要に応じて、最小限に抑え、修正し、制限し、期限切れにする必要があります。

活用例

trace_id は、プロンプト v17、編集された入力、モデルのバージョン、レイテンシ、トークン使用量、および検証結果を関連付けます。

バージョンライフサイクル

プロンプトの廃止

Prompt deprecation

意味

プロンプトのバージョンやアセットを、廃止予定としてマークし、新規利用を推奨しません。

使用場面

移行ガイドを公開し、ユーザーを特定し、期限を設定し、削除前にロールバックの証拠を保持します。

活用例

v12を8月1日に廃止し、残りの呼び出し元をv17に移行し、その評価記録をアーカイブします。

最小限のプロダクションプロンプトレコード

レコードその重要性
プロンプトID、不変バージョン、およびコンテンツダイジェスト評価またはリクエストで使用されている正確なアセットを特定します。
モデル、パラメータ、スキーマ、ツール、および変数契約再現可能な動作を可能にし、互換性要件を明らかにします。
所有者、承認者、テスト結果、環境、およびリリース時間権限、準備状況、および運用責任を表示します。
トレースポリシー、監視閾値、およびロールバック対象インシデントの検出、診断、および復旧をサポートします。

よくある質問

なぜ、プロンプトをアプリケーションのソースコードにのみ保持しないのでしょうか?

ソース管理は役立ちますが、本番環境の運用には、プロンプト固有のメタデータ、評価の証拠、承認、環境のプロモーション、リクエストのトレース、所有権、非推奨、およびロールバックリンクが必要です。 これらはコードで構築するか、プロンプトレジストリによって提供できます。

プロンプトのバージョンには、モデルの設定を含めるべきですか?

少なくとも、モデルのバージョン、サポートされているパラメータ、出力スキーマ、ツール定義、および変数契約など、動作を変更する可能性のある設定と依存関係を記録します。 バージョン番号を共有するかどうかは実装上の選択ですが、正確な組み合わせは再現可能でなければなりません。

プロンプトのトレースに保存すべきでない情報はどれですか?

不要な個人データ、認証情報、機密情報、機密のソース資料、または著作権で保護されたコンテンツを保持しないでください。目的の限定、マスキング、アクセス制御、保持期間の制限、削除、および法的または契約上の要件を適用してください。

公式参考資料