openai 0.92.0 → 0.94.0

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

@@ -25,42 +25,210 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # The ID of the
+        # [assistant](https://developers.openai.com/api/docs/assistants/migration) to use
+        # to execute this run.
         attr_accessor assistant_id: String
 
+        # Override the default system message of the assistant. This is useful for
+        # modifying the behavior on a per-run basis.
         attr_accessor instructions: String?
 
+        # The maximum number of completion tokens that may be used over the course of the
+        # run. The run will make a best effort to use only the number of completion tokens
+        # specified, across multiple turns of the run. If the run exceeds the number of
+        # completion tokens specified, the run will end with status `incomplete`. See
+        # `incomplete_details` for more info.
         attr_accessor max_completion_tokens: Integer?
 
+        # The maximum number of prompt tokens that may be used over the course of the run.
+        # The run will make a best effort to use only the number of prompt tokens
+        # specified, across multiple turns of the run. If the run exceeds the number of
+        # prompt tokens specified, the run will end with status `incomplete`. See
+        # `incomplete_details` for more info.
         attr_accessor max_prompt_tokens: Integer?
 
+        # Set of 16 key-value pairs that can be attached to an object. This can be useful
+        # for storing additional information about the object in a structured format, and
+        # querying for objects via API or the dashboard.
+        #
+        # Keys are strings with a maximum length of 64 characters. Values are strings with
+        # a maximum length of 512 characters.
         attr_accessor metadata: OpenAI::Models::metadata?
 
+        # The ID of the
+        # [Model](https://developers.openai.com/api/reference/resources/models) to be used
+        # to execute this run. If a value is provided here, it will override the model
+        # associated with the assistant. If not, the model associated with the assistant
+        # will be used.
         attr_accessor model: OpenAI::Models::Beta::ThreadCreateAndRunParams::model?
 
+        # Whether to enable
+        # [parallel function calling](https://developers.openai.com/api/docs/guides/function-calling#parallel-function-calling)
+        # during tool use.
         attr_reader parallel_tool_calls: bool?
 
+        # Whether to enable
+        # [parallel function calling](https://developers.openai.com/api/docs/guides/function-calling#parallel-function-calling)
+        # during tool use.
         def parallel_tool_calls=: (bool) -> bool
 
+        # Specifies the format that the model must output. Compatible with
+        # [GPT-4o](https://developers.openai.com/api/docs/models/gpt-4o),
+        # [GPT-4 Turbo](https://developers.openai.com/api/docs/models/gpt-4-turbo), and
+        # all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
+        #
+        # Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
+        # Outputs which ensures the model will match your supplied JSON schema. Learn more
+        # in the
+        # [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
+        #
+        # Setting to `{ "type": "json_object" }` enables JSON mode, which ensures the
+        # message the model generates is valid JSON.
+        #
+        # **Important:** when using JSON mode, you **must** also instruct the model to
+        # produce JSON yourself via a system or user message. Without this, the model may
+        # generate an unending stream of whitespace until the generation reaches the token
+        # limit, resulting in a long-running and seemingly "stuck" request. Also note that
+        # the message content may be partially cut off if `finish_reason="length"`, which
+        # indicates the generation exceeded `max_tokens` or the conversation exceeded the
+        # max context length.
         attr_accessor response_format: OpenAI::Models::Beta::assistant_response_format_option?
 
+        # What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
+        # make the output more random, while lower values like 0.2 will make it more
+        # focused and deterministic.
         attr_accessor temperature: Float?
 
+        # Options to create a new thread. If no thread is provided when running a request,
+        # an empty thread will be created.
         attr_reader thread: OpenAI::Beta::ThreadCreateAndRunParams::Thread?
 
+        # Options to create a new thread. If no thread is provided when running a request,
+        # an empty thread will be created.
         def thread=: (
           OpenAI::Beta::ThreadCreateAndRunParams::Thread
         ) -> OpenAI::Beta::ThreadCreateAndRunParams::Thread
 
+        # Controls which (if any) tool is called by the model. `none` means the model will
+        # not call any tools and instead generates a message. `auto` is the default value
+        # and means the model can pick between generating a message or calling one or more
+        # tools. `required` means the model must call one or more tools before responding
+        # to the user. Specifying a particular tool like `{"type": "file_search"}` or
+        # `{"type": "function", "function": {"name": "my_function"}}` forces the model to
+        # call that tool.
         attr_accessor tool_choice: OpenAI::Models::Beta::assistant_tool_choice_option?
 
