# OpenAI / GPT：プロンプトと設定の管理

CURRENT_STATUS: UNKNOWN
OBSERVATION: UNOBSERVED
FRESHNESS: UNKNOWN
PAGE_TYPE: reference
CANONICAL_URL: /providers/pm-gpt-core-06
CLAIM_IDS: none
EVIDENCE_IDS: EVD-PM-GPT-CORE-06-URL-BE8E6F5F7CFA, EVD-PM-GPT-CORE-06-URL-BAB0E18B2802, EVD-PM-GPT-CORE-06-URL-55A1AC198FA2, EVD-PM-GPT-CORE-06-URL-D5CB61D0A9F5, EVD-PM-GPT-CORE-06-URL-2A00AD8B85D0, EVD-PM-GPT-CORE-06-URL-52D7FE5E2F70, PM-GPT-CORE-06-DOCUMENT-READBACK
UNKNOWN_IDS: PM-GPT-CORE-06-CURRENTNESS
OPS_IDS: none

## Summary
CORE-06のconfiguration bundle、version/approval lineage、environment diff、canary/rollback契約をOpenAI APIとAgents SDKへ対応づける。対象はResponses APIのinput/instructions、廃止予定のreusable prompt objects、Agents SDK v0.22.0のPrompt/Agent/RunConfig/model settings、model snapshot/aliasである。ChatGPT UI、workspace固有設定、実tenantのprompt管理、deployment、release approval値はOrganization Overlayへ残す。

## Current judgment
CORE-06のconfiguration bundle、version/approval lineage、environment diff、canary/rollback契約をOpenAI APIとAgents SDKへ対応づける。対象はResponses APIのinput/instructions、廃止予定のreusable prompt objects、Agents SDK v0.22.0のPrompt/Agent/RunConfig/model settings、model snapshot/aliasである。ChatGPT UI、workspace固有設定、実tenantのprompt管理、deployment、release approval値はOrganization Overlayへ残す。

## Scope
CORE-06のconfiguration bundle、version/approval lineage、environment diff、canary/rollback契約をOpenAI APIとAgents SDKへ対応づける。対象はResponses APIのinput/instructions、廃止予定のreusable prompt objects、Agents SDK v0.22.0のPrompt/Agent/RunConfig/model settings、model snapshot/aliasである。ChatGPT UI、workspace固有設定、実tenantのprompt管理、deployment、release approval値はOrganization Overlayへ残す。

## Confirmed

## UNKNOWN
- PM-GPT-CORE-06-CURRENTNESS: 原資料の確定版から収録しています。外部根拠の最新性を今回の取込日で確認済みと扱いません。本文の未解決事項・残余制約を保持します。

