o RWj@sddlmZddlZddlmZmZmZddlmZddlZddl m Z ddl m Z m Z mZmZmZmZmZddlmZmZmZdd lmZdd lmZmZdd lmZmZdd lm Z m!Z!dd l"m#Z#m$Z$m%Z%ddl&m'Z'm(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6ddgZ7GdddeZ8GdddeZ9GdddZ:GdddZ;GdddZZed d d d e d*dHd@dAZd S)Ir&4Build Assistants that can call models and use tools.returnAssistantsWithRawResponsecCt|Sa This property can be used as a prefix for any HTTP method call to return the raw response object instead of the parsed content. For more information, see https://www.github.com/openai/openai-python#accessing-raw-response-data-eg-headers )r+selfr0o/home/esfera/Documents/content_generation/venv/lib/python3.10/site-packages/openai/resources/beta/assistants.pywith_raw_response&zAssistants.with_raw_responseAssistantsWithStreamingResponsecCr,z An alternative to `.with_raw_response` that doesn't eagerly read the response body. For more information, see https://www.github.com/openai/openai-python#with_streaming_response )r4r.r0r0r1with_streaming_response0z"Assistants.with_streaming_response deprecatedN description instructionsmetadatanamereasoning_effortresponse_format temperaturetool_resourcestoolstop_p extra_headers extra_query extra_bodytimeoutmodelUnion[str, ChatModel]r:Optional[str] | Omitr;r<Optional[Metadata] | Omitr=r> Optional[ReasoningEffort] | Omitr?3Optional[AssistantResponseFormatOptionParam] | Omitr@Optional[float] | OmitrA6Optional[assistant_create_params.ToolResources] | OmitrB#Iterable[AssistantToolParam] | OmitrCrDHeaders | NonerE Query | NonerF Body | NonerG'float | httpx.Timeout | None | NotGivenrcCsTddi| pi} |jdt||||||||| | | d tjt| | ||ddidtdS) 2 Create an assistant with a model and instructions. Args: model: ID of the model to use. You can use the [List models](https://platform.openai.com/docs/api-reference/models/list) API to see all of your available models, or see our [Model overview](https://platform.openai.com/docs/models) for descriptions of them. description: The description of the assistant. The maximum length is 512 characters. instructions: The system instructions that the assistant uses. The maximum length is 256,000 characters. 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. name: The name of the assistant. The maximum length is 256 characters. reasoning_effort: Constrains effort on reasoning for reasoning models. Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response. Not all reasoning models support every value. See the [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific support. response_format: Specifies the format that the model must output. Compatible with [GPT-4o](https://platform.openai.com/docs/models#gpt-4o), [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4), 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://platform.openai.com/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. 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. 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. tools: A list of tool enabled on the assistant. There can be a maximum of 128 tools per assistant. Tools can be of types `code_interpreter`, `file_search`, or `function`. 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. extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds OpenAI-Beta assistants=v2 /assistants rHr:r;r<r=r>r?r@rArBrC bearer_authTrDrErFrGsecuritybodyoptionscast_to)_postrrAssistantCreateParamsrrr/rHr:r;r<r=r>r?r@rArBrCrDrErFrGr0r0r1create9s6e zAssistants.createrDrErFrG assistant_idstrc CL|s td|ddi|pi}|jtd|dt||||ddidtd S) K Retrieves an assistant. Args: extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds ;Expected a non-empty value for `assistant_id` but received rVrW/assistants/{assistant_id}rfrZTr[r_r` ValueError_getrrrr/rfrDrErFrGr0r0r1retrieve zAssistants.retriever:r;r<rHr=r>r?r@rArBrCrDrErFrG3Union[str, Literal['gpt-5', 'gpt-5-mini', 'gpt-5-nano', 'gpt-5-2025-08-07', 'gpt-5-mini-2025-08-07', 'gpt-5-nano-2025-08-07', 'gpt-4.1', 'gpt-4.1-mini', 'gpt-4.1-nano', 'gpt-4.1-2025-04-14', 'gpt-4.1-mini-2025-04-14', 'gpt-4.1-nano-2025-04-14', 'o3-mini', 'o3-mini-2025-01-31', 'o1', 'o1-2024-12-17', 'gpt-4o', 'gpt-4o-2024-11-20', 'gpt-4o-2024-08-06', 'gpt-4o-2024-05-13', 'gpt-4o-mini', 'gpt-4o-mini-2024-07-18', 'gpt-4.5-preview', 'gpt-4.5-preview-2025-02-27', 'gpt-4-turbo', 'gpt-4-turbo-2024-04-09', 'gpt-4-0125-preview', 'gpt-4-turbo-preview', 'gpt-4-1106-preview', 'gpt-4-vision-preview', 'gpt-4', 'gpt-4-0314', 'gpt-4-0613', 'gpt-4-32k', 'gpt-4-32k-0314', 'gpt-4-32k-0613', 'gpt-3.5-turbo', 'gpt-3.5-turbo-16k', 'gpt-3.5-turbo-0613', 'gpt-3.5-turbo-1106', 'gpt-3.5-turbo-0125', 'gpt-3.5-turbo-16k-0613']] | Omit6Optional[assistant_update_params.ToolResources] | OmitcCsn|s td|ddi| pi} |jtd|dt|||||||| | | | d tjt| |||ddid td S) Modifies an assistant. Args: description: The description of the assistant. The maximum length is 512 characters. instructions: The system instructions that the assistant uses. The maximum length is 256,000 characters. 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. model: ID of the model to use. You can use the [List models](https://platform.openai.com/docs/api-reference/models/list) API to see all of your available models, or see our [Model overview](https://platform.openai.com/docs/models) for descriptions of them. name: The name of the assistant. The maximum length is 256 characters. reasoning_effort: Constrains effort on reasoning for reasoning models. Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response. Not all reasoning models support every value. See the [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific support. response_format: Specifies the format that the model must output. Compatible with [GPT-4o](https://platform.openai.com/docs/models#gpt-4o), [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4), 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://platform.openai.com/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. 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. 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. tools: A list of tool enabled on the assistant. There can be a maximum of 128 tools per assistant. Tools can be of types `code_interpreter`, `file_search`, or `function`. 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. extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds rjrVrWrkrl r:r;r<rHr=r>r?r@rArBrCrZTr[r])rorarrrAssistantUpdateParamsrrr/rfr:r;r<rHr=r>r?r@rArBrCrDrErFrGr0r0r1updates<  zAssistants.updateafterbeforelimitorderrDrErFrGr} str | Omitr~r int | OmitrLiteral['asc', 'desc'] | OmitSyncCursorPage[Assistant]c CLddi|pi}|jdttt||||t||||dtjddidtdS aReturns a list of assistants. Args: after: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list. before: A cursor for use in pagination. `before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list. limit: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20. order: Sort order by the `created_at` timestamp of the objects. `asc` for ascending order and `desc` for descending order. extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds rVrWrX)r}r~rrrZT)rDrErFrGqueryr\)pager_rH) _get_api_listrrrrrAssistantListParams r/r}r~rrrDrErFrGr0r0r1list*, zAssistants.listr!c Crh) H Delete an assistant. Args: extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds rjrVrWrkrlrZTr[rmro_deleterrr!rqr0r0r1deleterszAssistants.delete)r*r+)r*r4 rHrIr:rJr;rJr<rKr=rJr>rLr?rMr@rNrArOrBrPrCrNrDrQrErRrFrSrGrTr*r rfrgrDrQrErRrFrSrGrTr*r"rfrgr:rJr;rJr<rKrHrur=rJr>rLr?rMr@rNrArvrBrPrCrNrDrQrErRrFrSrGrTr*r)r}rr~rrrrrrDrQrErRrFrSrGrTr*r rfrgrDrQrErRrFrSrGrTr*r!__name__ __module__ __qualname____doc__rr2r6typing_extensionsr8rrrdrrr{rrr0r0r0r1r&#~  &05Bc@r()Ir'r)r*AsyncAssistantsWithRawResponsecCr,r-)rr.r0r0r1r2r3z!AsyncAssistants.with_raw_response$AsyncAssistantsWithStreamingResponsecCr,r5)rr.r0r0r1r6r7z'AsyncAssistants.with_streaming_responser8Nr9rHrIr:rJr;r<rKr=r>rLr?rMr@rNrArOrBrPrCrDrQrErRrFrSrGrTrcsbddi| pi} |jdt||||||||| | | d tjIdHt| | ||ddidtd IdHS) rUrVrWrXrYNrZTr[r])rarrrbrrrcr0r0r1rds8e  zAsyncAssistants.creatererfrgc T|s td|ddi|pi}|jtd|dt||||ddidtd Id HS) rirjrVrWrkrlrZTr[rmNrnrqr0r0r1rr  zAsyncAssistants.retrievertrurvcs||s td|ddi| pi} |jtd|dt|||||||| | | | d tjIdHt| |||dd id td IdHS) rwrjrVrWrkrlrxNrZTr[r])rorarrrryrrrzr0r0r1r{s>   zAsyncAssistants.updater|r}rr~rrrr5AsyncPaginator[Assistant, AsyncCursorPage[Assistant]]c Crr)rrrrrrrrr0r0r1rvrzAsyncAssistants.listr!c r) rrjrVrWrkrlrZTr[rmNrrqr0r0r1rrzAsyncAssistants.delete)r*r)r*rrrr)r}rr~rrrrrrDrQrErRrFrSrGrTr*rrrr0r0r0r1r'rc@eZdZdddZdS) r+ assistantsr&r*NonecCP||_t|j|_t|j|_t|j|_t|j|_t|j|_dSN) _assistantsrto_raw_response_wrapperrdrrr{rrr/rr0r0r1__init__*z"AssistantsWithRawResponse.__init__Nrr&r*rrrrrr0r0r0r1r+r+c@r) rrr'r*rcCrr)rrasync_to_raw_response_wrapperrdrrr{rrrr0r0r1rrz'AsyncAssistantsWithRawResponse.__init__Nrr'r*rrr0r0r0r1rrrc@r) r4rr&r*rcCF||_t|j|_t|j|_t|j|_t|j|_t|j|_dSr)rrrdrrr{rrrr0r0r1r *z(AssistantsWithStreamingResponse.__init__Nrrr0r0r0r1r4rr4c@r) rrr'r*rcCrr)rrrdrrr{rrrr0r0r1r?rz-AsyncAssistantsWithStreamingResponse.__init__Nrrr0r0r0r1r>rr)> __future__rrtypingrrrrhttpxr_typesr r r r r rr_utilsrrr_compatr _resourcerr _responserr paginationrr types.betarrr _base_clientrrtypes.beta.assistantrtypes.shared.chat_modelr types.beta.assistant_deletedr!types.shared_params.metadatar"types.shared.reasoning_effortr#types.beta.assistant_tool_paramr$1types.beta.assistant_response_format_option_paramr%__all__r&r'r+rr4rr0r0r0r1sD   $        bb