+        # A set of resources that are used by the assistant's tools. The resources are
+        # specific to the type of tool. For example, the `code_interpreter` tool requires
+        # a list of file IDs, while the `file_search` tool requires a list of vector store
+        # IDs.
         attr_accessor tool_resources: OpenAI::Beta::ThreadCreateAndRunParams::ToolResources?
 
+        # Override the tools the assistant can use for this run. This is useful for
+        # modifying the behavior on a per-run basis.
         attr_accessor tools: ::Array[OpenAI::Models::Beta::assistant_tool]?
 
+        # An alternative to sampling with temperature, called nucleus sampling, where the
+        # model considers the results of the tokens with top_p probability mass. So 0.1
+        # means only the tokens comprising the top 10% probability mass are considered.
+        #
+        # We generally recommend altering this or temperature but not both.
         attr_accessor top_p: Float?
 
+        # Controls for how a thread will be truncated prior to the run. Use this to
+        # control the initial context window of the run.
         attr_accessor truncation_strategy: OpenAI::Beta::ThreadCreateAndRunParams::TruncationStrategy?
 
+        # @param assistant_id
+        #   The ID of the
+        #   [assistant](https://developers.openai.com/api/docs/assistants/migration) to use
+        #   to execute this run.
+        # @param instructions
+        #   Override the default system message of the assistant. This is useful for
+        #   modifying the behavior on a per-run basis.
+        # @param max_completion_tokens
+        #   The maximum number of completion tokens that may be used over the course of the
+        #   run. The run will make a best effort to use only the number of completion tokens
+        #   specified, across multiple turns of the run. If the run exceeds the number of
+        #   completion tokens specified, the run will end with status `incomplete`. See
+        #   `incomplete_details` for more info.
+        # @param max_prompt_tokens
+        #   The maximum number of prompt tokens that may be used over the course of the run.
+        #   The run will make a best effort to use only the number of prompt tokens
+        #   specified, across multiple turns of the run. If the run exceeds the number of
+        #   prompt tokens specified, the run will end with status `incomplete`. See
+        #   `incomplete_details` for more info.
+        # @param metadata
+        #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+        #   for storing additional information about the object in a structured format, and
+        #   querying for objects via API or the dashboard.
+        #
+        #   Keys are strings with a maximum length of 64 characters. Values are strings with
+        #   a maximum length of 512 characters.
+        # @param model
+        #   The ID of the
+        #   [Model](https://developers.openai.com/api/reference/resources/models) to be used
+        #   to execute this run. If a value is provided here, it will override the model
+        #   associated with the assistant. If not, the model associated with the assistant
+        #   will be used.
+        # @param parallel_tool_calls
+        #   Whether to enable
+        #   [parallel function calling](https://developers.openai.com/api/docs/guides/function-calling#parallel-function-calling)
+        #   during tool use.
+        # @param response_format
+        #   Specifies the format that the model must output. Compatible with
+        #   [GPT-4o](https://developers.openai.com/api/docs/models/gpt-4o),
+        #   [GPT-4 Turbo](https://developers.openai.com/api/docs/models/gpt-4-turbo), and
+        #   all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
+        #
+        #   Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
+        #   Outputs which ensures the model will match your supplied JSON schema. Learn more
+        #   in the
+        #   [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
+        #
+        #   Setting to `{ "type": "json_object" }` enables JSON mode, which ensures the
+        #   message the model generates is valid JSON.
+        #
+        #   **Important:** when using JSON mode, you **must** also instruct the model to
+        #   produce JSON yourself via a system or user message. Without this, the model may
+        #   generate an unending stream of whitespace until the generation reaches the token
+        #   limit, resulting in a long-running and seemingly "stuck" request. Also note that
+        #   the message content may be partially cut off if `finish_reason="length"`, which
+        #   indicates the generation exceeded `max_tokens` or the conversation exceeded the
+        #   max context length.
+        # @param temperature
+        #   What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
+        #   make the output more random, while lower values like 0.2 will make it more
+        #   focused and deterministic.
+        # @param thread
+        #   Options to create a new thread. If no thread is provided when running a request,
+        #   an empty thread will be created.
+        # @param tool_choice
+        #   Controls which (if any) tool is called by the model. `none` means the model will
+        #   not call any tools and instead generates a message. `auto` is the default value
+        #   and means the model can pick between generating a message or calling one or more
+        #   tools. `required` means the model must call one or more tools before responding
+        #   to the user. Specifying a particular tool like `{"type": "file_search"}` or
+        #   `{"type": "function", "function": {"name": "my_function"}}` forces the model to
+        #   call that tool.
+        # @param tool_resources
+        #   A set of resources that are used by the assistant's tools. The resources are
+        #   specific to the type of tool. For example, the `code_interpreter` tool requires
+        #   a list of file IDs, while the `file_search` tool requires a list of vector store
+        #   IDs.
+        # @param tools
+        #   Override the tools the assistant can use for this run. This is useful for
+        #   modifying the behavior on a per-run basis.
+        # @param top_p
+        #   An alternative to sampling with temperature, called nucleus sampling, where the
+        #   model considers the results of the tokens with top_p probability mass. So 0.1
+        #   means only the tokens comprising the top 10% probability mass are considered.
+        #
+        #   We generally recommend altering this or temperature but not both.
+        # @param truncation_strategy
+        #   Controls for how a thread will be truncated prior to the run. Use this to
+        #   control the initial context window of the run.
         def initialize: (
           assistant_id: String,
           ?instructions: String?,
@@ -115,16 +283,48 @@ module OpenAI
           }
 
         class Thread < OpenAI::Internal::Type::BaseModel
