o i'@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+selfr0Z/home/kim/smarthome/.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 | NotGivenrcCsNddi| pi} |jdt||||||||| | | d tjt| | ||dtdS) 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](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response. - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all reasoning values in gpt-5.1. - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`. - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort. - `xhigh` is supported for all models after `gpt-5.1-codex-max`. 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@rArBrCrDrErFrGbodyoptionscast_to)_postrrAssistantCreateParamsrrr/rHr:r;r<r=r>r?r@rArBrCrDrErFrGr0r0r1create9s.l zAssistants.createrZ assistant_idstrcCF|s td|ddi|pi}|jtd|dt||||dtdS)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}rcrZr]r^ ValueError_getrrrr/rcrDrErFrGr0r0r1retrieve 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] | OmitcCsh|s td|ddi| pi} |jtd|dt|||||||| | | | d tjt| |||dtdS) 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](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response. - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all reasoning values in gpt-5.1. - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`. - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort. - `xhigh` is supported for all models after `gpt-5.1-codex-max`. 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 rgrVrWrhri r:r;r<rHr=r>r?r@rArBrCrZr[)rlr_rrrAssistantUpdateParamsrrr/rcr:r;r<rHr=r>r?r@rArBrCrDrErFrGr0r0r1updates4  zAssistants.updateafterbeforelimitorderrDrErFrGrz str | Omitr{r| int | Omitr}Literal['asc', 'desc'] | OmitSyncCursorPage[Assistant]c CFddi|pi}|jdttt||||t||||dtjdtdSaReturns 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)rzr{r|r})rDrErFrGquery)pager]rH) _get_api_listrrrrrAssistantListParams r/rzr{r|r}rDrErFrGr0r0r1list(,zAssistants.listr!cCre)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 rgrVrWrhrirZrjrl_deleterrr!rnr0r0r1deleterpzAssistants.delete)r*r+)r*r4 rHrIr:rJr;rJr<rKr=rJr>rLr?rMr@rNrArOrBrPrCrNrDrQrErRrFrSrGrTr*r rcrdrDrQrErRrFrSrGrTr*r"rcrdr:rJr;rJr<rKrHrrr=rJr>rLr?rMr@rNrArsrBrPrCrNrDrQrErRrFrSrGrTr*r)rzr~r{r~r|rr}rrDrQrErRrFrSrGrTr*r rcrdrDrQrErRrFrSrGrTr*r!__name__ __module__ __qualname____doc__rr2r6typing_extensionsr8rrrbrorxrrr0r0r0r1r&#~  "08Ac@r()Ir'r)r*AsyncAssistantsWithRawResponsecCr,r-)rr.r0r0r1r2r3z!AsyncAssistants.with_raw_response$AsyncAssistantsWithStreamingResponsecCr,r5)rr.r0r0r1r6 r7z'AsyncAssistants.with_streaming_responser8Nr9rHrIr:rJr;r<rKr=r>rLr?rMr@rNrArOrBrPrCrDrQrErRrFrSrGrTrcs\ddi| pi} |jdt||||||||| | | d tjIdHt| | ||dtdIdHS)rUrVrWrXrYNrZr[)r_rrr`rrrar0r0r1rbs0l  zAsyncAssistants.createrZrcrdcN|s td|ddi|pi}|jtd|dt||||dtdIdHS) rfrgrVrWrhrirZrjNrkrnr0r0r1ro  zAsyncAssistants.retrieverqrrrscsv|s td|ddi| pi} |jtd|dt|||||||| | | | d tjIdHt| |||dtd IdHS) rtrgrVrWrhriruNrZr[)rlr_rrrrvrrrwr0r0r1rxs6   zAsyncAssistants.updateryrzr~r{r|rr}r5AsyncPaginator[Assistant, AsyncCursorPage[Assistant]]c Crr)rrrrrrrrr0r0r1rurzAsyncAssistants.listr!cr) rrgrVrWrhrirZrjNrrnr0r0r1rrzAsyncAssistants.delete)r*r)r*rrrr)rzr~r{r~r|rr}rrDrQrErRrFrSrGrTr*rrrr0r0r0r1r'rc@eZdZdddZdS) r+ assistantsr&r*NonecCP||_t|j|_t|j|_t|j|_t|j|_t|j|_dSN) _assistantsrZto_raw_response_wrapperrbrorxrrr/rr0r0r1__init__*z"AssistantsWithRawResponse.__init__Nrr&r*rrrrrr0r0r0r1r+r+c@r) rrr'r*rcCrr)rrZasync_to_raw_response_wrapperrbrorxrrrr0r0r1rrz'AsyncAssistantsWithRawResponse.__init__Nrr'r*rrr0r0r0r1rrrc@r) r4rr&r*rcCF||_t|j|_t|j|_t|j|_t|j|_t|j|_dSr)rrrbrorxrrrr0r0r1r*z(AssistantsWithStreamingResponse.__init__Nrrr0r0r0r1r4rr4c@r) rrr'r*rcCrr)rrrbrorxrrrr0r0r1r9rz-AsyncAssistantsWithStreamingResponse.__init__Nrrr0r0r0r1r8rr)> __future__rrtypingrrrrZhttpxr_typesr r r r r rrZ_utilsrrrZ_compatrZ _resourcerr _responserrZ paginationrrZ types.betarrrZ _base_clientrrZtypes.beta.assistantrZtypes.shared.chat_modelr Ztypes.beta.assistant_deletedr!Ztypes.shared_params.metadatar"Ztypes.shared.reasoning_effortr#Ztypes.beta.assistant_tool_paramr$Z1types.beta.assistant_response_format_option_paramr%__all__r&r'r+rr4rr0r0r0r1sD   $        __