gUddlmZddlmZmZmZddlmZddlZddl m Z ddl m Z m Z mZmZmZddlmZmZdd lmZdd lmZmZdd lmZmZdd lmZmZdd lm Z m!Z!m"Z"ddl#m$Z$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ddgZ0GddeZ1GddeZ2GddZ3GddZ4GddZ5GddZ6y) ) annotations)UnionIterableOptional)LiteralN)_legacy_response) NOT_GIVENBodyQueryHeadersNotGiven)maybe_transformasync_maybe_transform)cached_property)SyncAPIResourceAsyncAPIResource)to_streamed_response_wrapper"async_to_streamed_response_wrapper)SyncCursorPageAsyncCursorPage)assistant_list_paramsassistant_create_paramsassistant_update_params)AsyncPaginatormake_request_options) ChatModel) Assistant)AssistantDeleted)AssistantToolParam)"AssistantResponseFormatOptionParam AssistantsAsyncAssistantsceZdZed dZeddZeeeeeeeeeddded ddZddded ddZeeeeeeeeeeddded dd Z eeeeddded  dd Z ddded dd Z y)r"ct|Sa This property can be used as a prefix for any HTTP method call to return the 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 )AssistantsWithRawResponseselfs U/var/www/openai/venv/lib/python3.12/site-packages/openai/resources/beta/assistants.pywith_raw_responsezAssistants.with_raw_response$s)..ct|Sz 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 )AssistantsWithStreamingResponser(s r*with_streaming_responsez"Assistants.with_streaming_response.s/t44r,N description instructionsmetadatanameresponse_format temperaturetool_resourcestoolstop_p extra_headers extra_query extra_bodytimeoutcddi| xsi} |jdt||||||||| | d tjt | | | |t S) 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. Keys can be a maximum of 64 characters long and values can be a maximum of 512 characters long. name: The name of the assistant. The maximum length is 256 characters. 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 modelr2r3r4r5r6r7r8r9r:r;r<r=r>bodyoptionscast_to)_postrrAssistantCreateParamsrrr)rEr2r3r4r5r6r7r8r9r:r;r<r=r>s r*createzAssistants.create7st'QMs r*retrievezAssistants.retrievesh.Z[gZjkl l&QMc|std|ddi| xsi} |jd|t|||||||| | | d tjt | | ||t 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. Keys can be a maximum of 64 characters long and values can be a maximum of 512 characters long. 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. 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 rQrArBrR r2r3r4rEr5r6r7r8r9r:rFrG)rUrKrrAssistantUpdateParamsrrr)rXr2r3r4rEr5r6r7r8r9r:r;r<r=r>s r*updatezAssistants.updatesxZ[gZjkl l&QMcddi|xsi}|jdttt||||t ||||dt j tSaReturns 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 rArBrC)rbrcrdre)r;r<r=r>query)pagerIrE) _get_api_listrrrrrAssistantListParams r)rbrcrdrer;r<r=r>s r*listzAssistants.listAsyV'QM'float | httpx.Timeout | None | NotGivenrsr rXstrr;rzr<r{r=r|r>r}rsr rXrr2rur3rur4rvrEstr | NotGivenr5rur6rwr7rxr8z:Optional[assistant_update_params.ToolResources] | NotGivenr9ryr:rxr;rzr<r{r=r|r>r}rsr)rbrrcrrdint | NotGivenre!Literal['asc', 'desc'] | NotGivenr;rzr<r{r=r|r>r}rszSyncCursorPage[Assistant] rXrr;rzr<r{r=r|r>r}rsr __name__ __module__ __qualname__rr+r0r rNrYr`rmrrr,r*r"r"#s//551:1:09)2S\2;U^9B,5)-$("&;D%p %p . p / p . p 'p Qp 0p Sp 7p *p &p "!p " #p $9%p & 'p p)-$("&;D    &  "     9     L1:1:09 ))2S\2;U^9B,5)-$("&;D't t . t / t . t t 't Qt 0t St 7t *t &!t ""#t $ %t &9't ( )t r!*!* )3<)-$("&;D? ?  ?  ? 1 ? &? "?  ? 9?  #? N)-$("&;D    &  "     9     r,ceZdZed dZeddZeeeeeeeeeddded ddZddded ddZeeeeeeeeeeddded dd Z eeeeddded  dd Z ddded dd Z y)r#ct|Sr&)AsyncAssistantsWithRawResponser(s r*r+z!AsyncAssistants.with_raw_responses.d33r,ct|Sr.)$AsyncAssistantsWithStreamingResponser(s r*r0z'AsyncAssistants.with_streaming_responses4D99r,Nr1cKddi| xsi} |jdt||||||||| | d tjd{t | | | |t d{S7$7w)r@rArBrCrDNrFrG)rKrrrLrrrMs r*rNzAsyncAssistants.createst'QMr}rsz5AsyncPaginator[Assistant, AsyncCursorPage[Assistant]]rrrr,r*r#r#s44::1:1:09)2S\2;U^9B,5)-$("&;D%p %p . p / p . p 'p Qp 0p Sp 7p *p &p "!p " #p $9%p & 'p p)-$("&;D    &  "     9     L1:1:09 ))2S\2;U^9B,5)-$("&;D't t . t / t . t t 't Qt 0t St 7t *t &!t ""#t $ %t &9't ( )t r!*!* )3<)-$("&;D? ?  ?  ? 1 ? &? "?  ? 9?  ?? N)-$("&;D    &  "     9     r,ceZdZddZy)r'cz||_tj|j|_tj|j|_tj|j |_tj|j |_tj|j|_yN) _assistantsr to_raw_response_wrapperrNrYr`rmrrr) assistantss r*__init__z"AssistantsWithRawResponse.__init__(s%&>>     )@@     '>>     %<< OO  '>>     r,Nrr"rsNonerrrrrr,r*r'r'' r,r'ceZdZddZy)rcz||_tj|j|_tj|j|_tj|j |_tj|j |_tj|j|_yr)rr async_to_raw_response_wrapperrNrYr`rmrrrs r*rz'AsyncAssistantsWithRawResponse.__init__=s%&DD     )FF     'DD     %BB OO  'DD     r,Nrr#rsrrrr,r*rr<rr,rceZdZddZy)r/c||_t|j|_t|j|_t|j|_t|j |_t|j |_yr)rrrNrYr`rmrrrs r*rz(AssistantsWithStreamingResponse.__init__Rsy%2     5     3     1 OO  3     r,Nrrrr,r*r/r/Qrr,r/ceZdZddZy)rc||_t|j|_t|j|_t|j|_t|j |_t|j |_yr)rrrNrYr`rmrrrs r*rz-AsyncAssistantsWithStreamingResponse.__init__gsy%8     ;     9     7 OO  9     r,Nrrrr,r*rrfrr,r)7 __future__rtypingrrrtyping_extensionsrhttpxr _typesr r r r r_utilsrr_compatr _resourcerr _responserr paginationrr types.betarrr _base_clientrrtypes.chat_modelrtypes.beta.assistantrtypes.beta.assistant_deletedrtypes.beta.assistant_tool_paramr 1types.beta.assistant_response_format_option_paramr!__all__r"r#r'rr/rrr,r*rs#,,% ??':Y9 A)-<Ac * +  D  & D   *  *  *  r,