## Evidence
- EVD-PM-GPT-CORE-06-URL-BE8E6F5F7CFA (RESEARCH): OpenAI Prompting: <[ — https://developers.openai.com/api/docs/guides/prompting
- EVD-PM-GPT-CORE-06-URL-BAB0E18B2802 (RESEARCH): OpenAI Deprecations — reusable prompts: <[ — https://developers.openai.com/api/docs/deprecations
- EVD-PM-GPT-CORE-06-URL-55A1AC198FA2 (RESEARCH): OpenAI migration guide: <[ — https://developers.openai.com/api/docs/guides/prompting/migrate-from-prompt-object
- EVD-PM-GPT-CORE-06-URL-D5CB61D0A9F5 (RESEARCH): Agents SDK v0.22.0 prompts.py: <[ — https://github.com/openai/openai-agents-python/blob/v0.22.0/src/agents/prompts.py
- EVD-PM-GPT-CORE-06-URL-2A00AD8B85D0 (RESEARCH): Agents SDK issue #3321: <[ — https://github.com/openai/openai-agents-python/issues/3321
- EVD-PM-GPT-CORE-06-URL-52D7FE5E2F70 (RESEARCH): Agents SDK v0.22.0 release anchor: <[ — https://github.com/openai/openai-agents-python/releases/tag/v0.22.0
- PM-GPT-CORE-06-DOCUMENT-READBACK (IMPL): 原資料との収録照合

## Practice
CORE-06のconfiguration bundle、version/approval lineage、environment diff、canary/rollback契約をOpenAI APIとAgents SDKへ対応づける。対象はResponses APIのinput/instructions、廃止予定のreusable prompt objects、Agents SDK v0.22.0のPrompt/Agent/RunConfig/model settings、model snapshot/aliasである。ChatGPT UI、workspace固有設定、実tenantのprompt管理、deployment、release approval値はOrganization Overlayへ残す。
## 資料の識別情報
Source SHA-256 346c4230d9e64c366d868dcc6cd2a89af531babdae0dcb4b55fe089eb46a6ad4

## Product Mapping — GPT / CORE-06
PRODUCT_MAPPING_ID: PM-GPT-CORE-06-v0.1

PROVIDER: GPT / OpenAI

CORE_PACKET: PKT-GEMINI-A-CORE-06-v0.1

AS_OF: 2026-09-09 JST

STATUS: PUBLIC_MAPPING_BOUNDED_COMPLETE / PROMPT_OBJECT_MIGRATION_ACTIVE / LIVE_ORG_PENDING

LAYER: PRODUCT_MAPPING (not Enterprise AI Core; not Organization Overlay)

## Scope
CORE-06のconfiguration bundle、version/approval lineage、environment diff、canary/rollback契約をOpenAI APIとAgents SDKへ対応づける。対象はResponses APIのinput/instructions、廃止予定のreusable prompt objects、Agents SDK v0.22.0のPrompt/Agent/RunConfig/model settings、model snapshot/aliasである。ChatGPT UI、workspace固有設定、実tenantのprompt管理、deployment、release approval値はOrganization Overlayへ残す。

## Surface and lifecycle separation
| SURFACE | CURRENT CONFIGURATION EVIDENCE | LIFECYCLE DECISION | LIMIT |
| --- | --- | --- | --- |
| Responses direct input | application codeからmodel、input、instructions等を送る | code/repository releaseの一部としてversion、review、test、feature flag、rollbackを管理 | API requestだけではtool/source/policy/environment/evalを束ねたcomposite releaseにならない |
| reusable prompt object | prompt.id、optional version、variablesで参照可能 | 2026-06-03 deprecated、v1/promptsとobjectsは2026-11-30 shutdown予定。新規release基盤として採用しない | shutdown前の既存利用とforward designを分離。dashboard historyを長期provenanceへ外挿しない |
| Agents SDK v0.22.0 prompt | tagged prompts.pyはid/version/variablesをResponses prompt parameterへ渡す | 固定版に残る移行期adapterとして記録。SDK tag pinだけでprovider object存続を保証しない | prompt object shutdown、provider/API availability、application migrationは別dependency |
| Agents SDK Agent/RunConfig | instructions、prompt、model、model settings、tools、handoffs、guardrails、run-level defaultsを分散設定可能 | effective configをagent objectだけでなくrun/provider/environmentまでcanonicalizeする | display nameまたはAgent定義だけでは実requestのeffective bundleを再構成できない |
| model identity | explicit model、SDK/run default、alias、snapshot、returned modelを分離 | snapshot/aliasとdeprecation calendarをbundleへ固定し、変更時にsentinel/evalを再実行 | provider内部build、silent substitution、tenant rolloutは公開情報だけではUNKNOWN |

## Core → GPT mapping rows
| ROW | CORE CONTRACT | GPT / OPENAI FINDING | DECISION / UNKNOWN |
| --- | --- | --- | --- |
| PM-C06-GPT-001 | versioned prompt/config entity | 旧prompt objectはID/version/variablesを提供するが廃止進行中 | legacy component provenanceとしてのみ保持し、新規構成はcode-managed promptへ移行。prompt versionをcomposite release versionとみなさない |
| PM-C06-GPT-002 | configuration bundle | OpenAIはprompt内容をapplication codeへ移し、typed arguments、Responses input/instructions、tests/evals、git/PR/release tags/feature flagsで管理する方針を示す | Core bundleへcode commit、rendered input、model/runtime/tool/source/policy/environment/eval linkを結合する。公式移行案そのものが完全bundleを自動生成するとは主張しない |
| PM-C06-GPT-003 | temporal/deprecation boundary | reusable prompt creationは2026-06-03からde-emphasized、shutdownは2026-11-30予定 | ACTIVE_DEPRECATED_DEPENDENCYとしてinventory化し、migration owner/deadline/dual-run/rollbackを要求。shutdown予定を現在の即時利用不能とは扱わない |
| PM-C06-GPT-004 | fixed SDK parity | v0.22.0 PromptUtilはstatic/dynamic promptからid/version/variablesを構成しmodel inputへ渡す | tagged code surfaceを固定。SDK supportとAPI lifetimeを分離し、将来互換を推定しない |
| PM-C06-GPT-005 | validation/failure signal | issue #3321はmissing/non-string prompt ID等がearly validationされず、KeyErrorまたはwrong shape転送になると報告。v0.22.0 tagged codeにもstrict field validationは見えない | author repositoryのbounded failure signal。実tenant障害や全path failureへ一般化せず、application schema validationとnegative testを要求 |
| PM-C06-GPT-006 | environment/effective-config diff | Agent、RunConfig、environment default、provider default、model settings、Responses/Chat Completions pathでeffective configが変わり得る | declared/effective/returned configを分離し、surface/SDK/API revision差をmaterialize。Chat Completionsはprompt-managed request非対応というissue記述を全API保証へ拡張しない |
| PM-C06-GPT-007 | rollback/readback | code-managed promptはgit/PR/release tag/feature flagで比較・rollback可能だが、model/tool/source/policy/deploymentは別component | rollbackはprior codeだけで完了せず、effective request、dependencies、eval、deployment、receipt/readbackを再確認。tenant値と実release結果はUNKNOWN |

## Migration and safe verification profile
非機密synthetic fixtureだけを用い、採用repository/SDK/API環境が利用可能な場合に実施する。今回はprovider/API/tenantを操作していない。

- prompt.id/version/variables利用箇所をinventoryし、2026-11-30より前のowner、migration release、rollback期限を付ける。

- legacy objectとcode-managed rendererで同一typed fixtureを生成し、role、順序、escaping、defaults、attachments、tool schema、output contractのcanonical diffを取る。

- missing/empty/non-string ID、version型、variables型をprovider dispatch前に拒否する。

- Agent/RunConfig/environment/provider defaultを一つずつ変え、effective model/settings/tools/prompt/surfaceをrecordする。

- explicit snapshot/aliasとreturned modelを保存し、deprecated model/tool/source dependencyをrelease前にblockする。

- fixed sentinel/task sliceをlegacy/new pathで反復し、単発一致やprompt hash一致だけでbehavior equivalenceを認定しない。

- canary、stop、feature-flag rollback後にeffective request、dependency availability、evaluation acceptanceをread backする。

既存のCORE-06 local 7/7・19/19は本研究のCOMPILER_EXPERIMENTであり、GPT/OpenAIのlive試験へ再分類しない。

## Organization Overlay handoff
- prompt object利用inventory、migration owner、deadline、exception、release window

- repository、reviewer/approver、branch protection、tag、artifact retention

- adopted API/SDK/model/snapshot、default override、feature flag、deployment binding

- tool/source/policy/secret/eval registry、canary traffic、stop threshold、rollback owner

- trace/log/redaction/retention、provider deprecation alert owner、incident escalation

## Provenance
- OpenAI Prompting: <[https://developers.openai.com/api/docs/guides/prompting](https://developers.openai.com/api/docs/guides/prompting)> (accessed 2026-09-09)

- OpenAI Deprecations — reusable prompts: <[https://developers.openai.com/api/docs/deprecations](https://developers.openai.com/api/docs/deprecations)> (accessed 2026-09-09)

- OpenAI migration guide: <[https://developers.openai.com/api/docs/guides/prompting/migrate-from-prompt-object](https://developers.openai.com/api/docs/guides/prompting/migrate-from-prompt-object)> (accessed 2026-09-09)

- Agents SDK v0.22.0 prompts.py: <[https://github.com/openai/openai-agents-python/blob/v0.22.0/src/agents/prompts.py](https://github.com/openai/openai-agents-python/blob/v0.22.0/src/agents/prompts.py)>

- Agents SDK issue #3321: <[https://github.com/openai/openai-agents-python/issues/3321](https://github.com/openai/openai-agents-python/issues/3321)> (opened 2026-05-09; closed; read 2026-09-09)

- Agents SDK v0.22.0 release anchor: <[https://github.com/openai/openai-agents-python/releases/tag/v0.22.0](https://github.com/openai/openai-agents-python/releases/tag/v0.22.0)>

## Exit condition
OpenAIの現行方針がmanaged prompt objectからcode-managed promptへ移行済みであること、2026-11-30 shutdown予定、v0.22.0 SDKに旧object adapterが残る移行期の不一致、field validation failure signalを境界付きで記録した。prompt/version/commitをcomposite release、behavior同値、deployment rollbackへ昇格せず、live/tenant/organization値をUNKNOWNとして移送する。Core claimは変更しないためGemini遡及監査は不要である。

NEXT: /agent/start.json
STOP: This is a knowledge projection, not an execution order.