+          # A list of
+          # [messages](https://developers.openai.com/api/docs/assistants/migration) to start
+          # the thread with.
           attr_reader messages: ::Array[OpenAI::Beta::ThreadCreateAndRunParams::Thread::Message]?
 
+          # A list of
+          # [messages](https://developers.openai.com/api/docs/assistants/migration) to start
+          # the thread with.
           def messages=: (
             ::Array[OpenAI::Beta::ThreadCreateAndRunParams::Thread::Message]
           ) -> ::Array[OpenAI::Beta::ThreadCreateAndRunParams::Thread::Message]
 
+          # Set of 16 key-value pairs that can be attached to an object. This can be useful
+          # for storing additional information about the object in a structured format, and
+          # querying for objects via API or the dashboard.
+          #
+          # Keys are strings with a maximum length of 64 characters. Values are strings with
+          # a maximum length of 512 characters.
           attr_accessor metadata: OpenAI::Models::metadata?
 
+          # A set of resources that are made available to the assistant's tools in this
+          # thread. The resources are specific to the type of tool. For example, the
+          # `code_interpreter` tool requires a list of file IDs, while the `file_search`
+          # tool requires a list of vector store IDs.
           attr_accessor tool_resources: OpenAI::Beta::ThreadCreateAndRunParams::Thread::ToolResources?
 
+          # @param messages
+          #   A list of
+          #   [messages](https://developers.openai.com/api/docs/assistants/migration) to start
+          #   the thread with.
+          # @param metadata
+          #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+          #   for storing additional information about the object in a structured format, and
+          #   querying for objects via API or the dashboard.
+          #
+          #   Keys are strings with a maximum length of 64 characters. Values are strings with
+          #   a maximum length of 512 characters.
+          # @param tool_resources
+          #   A set of resources that are made available to the assistant's tools in this
+          #   thread. The resources are specific to the type of tool. For example, the
+          #   `code_interpreter` tool requires a list of file IDs, while the `file_search`
+          #   tool requires a list of vector store IDs.
           def initialize: (
             ?messages: ::Array[OpenAI::Beta::ThreadCreateAndRunParams::Thread::Message],
             ?metadata: OpenAI::Models::metadata?,
@@ -146,14 +346,46 @@ module OpenAI
             }
 
           class Message < OpenAI::Internal::Type::BaseModel
+            # The text contents of the message.
             attr_accessor content: OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::content
 
+            # The role of the entity that is creating the message. Allowed values include:
+            #
+            # - `user`: Indicates the message is sent by an actual user and should be used in
+            #   most cases to represent user-generated messages.
+            # - `assistant`: Indicates the message is generated by the assistant. Use this
+            #   value to insert messages from the assistant into the conversation.
             attr_accessor role: OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::role
 
