platform-guideline checked

OpenAI conversation state guide

Documents multi-turn conversation state, durable conversation identifiers, messages, tool calls, tool outputs, and response chaining across turns.

Open source

Pattern Decisions This Source Supports

Pattern Supported decision Required contract Claim note
Agent plan preview Choose agent plan preview when an AI agent's proposed multi-step execution needs review before it starts. The preview names the objective, plan version, source context, model or workflow instructions, planned tools, and expected output before run. Supports state, messages, tool calls, tool outputs, and response chaining that affect agent plans.
AI agent acts without approval Flag this anti-pattern when an AI agent or automation executes a high-impact side effect without showing and requiring approval for the exact action and payload first. The agent distinguishes read-only steps, draft steps, reversible local changes, and external side-effect steps before execution. Supports durable conversation, tool calls, tool outputs, and response chaining that affect agent state and side effects.
Chat interface Choose chat interface when the user task depends on turn-taking, follow-up prompts, assistant responses, and conversation history rather than a single request field. Every user-visible answer is tied to the exact user message and visible context that produced it. Supports multi-turn conversation state, durable conversation identifiers, messages, tool calls, tool outputs, and response chaining.
Correction feedback Choose correction feedback when users need to correct AI output, source use, assumptions, recommendations, safety behavior, or answer quality after an AI response is shown. A correction feedback action preserves answer ID, response version, claim span, source ID, user reason, expected correction, submitter, timestamp, and chosen scope. Supports preserving conversation, message, response, and tool identity for attaching correction feedback.
Regenerate / retry Choose regenerate / retry when the task is rerunning an AI response attempt, creating a new answer version, continuing a failed generation, or recovering from failed AI source or tool work. Retry same prompt repeats the submitted prompt and visible context unless the UI explicitly shows which context changed. Supports preserving conversation, prompt, response, and tool state across response attempts.
Scope clarification Choose scope clarification when the AI needs a missing boundary before producing a reliable answer, plan, retrieval query, or tool action. The system identifies what boundary is missing before asking the user to clarify. Supports preserving original request and clarification answer across AI turns.
Tool-use visibility Choose tool-use visibility when users need to inspect exact tool names, purposes, inputs, outputs, permissions, side effects, failures, or redactions. Each tool-use item identifies one tool call or tool-call attempt with stable call ID, run ID, step ID, tool name, status, timestamp, and permission scope. Supports exposing tool calls, tool outputs, and response chaining as structured conversational state.

Evidence Role

This source is treated as platform-guideline evidence. Use it to validate the decision rules above, not as a visual style reference.

Publisher: OpenAI. Last checked: .