flâneur

Prompt guidance | OpenAI API

developers.openai.com · 38,652 words · saved by 1 readers

GPT-5.5 works best when prompts define the outcome and leave room for the model to choose an efficient solution path. Compared with earlier models, you can often use shorter, more outcome-oriented prompts: describe what good looks like, what constraints matter, what evidence is available, and what the final answer should contain. Avoid carrying over every instruction from an older prompt stack. Legacy prompts often over-specify the process because earlier models needed more help staying on track. With GPT-5.5, that can add noise, narrow the model’s search space, or lead to overly mechanical answers. For more detail on GPT-5.5 behavior changes, start with the Using GPT-5.5 guide. This guide focuses on prompt changes that follow from those behavior changes. The patterns here are starting points. Adapt them to your product surface, tools, evals, and user experience goals. Codex can implement the changes from this guide with the OpenAI Docs Skill. To use this skill in other coding agents,

GPT-5.5 GPT-5.4 GPT-5.3 Codex GPT-5.2 GPT-5.1 GPT-5 GPT-4.1 GPT-5.5 New in GPT-5.5 vs GPT-5.4 Shorter, outcome-first prompts usually work better than process-heavy prompt stacks. More efficient reasoning means `low` and `medium` effort should be re-evaluated before escalating. Preambles, `phase` handling, and assistant-item replay remain important for tool-heavy Responses workflows. Explicit personality, retrieval budgets, and validation rules help shape customer-facing and agentic UX. GPT-5.5 works best when prompts define the outcome and leave room for the model to choose an efficient soluti

saved by

related reading