+            # A list of files attached to the message, and the tools they should be added to.
             attr_accessor attachments: ::Array[OpenAI::Beta::ThreadCreateAndRunParams::Thread::Message::Attachment]?
 
+            # Set of 16 key-value pairs that can be attached to an object. This can be useful
+            # for storing additional information about the object in a structured format, and
+            # querying for objects via API or the dashboard.
+            #
+            # Keys are strings with a maximum length of 64 characters. Values are strings with
+            # a maximum length of 512 characters.
             attr_accessor metadata: OpenAI::Models::metadata?
 
+            # @param content
+            #   The text contents of the message.
+            # @param role
+            #   The role of the entity that is creating the message. Allowed values include:
+            #
+            #   - `user`: Indicates the message is sent by an actual user and should be used in
+            #     most cases to represent user-generated messages.
+            #   - `assistant`: Indicates the message is generated by the assistant. Use this
+            #     value to insert messages from the assistant into the conversation.
+            # @param attachments
+            #   A list of files attached to the message, and the tools they should be added to.
+            # @param metadata
+            #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+            #   for storing additional information about the object in a structured format, and
+            #   querying for objects via API or the dashboard.
+            #
+            #   Keys are strings with a maximum length of 64 characters. Values are strings with
+            #   a maximum length of 512 characters.
             def initialize: (
               content: OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::content,
               role: OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::role,
@@ -198,16 +430,24 @@ module OpenAI
               }
 
             class Attachment < OpenAI::Internal::Type::BaseModel
+              # The ID of the file to attach to the message.
               attr_reader file_id: String?
 
+              # The ID of the file to attach to the message.
               def file_id=: (String) -> String
 
+              # The tools to add this file to.
               attr_reader tools: ::Array[OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::Attachment::tool]?
 
+              # The tools to add this file to.
               def tools=: (
                 ::Array[OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::Attachment::tool]
               ) -> ::Array[OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::Attachment::tool]
 
+              # @param file_id
+              #   The ID of the file to attach to the message.
+              # @param tools
+              #   The tools to add this file to.
               def initialize: (
                 ?file_id: String,
                 ?tools: ::Array[OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::Attachment::tool]
@@ -228,8 +468,11 @@ module OpenAI
                 type file_search = { ?type: :file_search }
 
                 class FileSearch < OpenAI::Internal::Type::BaseModel
+                  # The type of tool being defined: `file_search`
                   attr_accessor type: :file_search
 
+                  # @param type
+                  #   The type of tool being defined: `file_search`
                   def initialize: (?type: :file_search) -> void
 
                   def to_hash: -> { ?type: :file_search }
@@ -272,10 +515,20 @@ module OpenAI
             type code_interpreter = { ?file_ids: ::Array[String] }
 
             class CodeInterpreter < OpenAI::Internal::Type::BaseModel
+              # A list of [file](https://developers.openai.com/api/reference/resources/files)
+              # IDs made available to the `code_interpreter` tool. There can be a maximum of 20
+              # files associated with the tool.
               attr_reader file_ids: ::Array[String]?
 
+              # A list of [file](https://developers.openai.com/api/reference/resources/files)
+              # IDs made available to the `code_interpreter` tool. There can be a maximum of 20
+              # files associated with the tool.
               def file_ids=: (::Array[String]) -> ::Array[String]
 
+              # @param file_ids
+              #   A list of [file](https://developers.openai.com/api/reference/resources/files)
+              #   IDs made available to the `code_interpreter` tool. There can be a maximum of 20
+              #   files associated with the tool.
               def initialize: (?file_ids: ::Array[String]) -> void
 
               def to_hash: -> { ?file_ids: ::Array[String] }
@@ -288,16 +541,42 @@ module OpenAI
               }
 
             class FileSearch < OpenAI::Internal::Type::BaseModel
+              # The
+              # [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+              # attached to this thread. There can be a maximum of 1 vector store attached to
+              # the thread.
               attr_reader vector_store_ids: ::Array[String]?
 
+              # The
+              # [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+              # attached to this thread. There can be a maximum of 1 vector store attached to
+              # the thread.
               def vector_store_ids=: (::Array[String]) -> ::Array[String]
 
