openai · OpenAI Platform Docs
Using realtime models
Instructions for designing and optimizing prompts for gpt-realtime-2 models, including managing reasoning effort, structuring preambles, and defining precise tool-calling behaviors and guardrails.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Using realtime models
Instructions for designing and optimizing prompts for gpt-realtime-2 models, including managing reasoning effort, structuring preambles, and defining precise tool-calling behaviors and guardrails.
When To Use
Use when you need to configure reasoning effort, structure preambles, or define precise tool-calling and instruction rules for low-latency speech-to-speech agents.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/using-realtime-models-workflow-guide.md | A guide detailing recommended prompt structures and changes for gpt-realtime-2 reasoning voice models. | Questions about a guide detailing recommended prompt structures and changes for gpt-realtime-2 reasoning voice models. |
examples/using-realtime-models-openai-realtime-models-prompting-guide.text | A text guide outlining strategies for role definition, personality, tone, and tool usage when prompting realtime models. | Exact payloads, commands, or snippets shown in A text guide outlining strategies for role definition, personality, tone, and tool usage when prompting realtime models. |
examples/using-realtime-models-openai-realtime-models-prompting-guidelines.text | Guidelines for prompting realtime models regarding reasoning strategies for direct answers versus multi-step tasks. | Exact payloads, commands, or snippets shown in Guidelines for prompting realtime models regarding reasoning strategies for direct answers versus multi-step tasks. |
examples/using-realtime-models-openai-realtime-models-preamble-guidelines.text | Guidelines and best practices for using short preambles when prompting realtime models to manage user expectations during tool calls or multi-step reasoning. | Exact payloads, commands, or snippets shown in Guidelines and best practices for using short preambles when prompting realtime models to manage user expectations du... |
examples/using-realtime-models-openai-realtime-models-prompting-verbosity-guideli.text | Textual guidelines for controlling response verbosity and interaction patterns when prompting OpenAI realtime models. | Exact payloads, commands, or snippets shown in Textual guidelines for controlling response verbosity and interaction patterns when prompting OpenAI realtime models. |
examples/using-realtime-models-openai-realtime-models-tool-usage-instructions.text | Guidelines and instructions for the correct usage of tools within realtime model prompting. | Exact payloads, commands, or snippets shown in Guidelines and instructions for the correct usage of tools within realtime model prompting. |
examples/using-realtime-models-openai-realtime-models-tool-failure-prompting-guid.text | Guidelines for instructing realtime models on how to handle and communicate tool call failures to users. | Exact payloads, commands, or snippets shown in Guidelines for instructing realtime models on how to handle and communicate tool call failures to users. |
examples/using-realtime-models-openai-realtime-models-tool-availability-prompting.text | Text instructions defining how realtime models should handle tool availability and unavailable tool requests. | Exact payloads, commands, or snippets shown in Text instructions defining how realtime models should handle tool availability and unavailable tool requests. |
examples/using-realtime-models-openai-realtime-models-waitforuser-tool-definition.json | A JSON object defining the waitforuser tool used to end a turn without a spoken response in realtime models. | Exact payloads, commands, or snippets shown in A JSON object defining the waitforuser tool used to end a turn without a spoken response in realtime models. |
examples/using-realtime-models-openai-realtime-models-silence-and-background-nois.text | Text instructions for managing silence and background noise when using realtime models by calling the waitforuser tool. | Exact payloads, commands, or snippets shown in Text instructions for managing silence and background noise when using realtime models by calling the waitforuser tool. |
examples/using-realtime-models-openai-realtime-models-prompting-guidelines-2.text | Instructions and best practices for prompting realtime models to provide commentary before executing tool calls. | Exact payloads, commands, or snippets shown in Instructions and best practices for prompting realtime models to provide commentary before executing tool calls. |
examples/using-realtime-models-openai-realtime-models-prompting-phase.text | An example showing the structure of model output phases including commentary and final answer for realtime models. | Exact payloads, commands, or snippets shown in An example showing the structure of model output phases including commentary and final answer for realtime models. |
examples/using-realtime-models-openai-realtime-models-prompting-response-event.json | A JSON object representing a response.done event containing output audio transcripts and phase transitions for a realtime model session. | Exact payloads, commands, or snippets shown in A JSON object representing a response.done event containing output audio transcripts and phase transitions for a real... |
examples/using-realtime-models-openai-realtime-models-prompting-instructions.text | System instructions for guiding realtime models to handle unclear audio and request clarification. | Exact payloads, commands, or snippets shown in System instructions for guiding realtime models to handle unclear audio and request clarification. |
examples/using-realtime-models-openai-realtime-models-entity-collection-prompting.text | Text instructions for prompting realtime models to collect required entity values one at a time. | Exact payloads, commands, or snippets shown in Text instructions for prompting realtime models to collect required entity values one at a time. |
examples/using-realtime-models-openai-realtime-models-prompting-spelled-out-chara.text | Textual examples demonstrating how to format spoken sequences and separators for realtime model prompting. | Exact payloads, commands, or snippets shown in Textual examples demonstrating how to format spoken sequences and separators for realtime model prompting. |
examples/using-realtime-models-openai-realtime-models-spoken-number-handling-exam.text | A list of text examples demonstrating how to convert various spoken number formats into numeric digits for realtime model prompting. | Exact payloads, commands, or snippets shown in A list of text examples demonstrating how to convert various spoken number formats into numeric digits for realtime m... |
examples/using-realtime-models-openai-realtime-models-prompting-exact-identifier-.text | A text-based prompt instruction for realtime models to ensure high-precision confirmation of numeric identifiers before tool execution. | Exact payloads, commands, or snippets shown in A text-based prompt instruction for realtime models to ensure high-precision confirmation of numeric identifiers befo... |
examples/using-realtime-models-openai-realtime-models-prompting-email-confirmatio.text | A text guide providing prompting strategies and conversational examples for ensuring accurate email address capture using realtime models. | Exact payloads, commands, or snippets shown in A text guide providing prompting strategies and conversational examples for ensuring accurate email address capture u... |
examples/using-realtime-models-openai-realtime-models-entity-collection-workflow-.text | A text-based prompt instruction defining a workflow for collecting and confirming exact values like order IDs and email addresses when using realtime models. | Exact payloads, commands, or snippets shown in A text-based prompt instruction defining a workflow for collecting and confirming exact values like order IDs and ema... |
examples/using-realtime-models-openai-realtime-models-prompting-instructions-2.text | Text instructions for prompting realtime models to request user confirmation before executing write actions. | Exact payloads, commands, or snippets shown in Text instructions for prompting realtime models to request user confirmation before executing write actions. |
examples/using-realtime-models-openai-realtime-models-prompting-instructions-3.text | A text file containing system instructions and prompting guidelines for interacting with OpenAI realtime models. | Exact payloads, commands, or snippets shown in A text file containing system instructions and prompting guidelines for interacting with OpenAI realtime models. |
examples/using-realtime-models-openai-realtime-models-prompting-instructions-4.text | Text instructions demonstrating how to prompt realtime models to repeat confirmation codes verbatim and wait for user validation. | Exact payloads, commands, or snippets shown in Text instructions demonstrating how to prompt realtime models to repeat confirmation codes verbatim and wait for user... |
examples/using-realtime-models-openai-realtime-models-prompting-guidelines-3.text | Instructions for prompting realtime models to repeat captured identifiers like order IDs or PINs for user confirmation before executing tool calls. | Exact payloads, commands, or snippets shown in Instructions for prompting realtime models to repeat captured identifiers like order IDs or PINs for user confirmatio... |
examples/using-realtime-models-openai-realtime-models-prompting-instructions-5.text | Text instructions demonstrating how to prompt realtime models to mirror user language, accent, and conversational style. | Exact payloads, commands, or snippets shown in Text instructions demonstrating how to prompt realtime models to mirror user language, accent, and conversational style. |
examples/using-realtime-models-openai-realtime-models-prompting-language-instruct.text | System instructions for configuring language detection and response behavior in realtime models. | Exact payloads, commands, or snippets shown in System instructions for configuring language detection and response behavior in realtime models. |
examples/using-realtime-models-openai-realtime-models-prompting-language-guidelin.text | Instructions for prompting realtime models regarding language switching and substantive utterance detection. | Exact payloads, commands, or snippets shown in Instructions for prompting realtime models regarding language switching and substantive utterance detection. |
examples/using-realtime-models-openai-realtime-models-prompting.text | A text-based example demonstrating how to provide system instructions for prompting realtime models, such as requesting a specific accent. | Exact payloads, commands, or snippets shown in A text-based example demonstrating how to provide system instructions for prompting realtime models, such as requesti... |
examples/using-realtime-models-openai-realtime-models-accent-prompting.text | A text-based prompt example demonstrating how to instruct realtime models to maintain a specific Australian accent. | Exact payloads, commands, or snippets shown in A text-based prompt example demonstrating how to instruct realtime models to maintain a specific Australian accent. |
examples/using-realtime-models-openai-realtime-models-prompting-context-template.text | A text template demonstrating how to structure context, current state, and authoritative sources for prompting realtime models. | Exact payloads, commands, or snippets shown in A text template demonstrating how to structure context, current state, and authoritative sources for prompting realti... |
examples/using-realtime-models-openai-realtime-models-prompting-system-instructio.text | A structured text template defining roles, personality, context, and conversation flow for prompting OpenAI realtime models. | Exact payloads, commands, or snippets shown in A structured text template defining roles, personality, context, and conversation flow for prompting OpenAI realtime... |
examples/using-realtime-models-openai-realtime-models-prompting-system-role.text | A text file demonstrating a system role prompt for a Quebecois French-speaking customer service bot using realtime models. | Exact payloads, commands, or snippets shown in A text file demonstrating a system role prompt for a Quebecois French-speaking customer service bot using realtime mo... |
examples/using-realtime-models-openai-realtime-models-prompting-system-instructio-2.text | A text file containing a system prompt designed to instruct a realtime model to act as a high-energy game-show host. | Exact payloads, commands, or snippets shown in A text file containing a system prompt designed to instruct a realtime model to act as a high-energy game-show host. |
examples/using-realtime-models-openai-realtime-models-personality-tone-prompt.text | A text file defining the personality and tone instructions for a realtime model customer service assistant. | Exact payloads, commands, or snippets shown in A text file defining the personality and tone instructions for a realtime model customer service assistant. |
examples/using-realtime-models-openai-realtime-models-prompting-personality-tone.text | A text-based prompt example demonstrating how to instruct realtime models to transition through different emotional states and tones. | Exact payloads, commands, or snippets shown in A text-based prompt example demonstrating how to instruct realtime models to transition through different emotional s... |
examples/using-realtime-models-openai-realtime-models-personality-and-tone-prompt.text | A text-based prompt template defining personality, tone, length, and pacing instructions for realtime models. | Exact payloads, commands, or snippets shown in A text-based prompt template defining personality, tone, length, and pacing instructions for realtime models. |
examples/using-realtime-models-openai-realtime-models-personality-and-tone-prompt-2.text | A text-based system prompt defining the personality, tone, length, and language constraints for a realtime model customer service assistant. | Exact payloads, commands, or snippets shown in A text-based system prompt defining the personality, tone, length, and language constraints for a realtime model cust... |
examples/using-realtime-models-openai-realtime-models-prompting-system-instructio-3.text | A text file containing system instructions and persona definitions for configuring a realtime model as a French language tutor. | Exact payloads, commands, or snippets shown in A text file containing system instructions and persona definitions for configuring a realtime model as a French langu... |
examples/using-realtime-models-openai-realtime-models-personality-and-tone-prompt-3.text | A text-based system prompt defining the personality, tone, and linguistic constraints for a realtime model customer service assistant. | Exact payloads, commands, or snippets shown in A text-based system prompt defining the personality, tone, and linguistic constraints for a realtime model customer s... |
examples/using-realtime-models-openai-realtime-models-pronunciation-reference.text | A list of specific phonetic pronunciation guidelines for technical terms and proper nouns to be used with realtime models. | Exact payloads, commands, or snippets shown in A list of specific phonetic pronunciation guidelines for technical terms and proper nouns to be used with realtime mo... |
examples/using-realtime-models-openai-realtime-models-prompting-instructions-6.text | A text file containing specific instructions and rules for prompting realtime models to format number and code speech output. | Exact payloads, commands, or snippets shown in A text file containing specific instructions and rules for prompting realtime models to format number and code speech... |
examples/using-realtime-models-openai-realtime-models-prompting-instructions.txt | A text file containing system instructions and conversation examples for prompting realtime models to perform specific tasks like phone number verification. | Exact payloads, commands, or snippets shown in A text file containing system instructions and conversation examples for prompting realtime models to perform specifi... |
examples/using-realtime-models-openai-realtime-models-prompt-critique-expert-role.text | A text-based system prompt defining the role and instructions for a Prompt-Critique Expert designed for realtime models. | Exact payloads, commands, or snippets shown in A text-based system prompt defining the role and instructions for a Prompt-Critique Expert designed for realtime models. |
examples/using-realtime-models-openai-realtime-models-prompt-refinement-template.text | A text template used to structure a prompt and issue description for refining realtime model instructions. | Exact payloads, commands, or snippets shown in A text template used to structure a prompt and issue description for refining realtime model instructions. |
examples/using-realtime-models-openai-realtime-models-prompting-instructions-7.text | A text file containing system instructions and rules for guiding the behavior of realtime models, including handling unclear audio and language consistency. | Exact payloads, commands, or snippets shown in A text file containing system instructions and rules for guiding the behavior of realtime models, including handling... |
examples/using-realtime-models-openai-realtime-models-prompting-instructions-8.text | A text file containing system instructions and rules for configuring realtime model behavior. | Exact payloads, commands, or snippets shown in A text file containing system instructions and rules for configuring realtime model behavior. |
examples/using-realtime-models-openai-realtime-models-tools-prompting.text | A text-based example demonstrating how to define and use tool definitions within realtime model prompts. | Exact payloads, commands, or snippets shown in A text-based example demonstrating how to define and use tool definitions within realtime model prompts. |
examples/using-realtime-models-openai-realtime-models-prompting-tool-definitions.json | A JSON object containing tool definitions and function schemas for prompting realtime models. | Exact payloads, commands, or snippets shown in A JSON object containing tool definitions and function schemas for prompting realtime models. |
examples/using-realtime-models-openai-realtime-models-prompting-tools-guidelines.text | Text instructions outlining how to prompt realtime models to use tools effectively by providing verbal confirmation before execution. | Exact payloads, commands, or snippets shown in Text instructions outlining how to prompt realtime models to use tools effectively by providing verbal confirmation b... |
examples/using-realtime-models-openai-realtime-models-python-tool-definition.python | A Python code snippet demonstrating how to define tool structures for use with OpenAI realtime models. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to define tool structures for use with OpenAI realtime models. |
examples/using-realtime-models-openai-realtime-models-prompting-tools-instruction.text | Text instructions for prompting realtime models regarding tool usage and proactive behavior. | Exact payloads, commands, or snippets shown in Text instructions for prompting realtime models regarding tool usage and proactive behavior. |
examples/using-realtime-models-openai-realtime-models-tool-definitions.text | A text-based list of tool definitions and usage guidelines for prompting realtime models. | Exact payloads, commands, or snippets shown in A text-based list of tool definitions and usage guidelines for prompting realtime models. |
examples/using-realtime-models-openai-realtime-models-prompting-tool-instructions.text | Text instructions defining tool-calling behaviors and preamble requirements for realtime model prompting. | Exact payloads, commands, or snippets shown in Text instructions defining tool-calling behaviors and preamble requirements for realtime model prompting. |
examples/using-realtime-models-openai-realtime-models-prompting.python | A Python example demonstrating how to structure prompts for interacting with OpenAI realtime models. | Exact payloads, commands, or snippets shown in A Python example demonstrating how to structure prompts for interacting with OpenAI realtime models. |
examples/using-realtime-models-openai-realtime-models-prompting.json | A JSON object demonstrating prompt configuration and response parameters for interacting with OpenAI realtime models. | Exact payloads, commands, or snippets shown in A JSON object demonstrating prompt configuration and response parameters for interacting with OpenAI realtime models. |
examples/using-realtime-models-openai-realtime-models-tools-supervisor-definition.text | A text definition of the Tools Supervisor tool including its name, purpose, and invocation logic for realtime models. | Exact payloads, commands, or snippets shown in A text definition of the Tools Supervisor tool including its name, purpose, and invocation logic for realtime models. |
examples/using-realtime-models-openai-realtime-models-prompting-function-definiti.text | A text file defining function schemas for realtime model prompting, including answer, escalatetohuman, and finishsession operations. | Exact payloads, commands, or snippets shown in A text file defining function schemas for realtime model prompting, including answer, escalatetohuman, and finishsess... |
examples/using-realtime-models-openai-realtime-models-conversation-flow-prompt.text | A text-based conversation flow template designed to guide realtime model responses for a customer support scenario. | Exact payloads, commands, or snippets shown in A text-based conversation flow template designed to guide realtime model responses for a customer support scenario. |
examples/using-realtime-models-openai-realtime-models-prompting-sample-phrases.text | A collection of sample phrases for acknowledgements, clarifiers, bridges, and empathy to guide realtime model prompting. | Exact payloads, commands, or snippets shown in A collection of sample phrases for acknowledgements, clarifiers, bridges, and empathy to guide realtime model prompting. |
examples/using-realtime-models-openai-realtime-models-conversation-flow-prompt-2.text | A text-based prompt template defining conversation flow and response guidelines for a realtime model acting as internet support. | Exact payloads, commands, or snippets shown in A text-based prompt template defining conversation flow and response guidelines for a realtime model acting as intern... |
examples/using-realtime-models-openai-realtime-models-conversation-states.json | A JSON object defining various conversation states and instructions for prompting realtime models. | Exact payloads, commands, or snippets shown in A JSON object defining various conversation states and instructions for prompting realtime models. |
examples/using-realtime-models-openai-realtime-models-python-state-transition-too.python | A Python implementation of a state transition tool for managing state changes within realtime model prompting. | Exact payloads, commands, or snippets shown in A Python implementation of a state transition tool for managing state changes within realtime model prompting. |
examples/using-realtime-models-openai-realtime-models-safety-escalation-guideline.text | Guidelines for identifying safety risks and determining when to escalate user interactions in realtime model sessions. | Exact payloads, commands, or snippets shown in Guidelines for identifying safety risks and determining when to escalate user interactions in realtime model sessions. |
What This Skill Covers
- gpt-realtime-2 is our state-of-the-art reasoning voice model for low-latency speech-to-speech applications. It can think before it speaks, follow instruction...
- Main sections:
Choose a model,Realtime 2.0 Prompting Guide,What changed in Realtime 2,Recommended prompt structure,Set reasoning effort.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.openai.com/api/docs/guides/realtime-models-prompting.md