openai 0.88.0 → 0.90.0

data/rbi/openai/resources/responses.rbi

@@ -630,15 +630,15 @@ module OpenAI
       # See {OpenAI::Resources::Responses#create} for non-streaming counterpart.
       #
       # Creates a model response. Provide
-      # [text](https://platform.openai.com/docs/guides/text) or
-      # [image](https://platform.openai.com/docs/guides/images) inputs to generate
-      # [text](https://platform.openai.com/docs/guides/text) or
-      # [JSON](https://platform.openai.com/docs/guides/structured-outputs) outputs. Have
+      # [text](https://developers.openai.com/api/docs/guides/text) or
+      # [image](https://developers.openai.com/api/docs/guides/images-vision) inputs to generate
+      # [text](https://developers.openai.com/api/docs/guides/text) or
+      # [JSON](https://developers.openai.com/api/docs/guides/structured-outputs) outputs. Have
       # the model call your own
-      # [custom code](https://platform.openai.com/docs/guides/function-calling) or use
-      # built-in [tools](https://platform.openai.com/docs/guides/tools) like
-      # [web search](https://platform.openai.com/docs/guides/tools-web-search) or
-      # [file search](https://platform.openai.com/docs/guides/tools-file-search) to use
+      # [custom code](https://developers.openai.com/api/docs/guides/function-calling) or use
+      # built-in [tools](https://developers.openai.com/api/docs/guides/tools) like
+      # [web search](https://developers.openai.com/api/docs/guides/tools-web-search) or
+      # [file search](https://developers.openai.com/api/docs/guides/tools-file-search) to use
       # your own data as input for the model's response.
       sig do
         params(
@@ -662,6 +662,8 @@ module OpenAI
           previous_response_id: T.nilable(String),
           prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
           prompt_cache_key: String,
+          prompt_cache_options: T.nilable(OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::OrHash),
+          prompt_cache_retention: T.nilable(OpenAI::Responses::ResponseCreateParams::PromptCacheRetention::OrSymbol),
           reasoning: T.nilable(OpenAI::Reasoning::OrHash),
           response_id: T.nilable(String),
           safety_identifier: String,
@@ -711,7 +713,7 @@ module OpenAI
       end
       def stream(
         # Whether to run the model response in the background.
-        # [Learn more](https://platform.openai.com/docs/guides/background).
+        # [Learn more](https://developers.openai.com/api/docs/guides/background).
         background: nil,
         # Specify additional output data to include in the model response. Currently
         # supported values are:
@@ -734,11 +736,11 @@ module OpenAI
         #
         # Learn more:
         #
-        # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-        # - [Image inputs](https://platform.openai.com/docs/guides/images)
-        # - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
-        # - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
-        # - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+        # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+        # - [Image inputs](https://developers.openai.com/api/docs/guides/images-vision)
+        # - [File inputs](https://developers.openai.com/api/docs/guides/file-inputs)
+        # - [Conversation state](https://developers.openai.com/api/docs/guides/conversation-state)
+        # - [Function calling](https://developers.openai.com/api/docs/guides/function-calling)
         input: nil,
         # A system (or developer) message inserted into the model's context.
         #
@@ -748,7 +750,7 @@ module OpenAI
         instructions: nil,
         # An upper bound for the number of tokens that can be generated for a response,
         # including visible output tokens and
-        # [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+        # [reasoning tokens](https://developers.openai.com/api/docs/guides/reasoning).
         max_output_tokens: nil,
         # The maximum number of total calls to built-in tools that can be processed in a
         # response. This maximum number applies across all built-in tool calls, not per
@@ -762,37 +764,65 @@ module OpenAI
         # Keys are strings with a maximum length of 64 characters. Values are strings with
         # a maximum length of 512 characters.
         metadata: nil,
-        # Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a
-        # wide range of models with different capabilities, performance characteristics,
-        # and price points. Refer to the
-        # [model guide](https://platform.openai.com/docs/models) to browse and compare
-        # available models.
+        # Model ID used to generate the response, like `gpt-6-astra`. OpenAI offers a wide
+        # range of models with different capabilities, performance characteristics, and
+        # price points. Refer to the
+        # [model guide](https://developers.openai.com/api/docs/models) to browse and
+        # compare available models.
         model: nil,
         # Whether to allow the model to run tool calls in parallel.
         parallel_tool_calls: nil,
         # The unique ID of the previous response to the model. Use this to create
         # multi-turn conversations. Learn more about
-        # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+        # [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
+        # Cannot be used in conjunction with `conversation`.
         previous_response_id: nil,
         # Reference to a prompt template and its variables.
-        # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+        # [Learn more](https://developers.openai.com/api/docs/guides/text?api-mode=responses#version-prompts-in-code).
         prompt: nil,
         # Used by OpenAI to cache responses for similar requests to optimize your cache
         # hit rates. Replaces the `user` field.
-        # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+        # [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching).
         prompt_cache_key: nil,
-        # **o-series models only**
+        # Options for prompt caching. Supported for `gpt-5.6` and later models. By
+        # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+        # explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+        # request can write up to four breakpoints. For cache matching, OpenAI considers
+        # up to the latest 80 breakpoints in the conversation, without a content-block
+        # lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+        # `ttl` defaults to `30m`, which is currently the only supported value. See the
+        # [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
+        # for current details.
+        prompt_cache_options: nil,
+        # Deprecated. Use `prompt_cache_options.ttl` instead.
         #
+        # The retention policy for the prompt cache. Set to `24h` to enable extended
+        # prompt caching, which keeps cached prefixes active for longer, up to a maximum
+        # of 24 hours.
+        # [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching#prompt-cache-retention).
+        # This field expresses a maximum retention policy, while
+        # `prompt_cache_options.ttl` expresses a minimum cache lifetime. The two fields
+        # are independent and do not interact. For `gpt-5.5`, `gpt-5.5-pro`, and future
+        # models, only `24h` is supported.
+        #
+        # For older models that support both `in_memory` and `24h`, the default depends on
+        # your organization's data retention policy:
+        #
+        # - Organizations without ZDR enabled default to `24h`.
+        # - Organizations with ZDR enabled default to `in_memory` when
+        #   `prompt_cache_retention` is not specified.
+        prompt_cache_retention: nil,
         # Configuration options for
-        # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+        # [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
         reasoning: nil,
         # The ID of the response whose stream to resume.
         response_id: nil,
         # A stable identifier used to help detect users of your application that may be
         # violating OpenAI's usage policies. The IDs should be a string that uniquely
-        # identifies each user. We recommend hashing their username or email address, in
-        # order to avoid sending us any identifying information.
-        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+        # identifies each user, with a maximum length of 64 characters. We recommend
+        # hashing their username or email address, in order to avoid sending us any
+        # identifying information.
+        # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
         safety_identifier: nil,
         # Specifies the processing type used for serving the request.
         #
@@ -801,10 +831,19 @@ module OpenAI
         #   will use 'default'.
         # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
-        # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-        #   'priority', then the request will be processed with the corresponding service
-        #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-        #   Priority processing.
+        # - If set to
+        #   '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+        #   the request will be processed with the Flex Processing service tier.
+        # - To opt-in to
+        #   [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+        #   request level, include the `service_tier=fast` or `service_tier=priority`
+        #   parameter for Responses or Chat Completions. The response will show
+        #   `service_tier=priority` regardless of if you specify `service_tier=fast` or
+        #   `priority` in your request.
+        # - If set to 'ultrafast', then the request will be processed with the
+        #   access-controlled Ultrafast Processing service tier. This tier is currently
+        #   available for `gpt-5.6-sol`; a response served through it will show
+        #   `service_tier=ultrafast`.
         # - When not set, the default behavior is 'auto'.
         #
         # When the `service_tier` parameter is set, the response body will include the
@@ -825,9 +864,8 @@ module OpenAI
         # Configuration options for a text response from the model. Can be plain text,
         # structured JSON data, or text that conforms to a custom grammar. Learn more:
         #
-        # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-        # - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
-        # - [Custom grammars](https://platform.openai.com/docs/guides/custom-grammars)
+        # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+        # - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
         text: nil,
         # How the model should select which tool (or tools) to use when generating a
         # response. See the `tools` parameter to see how to specify which tools the model
@@ -840,20 +878,19 @@ module OpenAI
         #
         # - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
         #   capabilities, like
-        #   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
-        #   [file search](https://platform.openai.com/docs/guides/tools-file-search).
+        #   [web search](https://developers.openai.com/api/docs/guides/tools-web-search)
+        #   or
+        #   [file search](https://developers.openai.com/api/docs/guides/tools-file-search).
         #   Learn more about
-        #   [built-in tools](https://platform.openai.com/docs/guides/tools).
-        # - **Custom tools**: Free form tools which the model can call with flexible
-        #   inputs and outputs. Learn more about
-        #   [custom tools](https://platform.openai.com/docs/guides/custom-tools).
+        #   [built-in tools](https://developers.openai.com/api/docs/guides/tools).
+        # - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
+        #   predefined connectors such as Google Drive and SharePoint. Learn more about
+        #   [MCP Tools](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
         # - **Function calls (custom tools)**: Functions that are defined by you, enabling
         #   the model to call your own code with strongly typed arguments and outputs.
         #   Learn more about
-        #   [function calling](https://platform.openai.com/docs/guides/function-calling).
-        #   You can also use
-        #   [custom tools](https://platform.openai.com/docs/guides/custom-tools) to call
-        #   your own code.
+        #   [function calling](https://developers.openai.com/api/docs/guides/function-calling).
+        #   You can also use custom tools to call your own code.
         tools: nil,
         # An integer between 0 and 20 specifying the number of most likely tokens to
         # return at each token position, each with an associated log probability.
@@ -876,7 +913,7 @@ module OpenAI
         # `prompt_cache_key` instead to maintain caching optimizations. A stable
         # identifier for your end-users. Used to boost cache hit rates by better bucketing
         # similar requests and to help OpenAI detect and prevent abuse.
-        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+        # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
         user: nil,
         request_options: {}
       )

data/rbi/openai/resources/webhooks.rbi

@@ -25,6 +25,7 @@ module OpenAI
               OpenAI::Webhooks::FineTuningJobFailedWebhookEvent,
               OpenAI::Webhooks::FineTuningJobSucceededWebhookEvent,
               OpenAI::Webhooks::LiveCallIncomingWebhookEvent,
+              OpenAI::Webhooks::LiveTransportIncomingWebhookEvent,
               OpenAI::Webhooks::RealtimeCallIncomingWebhookEvent,
               OpenAI::Webhooks::ResponseCancelledWebhookEvent,
               OpenAI::Webhooks::ResponseCompletedWebhookEvent,

data/sig/openai/client.rbs

@@ -58,6 +58,8 @@ module OpenAI
 
     attr_reader responses: OpenAI::Resources::Responses
 
+    attr_reader live: OpenAI::Resources::Live
+
     attr_reader realtime: OpenAI::Resources::Realtime
 
     attr_reader conversations: OpenAI::Resources::Conversations

data/sig/openai/helpers/agents.rbs

@@ -0,0 +1,50 @@
+module OpenAI
+  module Helpers
+    module Agents
+      type tool_output =
+        String
+        | Hash[String | Symbol, untyped]
+        | Array[OpenAI::Models::Beta::input_content_param
+        | Hash[Symbol, untyped]]
+        | nil
+      type tool_handler = ^(Hash[String, untyped]) -> tool_output
+      class SessionStream
+        include Enumerable[OpenAI::Models::Beta::agent_session_event]
+
+        def each:
+          { (OpenAI::Models::Beta::agent_session_event) -> void } -> self
+          | -> Enumerator[OpenAI::Models::Beta::agent_session_event, self]
+        def close: -> void
+        def until_done: -> self
+      end
+    end
+  end
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          def stream: (
+            String session_id,
+            input: String
+            | Array[OpenAI::Beta::AgentSessionInputMessageParam
+            | Hash[Symbol, untyped]],
+            ?tool_handlers: Hash[String, OpenAI::Helpers::Agents::tool_handler],
+            ?idempotency_key: String?,
+            ?request_options: OpenAI::RequestOptions
+            | Hash[Symbol, untyped]
+            | nil
+          ) ?{
+            (OpenAI::Helpers::Agents::SessionStream) -> void
+          } -> OpenAI::Helpers::Agents::SessionStream
+        end
+      end
+    end
+  end
+  module Models
+    module Beta
+      class AgentSessionMessage
+        def output_text: -> String
+      end
+    end
+  end
+end

data/sig/openai/internal/token_page.rbs

@@ -0,0 +1,15 @@
+module OpenAI
+  module Internal
+    class TokenPage[Elem]
+      include OpenAI::Internal::Type::BasePage[Elem]
+
+      attr_accessor data: ::Array[Elem]?
+
+      attr_accessor has_more: bool
+
+      attr_accessor next_: String?
+
+      def inspect: -> String
+    end
+  end
+end

data/sig/openai/models/beta/agent.rbs

@@ -0,0 +1,96 @@
+module OpenAI
+  module Models
+    module Beta
+      type agent =
+        {
+          id: String,
+          created_at: Integer,
+          instructions: String?,
+          metadata: ::Hash[Symbol, String],
+          model: String,
+          multi_agent: OpenAI::Beta::MultiAgentConfig,
+          name: String?,
+          ?object: :agent,
+          reasoning: OpenAI::Beta::AgentReasoning,
+          service_tier: OpenAI::Models::Beta::Agent::service_tier,
+          text: OpenAI::Beta::AgentText,
+          tools: ::Array[OpenAI::Models::Beta::persisted_agent_tool],
+          updated_at: Integer
+        }
+
+      class Agent < OpenAI::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        attr_accessor created_at: Integer
+
+        attr_accessor instructions: String?
+
+        attr_accessor metadata: ::Hash[Symbol, String]
+
+        attr_accessor model: String
+
+        attr_accessor multi_agent: OpenAI::Beta::MultiAgentConfig
+
+        attr_accessor name: String?
+
+        attr_accessor object: :agent
+
+        attr_accessor reasoning: OpenAI::Beta::AgentReasoning
+
+        attr_accessor service_tier: OpenAI::Models::Beta::Agent::service_tier
+
+        attr_accessor text: OpenAI::Beta::AgentText
+
+        attr_accessor tools: ::Array[OpenAI::Models::Beta::persisted_agent_tool]
+
+        attr_accessor updated_at: Integer
+
+        def initialize: (
+          id: String,
+          created_at: Integer,
+          instructions: String?,
+          metadata: ::Hash[Symbol, String],
+          model: String,
+          multi_agent: OpenAI::Beta::MultiAgentConfig,
+          name: String?,
+          reasoning: OpenAI::Beta::AgentReasoning,
+          service_tier: OpenAI::Models::Beta::Agent::service_tier,
+          text: OpenAI::Beta::AgentText,
+          tools: ::Array[OpenAI::Models::Beta::persisted_agent_tool],
+          updated_at: Integer,
+          ?object: :agent
+        ) -> void
+
+        def to_hash: -> {
+          id: String,
+          created_at: Integer,
+          instructions: String?,
+          metadata: ::Hash[Symbol, String],
+          model: String,
+          multi_agent: OpenAI::Beta::MultiAgentConfig,
+          name: String?,
+          ?object: :agent,
+          reasoning: OpenAI::Beta::AgentReasoning,
+          service_tier: OpenAI::Models::Beta::Agent::service_tier,
+          text: OpenAI::Beta::AgentText,
+          tools: ::Array[OpenAI::Models::Beta::persisted_agent_tool],
+          updated_at: Integer
+        }
+
+        type service_tier = :auto | :default | :flex | :priority | :fast
+
+        module ServiceTier
+          extend OpenAI::Internal::Type::Enum
+
+          AUTO: :auto
+          DEFAULT: :default
+          FLEX: :flex
+          PRIORITY: :priority
+          FAST: :fast
+
+          def self?.values: -> ::Array[OpenAI::Models::Beta::Agent::service_tier]
+        end
+      end
+    end
+  end
+end

data/sig/openai/models/beta/agent_close_subagent_call_item.rbs

@@ -0,0 +1,47 @@
+module OpenAI
+  module Models
+    module Beta
+      type agent_close_subagent_call_item =
+        {
+          id: String,
+          recipient_agent_id: String,
+          sender_agent_id: String,
+          status: OpenAI::Models::Beta::agent_function_call_status,
+          turn_id: String,
+          ?type: :close_subagent_call
+        }
+
+      class AgentCloseSubagentCallItem < OpenAI::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        attr_accessor recipient_agent_id: String
+
+        attr_accessor sender_agent_id: String
+
+        attr_accessor status: OpenAI::Models::Beta::agent_function_call_status
+
+        attr_accessor turn_id: String
+
+        attr_accessor type: :close_subagent_call
+
+        def initialize: (
+          id: String,
+          recipient_agent_id: String,
+          sender_agent_id: String,
+          status: OpenAI::Models::Beta::agent_function_call_status,
+          turn_id: String,
+          ?type: :close_subagent_call
+        ) -> void
+
+        def to_hash: -> {
+          id: String,
+          recipient_agent_id: String,
+          sender_agent_id: String,
+          status: OpenAI::Models::Beta::agent_function_call_status,
+          turn_id: String,
+          ?type: :close_subagent_call
+        }
+      end
+    end
+  end
+end

data/sig/openai/models/beta/agent_command_execution_item.rbs

@@ -0,0 +1,62 @@
+module OpenAI
+  module Models
+    module Beta
+      type agent_command_execution_item =
+        {
+          id: String,
+          command: String,
+          cwd: String?,
+          duration_ms: Integer?,
+          exit_code: Integer?,
+          output: String?,
+          status: OpenAI::Models::Beta::agent_function_call_status,
+          turn_id: String,
+          ?type: :command_execution
+        }
+
+      class AgentCommandExecutionItem < OpenAI::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        attr_accessor command: String
+
+        attr_accessor cwd: String?
+
+        attr_accessor duration_ms: Integer?
+
+        attr_accessor exit_code: Integer?
+
+        attr_accessor output: String?
+
+        attr_accessor status: OpenAI::Models::Beta::agent_function_call_status
+
+        attr_accessor turn_id: String
+
+        attr_accessor type: :command_execution
+
+        def initialize: (
+          id: String,
+          command: String,
+          cwd: String?,
+          duration_ms: Integer?,
+          exit_code: Integer?,
+          output: String?,
+          status: OpenAI::Models::Beta::agent_function_call_status,
+          turn_id: String,
+          ?type: :command_execution
+        ) -> void
+
+        def to_hash: -> {
+          id: String,
+          command: String,
+          cwd: String?,
+          duration_ms: Integer?,
+          exit_code: Integer?,
+          output: String?,
+          status: OpenAI::Models::Beta::agent_function_call_status,
+          turn_id: String,
+          ?type: :command_execution
+        }
+      end
+    end
+  end
+end

data/sig/openai/models/beta/agent_content.rbs

@@ -0,0 +1,33 @@
+module OpenAI
+  module Models
+    module Beta
+      type agent_content =
+        OpenAI::Beta::OutputText | OpenAI::Beta::AgentContent::EncryptedContent
+
+      module AgentContent
+        extend OpenAI::Internal::Type::Union
+
+        type encrypted_content =
+          { encrypted_content: String, ?type: :encrypted_content }
+
+        class EncryptedContent < OpenAI::Internal::Type::BaseModel
+          attr_accessor encrypted_content: String
+
+          attr_accessor type: :encrypted_content
+
+          def initialize: (
+            encrypted_content: String,
+            ?type: :encrypted_content
+          ) -> void
+
+          def to_hash: -> {
+            encrypted_content: String,
+            ?type: :encrypted_content
+          }
+        end
+
+        def self?.variants: -> ::Array[OpenAI::Models::Beta::agent_content]
+      end
+    end
+  end
+end

data/sig/openai/models/beta/agent_create_params.rbs

@@ -0,0 +1,91 @@
+module OpenAI
+  module Models
+    module Beta
+      type agent_create_params =
+        {
+          model: String,
+          ?instructions: String?,
+          ?metadata: ::Hash[Symbol, String]?,
+          ?multi_agent: OpenAI::Beta::MultiAgentConfigParam?,
+          ?name: String?,
+          ?reasoning: OpenAI::Beta::AgentReasoningParam?,
+          ?service_tier: OpenAI::Models::Beta::AgentCreateParams::service_tier?,
+          ?text: OpenAI::Beta::AgentTextParam?,
+          ?tools: ::Array[OpenAI::Models::Beta::persisted_agent_tool_param]?,
+          ?request_options: OpenAI::request_opts
+        }
+
+      class AgentCreateParams < OpenAI::Internal::Type::BaseModel
+        extend OpenAI::Internal::Type::RequestParameters::Converter
+        include OpenAI::Internal::Type::RequestParameters
+
+        attr_accessor model: String
+
+        attr_accessor instructions: String?
+
+        attr_accessor metadata: ::Hash[Symbol, String]?
+
+        attr_accessor multi_agent: OpenAI::Beta::MultiAgentConfigParam?
+
+        attr_accessor name: String?
+
+        attr_accessor reasoning: OpenAI::Beta::AgentReasoningParam?
+
+        attr_accessor service_tier: OpenAI::Models::Beta::AgentCreateParams::service_tier?
+
+        attr_accessor text: OpenAI::Beta::AgentTextParam?
+
+        attr_accessor tools: ::Array[OpenAI::Models::Beta::persisted_agent_tool_param]?
+
+        def initialize: (
+          model: String,
+          ?instructions: String?,
+          ?metadata: ::Hash[Symbol, String]?,
+          ?multi_agent: OpenAI::Beta::MultiAgentConfigParam?,
+          ?name: String?,
+          ?reasoning: OpenAI::Beta::AgentReasoningParam?,
+          ?service_tier: OpenAI::Models::Beta::AgentCreateParams::service_tier?,
+          ?text: OpenAI::Beta::AgentTextParam?,
+          ?tools: ::Array[OpenAI::Models::Beta::persisted_agent_tool_param]?,
+          ?request_options: OpenAI::request_opts
+        ) -> void
+
+        def to_hash: -> {
+          model: String,
+          ?instructions: String?,
+          ?metadata: ::Hash[Symbol, String]?,
+          ?multi_agent: OpenAI::Beta::MultiAgentConfigParam?,
+          ?name: String?,
+          ?reasoning: OpenAI::Beta::AgentReasoningParam?,
+          ?service_tier: OpenAI::Models::Beta::AgentCreateParams::service_tier?,
+          ?text: OpenAI::Beta::AgentTextParam?,
+          ?tools: ::Array[OpenAI::Models::Beta::persisted_agent_tool_param]?,
+          ?request_options: OpenAI::RequestOptions
+        }
+
+        type service_tier = :auto | :default | :flex | :priority | :fast
+
+        module ServiceTier
+          extend OpenAI::Internal::Type::Enum
+
+          # Selects the service tier automatically.
+          AUTO: :auto
+
+          # Uses the default service tier.
+          DEFAULT: :default
+
+          # Uses the flex service tier.
+          FLEX: :flex
+
+          # Uses the priority service tier.
+          PRIORITY: :priority
+
+          # Uses the fast service tier.
+          FAST: :fast
+
+          def self?.values: -> ::Array[OpenAI::Models::Beta::AgentCreateParams::service_tier]
+        end
+      end
+    end
+  end
+end