+              # A helper to create a
+              # [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+              # with file_ids and attach it to this thread. There can be a maximum of 1 vector
+              # store attached to the thread.
               attr_reader vector_stores: ::Array[OpenAI::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore]?
 
+              # A helper to create a
+              # [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+              # with file_ids and attach it to this thread. There can be a maximum of 1 vector
+              # store attached to the thread.
               def vector_stores=: (
                 ::Array[OpenAI::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore]
               ) -> ::Array[OpenAI::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore]
 
+              # @param vector_store_ids
+              #   The
+              #   [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+              #   attached to this thread. There can be a maximum of 1 vector store attached to
+              #   the thread.
+              # @param vector_stores
+              #   A helper to create a
+              #   [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+              #   with file_ids and attach it to this thread. There can be a maximum of 1 vector
+              #   store attached to the thread.
               def initialize: (
                 ?vector_store_ids: ::Array[String],
                 ?vector_stores: ::Array[OpenAI::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore]
@@ -316,18 +595,51 @@ module OpenAI
                 }
 
               class VectorStore < OpenAI::Internal::Type::BaseModel
+                # The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+                # strategy.
                 attr_reader chunking_strategy: OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore::chunking_strategy?
 
+                # The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+                # strategy.
                 def chunking_strategy=: (
                   OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore::chunking_strategy
                 ) -> OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore::chunking_strategy
 
+                # A list of [file](https://developers.openai.com/api/reference/resources/files)
+                # IDs to add to the vector store. For vector stores created before Nov 2025, there
+                # can be a maximum of 10,000 files in a vector store. For vector stores created
+                # starting in Nov 2025, the limit is 100,000,000 files.
                 attr_reader file_ids: ::Array[String]?
 
+                # A list of [file](https://developers.openai.com/api/reference/resources/files)
+                # IDs to add to the vector store. For vector stores created before Nov 2025, there
+                # can be a maximum of 10,000 files in a vector store. For vector stores created
+                # starting in Nov 2025, the limit is 100,000,000 files.
                 def file_ids=: (::Array[String]) -> ::Array[String]
 
+                # Set of 16 key-value pairs that can be attached to an object. This can be useful
+                # for storing additional information about the object in a structured format, and
+                # querying for objects via API or the dashboard.
+                #
+                # Keys are strings with a maximum length of 64 characters. Values are strings with
+                # a maximum length of 512 characters.
                 attr_accessor metadata: OpenAI::Models::metadata?
 
