Prompt Objects 廃止は「prompt を管理画面で育てる運用」をやめる合図
このノートは原文の代替ではありません。読むべきポイントと実装上の意味を整理し、原典への入口を示します。
要点まとめ
- OpenAI は、本番で使う prompt を管理画面に置き続ける運用から離れろと明確に言い始めた。
- 主張の中心は書き方変更ではなく、prompt 文面をコードレビュー、テスト、ロールバックが効く場所へ戻せという運用変更である。
- 公式には 2026-06-03 から prompt 作成の比重を下げ、`v1/prompts` は 2026-11-30 に停止予定だと案内している。
- そのため prompt の変数管理、品質確認テスト、差分レビュー、同じ前半文面の再利用効率まで、repo 側で持つ前提へ寄せ直す必要がある。
何が変わったのか
これまでの例では、Responses API 呼び出し時に `prompt_id`、`version`、`variables` を指定して managed prompt object を参照していました。新しいガイドは、それをやめて `input` に直接 message を渡す形へ置き換えています。加えて、prompt content は source code に置き、動的値は関数引数にし、versioning は git commit、PR review、tests や evals で担えと明示しています。さらに、静的な prefix を先、動的な値を後ろに置くことで prompt caching の恩恵を維持しやすいとも説明しています。
なぜ重要か
日本の PoC では、prompt を『後で dashboard から直せるから便利』という理由で管理画面に残したまま本番へ持ち込みがちです。しかしその形は、監査、再現、レビュー、複数人運用のどれにも弱い。エンジニアだけでなく PM にとっても、prompt を product logic の一部として扱う発想へ切り替える必要があります。これは書式変更ではなく、LLM 機能を普通のソフトウェア変更管理へ戻す話です。
技術的ポイント
- `prompt objects` は OpenAI 側に保存した再利用 prompt 資産で、従来は `prompt_id` と `version` を API 呼び出しで参照できた。今回のガイドは、その managed 参照を縮小し、`input` に直接 message を渡す形へ移せと言っている。
- `evals` は prompt 変更後の品質確認用テスト群で、ここでは prompt をコードに戻すことで、文面変更と評価実験を同じ変更単位にできる点が重要になる。
- `prompt caching` は先頭の同一 prefix が一致すると効きやすい仕組みで、静的 instructions を先、顧客名や issue のような動的変数を後ろへ置く設計が勧められている。
- ガイドは『どの prompt 管理 UI を代替に使うか』までは書いていない。repo 内 template、typed builder、fixture ベース生成などの設計余地が残る。
英日キーワード
| 英語 | 日本語 | 補足 |
|---|---|---|
| prompt objects | 保存済みプロンプトオブジェクト | API から参照していた OpenAI 側の managed prompt 資産。本番運用では code 管理へ戻す方向が示された。 |
| v1/prompts | Prompt APIエンドポイント | OpenAI の prompt object 管理 API。2026-11-30 に shutdown 予定と案内されている。 |
| application code | アプリケーションコード | prompt を review、test、deploy の流れへ戻す置き場所。prompt を product logic として扱う前提になる。 |
| versioning | バージョン管理 | prompt や schema の変化を git などで追跡すること。rollback と原因追跡の前提になる。 |
| evals | 評価セット / 評価実験 | モデルやプロンプト変更の品質を測るためのテスト群。AI機能の CI に近い役割を持つ。 |
| prompt caching | プロンプトキャッシュ | 同一 prefix の再利用で効率を上げる仕組み。静的 instructions を先に置く設計が効きやすい。 |
試すなら
- まず自分のコードベースで `prompt_id` や `v1/prompts` を参照している箇所を列挙する。
- 各 prompt について、静的 instructions、動的変数、few-shot 例を分解し、どこをコード化しどこを data として持つか決める。
- prompt 変更時に最低 1 つの fixture と 1 つの eval を回す運用を入れ、文面変更を PR で見える化する。
- dashboard 上でしか編集していない prompt が残っているなら、担当者交代前に repo 側へ引き取る。
注意点
- ガイドは移行原則を示すが、既存 prompt をどう抽出し、どの粒度で module 化するかは各チーム実装に委ねられる。
- 公開日は公式ガイド上で確認できなかった。ここで確定しているのは 2026-06-03 以降の de-emphasis と 2026-11-30 shutdown 予定だけ。
- prompt をコードに戻しても、レビューなしで main に直接入れるなら再現性問題は解消しない。運用も同時に直す必要がある。