+                # @param chunking_strategy
+                #   The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+                #   strategy.
+                # @param file_ids
+                #   A list of [file](https://developers.openai.com/api/reference/resources/files)
+                #   IDs to add to the vector store. For vector stores created before Nov 2025, there
+                #   can be a maximum of 10,000 files in a vector store. For vector stores created
+                #   starting in Nov 2025, the limit is 100,000,000 files.
+                # @param metadata
+                #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+                #   for storing additional information about the object in a structured format, and
+                #   querying for objects via API or the dashboard.
+                #
+                #   Keys are strings with a maximum length of 64 characters. Values are strings with
+                #   a maximum length of 512 characters.
                 def initialize: (
                   ?chunking_strategy: OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore::chunking_strategy,
                   ?file_ids: ::Array[String],
@@ -350,8 +662,11 @@ module OpenAI
                   type auto = { ?type: :auto }
 
                   class Auto < OpenAI::Internal::Type::BaseModel
+                    # Always `auto`.
                     attr_accessor type: :auto
 
+                    # @param type
+                    #   Always `auto`.
                     def initialize: (?type: :auto) -> void
 
                     def to_hash: -> { ?type: :auto }
@@ -366,8 +681,11 @@ module OpenAI
                   class Static < OpenAI::Internal::Type::BaseModel
                     attr_accessor static: OpenAI::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore::ChunkingStrategy::Static::Static
 
+                    # Always `static`.
                     attr_accessor type: :static
 
+                    # @param type
+                    #   Always `static`.
                     def initialize: (
                       static: OpenAI::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore::ChunkingStrategy::Static::Static,
                       ?type: :static
@@ -385,10 +703,22 @@ module OpenAI
                       }
 
                     class Static < OpenAI::Internal::Type::BaseModel
+                      # The number of tokens that overlap between chunks. The default value is `400`.
+                      #
+                      # Note that the overlap must not exceed half of `max_chunk_size_tokens`.
                       attr_accessor chunk_overlap_tokens: Integer
 
+                      # The maximum number of tokens in each chunk. The default value is `800`. The
+                      # minimum value is `100` and the maximum value is `4096`.
                       attr_accessor max_chunk_size_tokens: Integer
 
+                      # @param chunk_overlap_tokens
+                      #   The number of tokens that overlap between chunks. The default value is `400`.
+                      #
+                      #   Note that the overlap must not exceed half of `max_chunk_size_tokens`.
+                      # @param max_chunk_size_tokens
+                      #   The maximum number of tokens in each chunk. The default value is `800`. The
+                      #   minimum value is `100` and the maximum value is `4096`.
                       def initialize: (
                         chunk_overlap_tokens: Integer,
                         max_chunk_size_tokens: Integer
@@ -440,10 +770,20 @@ module OpenAI
           type code_interpreter = { ?file_ids: ::Array[String] }
 
           class CodeInterpreter < OpenAI::Internal::Type::BaseModel
+            # A list of [file](https://developers.openai.com/api/reference/resources/files)
+            # IDs made available to the `code_interpreter` tool. There can be a maximum of 20
+            # files associated with the tool.
             attr_reader file_ids: ::Array[String]?
 
+            # A list of [file](https://developers.openai.com/api/reference/resources/files)
+            # IDs made available to the `code_interpreter` tool. There can be a maximum of 20
+            # files associated with the tool.
             def file_ids=: (::Array[String]) -> ::Array[String]
 
+            # @param file_ids
+            #   A list of [file](https://developers.openai.com/api/reference/resources/files)
+            #   IDs made available to the `code_interpreter` tool. There can be a maximum of 20
+            #   files associated with the tool.
             def initialize: (?file_ids: ::Array[String]) -> void
 
             def to_hash: -> { ?file_ids: ::Array[String] }
@@ -452,10 +792,23 @@ module OpenAI
           type file_search = { ?vector_store_ids: ::Array[String] }
 
           class FileSearch < OpenAI::Internal::Type::BaseModel
+            # The ID of the
+            # [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+            # attached to this assistant. There can be a maximum of 1 vector store attached to
+            # the assistant.
             attr_reader vector_store_ids: ::Array[String]?
 
+            # The ID of the
+            # [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+            # attached to this assistant. There can be a maximum of 1 vector store attached to
+            # the assistant.
             def vector_store_ids=: (::Array[String]) -> ::Array[String]
 
+            # @param vector_store_ids
+            #   The ID of the
+            #   [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+            #   attached to this assistant. There can be a maximum of 1 vector store attached to
+            #   the assistant.
             def initialize: (?vector_store_ids: ::Array[String]) -> void
 
             def to_hash: -> { ?vector_store_ids: ::Array[String] }
@@ -469,10 +822,24 @@ module OpenAI
           }
 
         class TruncationStrategy < OpenAI::Internal::Type::BaseModel
+          # The truncation strategy to use for the thread. The default is `auto`. If set to
+          # `last_messages`, the thread will be truncated to the n most recent messages in
+          # the thread. When set to `auto`, messages in the middle of the thread will be
+          # dropped to fit the context length of the model, `max_prompt_tokens`.
           attr_accessor type: OpenAI::Models::Beta::ThreadCreateAndRunParams::TruncationStrategy::type_
 
+          # The number of most recent messages from the thread when constructing the context
+          # for the run.
           attr_accessor last_messages: Integer?
 
+          # @param type
+          #   The truncation strategy to use for the thread. The default is `auto`. If set to
+          #   `last_messages`, the thread will be truncated to the n most recent messages in
+          #   the thread. When set to `auto`, messages in the middle of the thread will be
+          #   dropped to fit the context length of the model, `max_prompt_tokens`.
+          # @param last_messages
+          #   The number of most recent messages from the thread when constructing the context
+          #   for the run.
           def initialize: (
             type: OpenAI::Models::Beta::ThreadCreateAndRunParams::TruncationStrategy::type_,
             ?last_messages: Integer?