=KihSrSSKJr SSKJr SSKJrJrJrJ r SSK r SSK J r SSK JrJrJrJrJrJrJrJrJrJrJrJrJr "SS 5rg) z2Async client for managing assistants in LangGraph.) annotations)Mapping)AnyLiteralcastoverloadN) HttpClient) AssistantAssistantSelectFieldAssistantSortByAssistantsSearchResponseAssistantVersionConfigContext GraphSchemaJsonOnConflictBehaviorQueryParamTypes SortOrder Subgraphsc \rSrSrSrSSjrSSS.S SjjrSSSS.S!S jjrSSS.S"S jjrS#SSS.S$S jjjr S%SSSSSSSSS .S&S jjjr SSSSSSSSS.S'Sjjr SSSS.S(Sjjr \ SSSSSSSSSSS. S)Sjj5r\ SSSSSSSSSSSS. S*Sjj5rSSSSSSSSSSSS. S+SjjrSSSSSS.S,SjjrS-SSS.S.SjjjrSSS.S/SjjrSrg)0AssistantsClienta=Client for managing assistants in LangGraph. This class provides methods to interact with assistants, which are versioned configurations of your graph. ???+ example "Example" ```python client = get_client(url="http://localhost:2024") assistant = await client.assistants.get("assistant_id_123") ``` cXlgNhttp)selfrs a/var/www/html/dynamic-report/venv/lib/python3.13/site-packages/langgraph_sdk/_async/assistants.py__init__AssistantsClient.__init__*s NheadersparamscX# URRSU3X#S9IShvN $N7f)a6Get an assistant by ID. Args: assistant_id: The ID of the assistant to get. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. Returns: Assistant: Assistant Object. ???+ example "Example Usage" ```python assistant = await client.assistants.get( assistant_id="my_assistant_id" ) print(assistant) ``` ```shell ---------------------------------------------------- { 'assistant_id': 'my_assistant_id', 'graph_id': 'agent', 'created_at': '2024-06-25T17:10:33.109781+00:00', 'updated_at': '2024-06-25T17:10:33.109781+00:00', 'config': {}, 'metadata': {'created_by': 'system'}, 'version': 1, 'name': 'my_assistant' } ``` /assistants/r#Nrgetr assistant_idr$r%s rr)AssistantsClient.get-s8RYY]]<. )7#    s !*(*F)xrayr$r%c# SU0nU(aURU5 URRSUS3XSS9IShvN $N7f)aIGet the graph of an assistant by ID. Args: assistant_id: The ID of the assistant to get the graph of. xray: Include graph representation of subgraphs. If an integer value is provided, only subgraphs with a depth less than or equal to the value will be included. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. Returns: Graph: The graph information for the assistant in JSON format. ???+ example "Example Usage" ```python client = get_client(url="http://localhost:2024") graph_info = await client.assistants.get_graph( assistant_id="my_assistant_id" ) print(graph_info) ``` ```shell -------------------------------------------------------------------------------------------------------------------------- { 'nodes': [ {'id': '__start__', 'type': 'schema', 'data': '__start__'}, {'id': '__end__', 'type': 'schema', 'data': '__end__'}, {'id': 'agent','type': 'runnable','data': {'id': ['langgraph', 'utils', 'RunnableCallable'],'name': 'agent'}}, ], 'edges': [ {'source': '__start__', 'target': 'agent'}, {'source': 'agent','target': '__end__'} ] } ``` r-r'z/graphr%r$N)updaterr))rr+r-r$r% query_paramss r get_graphAssistantsClient.get_graphZsTd~     'YY]]<. / #    s>AAAcZ# URRSUS3X#S9IShvN $N7f)aGet the schemas of an assistant by ID. Args: assistant_id: The ID of the assistant to get the schema of. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. Returns: GraphSchema: The graph schema for the assistant. ???+ example "Example Usage" ```python client = get_client(url="http://localhost:2024") schema = await client.assistants.get_schemas( assistant_id="my_assistant_id" ) print(schema) ``` ```shell ---------------------------------------------------------------------------------------------------------------------------- { 'graph_id': 'agent', 'state_schema': { 'title': 'LangGraphInput', '$ref': '#/definitions/AgentState', 'definitions': { 'BaseMessage': { 'title': 'BaseMessage', 'description': 'Base abstract Message class. Messages are the inputs and outputs of ChatModels.', 'type': 'object', 'properties': { 'content': { 'title': 'Content', 'anyOf': [ {'type': 'string'}, {'type': 'array','items': {'anyOf': [{'type': 'string'}, {'type': 'object'}]}} ] }, 'additional_kwargs': { 'title': 'Additional Kwargs', 'type': 'object' }, 'response_metadata': { 'title': 'Response Metadata', 'type': 'object' }, 'type': { 'title': 'Type', 'type': 'string' }, 'name': { 'title': 'Name', 'type': 'string' }, 'id': { 'title': 'Id', 'type': 'string' } }, 'required': ['content', 'type'] }, 'AgentState': { 'title': 'AgentState', 'type': 'object', 'properties': { 'messages': { 'title': 'Messages', 'type': 'array', 'items': {'$ref': '#/definitions/BaseMessage'} } }, 'required': ['messages'] } } }, 'context_schema': { 'title': 'Context', 'type': 'object', 'properties': { 'model_name': { 'title': 'Model Name', 'enum': ['anthropic', 'openai'], 'type': 'string' } } } } ``` r'z/schemasr#Nr(r*s r get_schemasAssistantsClient.get_schemass:jYY]]<. 17#    s "+)+c# SU0nU(a0UE[U5EnUb)URRSUSU3UUS9IShvN $URRSUS3UUS9IShvN $N+N7f)aGet the schemas of an assistant by ID. Args: assistant_id: The ID of the assistant to get the schema of. namespace: Optional namespace to filter by. recurse: Whether to recursively get subgraphs. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. Returns: Subgraphs: The graph schema for the assistant. recurseNr'z /subgraphs/r/z /subgraphs)dictrr))rr+ namespacer8r$r% get_paramss r get_subgraphsAssistantsClient.get_subgraphs s, ) 7J7$v,7J  |nK {C!'  |nJ7!'   s$AA4A0&A4+A2,A42A4)contextmetadatar+ if_existsnamer$ descriptionr%c# SU0n U(aX+S'U(aX;S'U(aXKS'U(aX[S'U(aXkS'U(aX{S'U (aXS'URRS XU S 9IS hvN $N7f) aCreate a new assistant. Useful when graph is configurable and you want to create different assistants based on different configurations. Args: graph_id: The ID of the graph the assistant should use. The graph ID is normally set in your langgraph.json configuration. config: Configuration to use for the graph. metadata: Metadata to add to assistant. context: Static context to add to the assistant. !!! version-added "Added in version 0.6.0" assistant_id: Assistant ID to use, will default to a random UUID if not provided. if_exists: How to handle duplicate creation. Defaults to 'raise' under the hood. Must be either 'raise' (raise error if duplicate), or 'do_nothing' (return existing assistant). name: The name of the assistant. Defaults to 'Untitled' under the hood. headers: Optional custom headers to include with the request. description: Optional description of the assistant. The description field is available for langgraph-api server version>=0.0.45 params: Optional query parameters to include with the request. Returns: Assistant: The created assistant. ???+ example "Example Usage" ```python client = get_client(url="http://localhost:2024") assistant = await client.assistants.create( graph_id="agent", context={"model_name": "openai"}, metadata={"number":1}, assistant_id="my-assistant-id", if_exists="do_nothing", name="my_name" ) ``` graph_idconfigr>r?r+r@rArBz /assistantsjsonr$r%Nrpost) rrDrEr>r?r+r@rAr$rBr%payloads rcreateAssistantsClient.create3sf #   &H  !(I  "*J  &2N # #,K "FO %0M "YY^^ $    sA0A92A73A9)rDrEr>r?rAr$rBr%c# 0n U(aX*S'UbX:S'UbXJS'U(aXZS'U(aXjS'U(aXS'URRSU3U UU S 9IShvN $N7f) aUpdate an assistant. Use this to point to a different graph, update the configuration, or change the metadata of an assistant. Args: assistant_id: Assistant to update. graph_id: The ID of the graph the assistant should use. The graph ID is normally set in your langgraph.json configuration. If `None`, assistant will keep pointing to same graph. config: Configuration to use for the graph. context: Static context to add to the assistant. !!! version-added "Added in version 0.6.0" metadata: Metadata to merge with existing assistant metadata. name: The new name for the assistant. headers: Optional custom headers to include with the request. description: Optional description of the assistant. The description field is available for langgraph-api server version>=0.0.45 params: Optional query parameters to include with the request. Returns: The updated assistant. ???+ example "Example Usage" ```python client = get_client(url="http://localhost:2024") assistant = await client.assistants.update( assistant_id='e280dad7-8618-443f-87f1-8e41841c180f', graph_id="other-graph", context={"model_name": "anthropic"}, metadata={"number":2} ) ``` rDNrEr>r?rArBr'rF)rpatch) rr+rDrEr>r?rAr$rBr%rJs rr0AssistantsClient.updatezs^#% "*J    &H   !(I  "*J  "FO %0M "YY__<. ) %    sAA(!A&"A()delete_threadsr$r%c# 0nU(aSUS'U(aURU5 URRSU3UU=(d SS9IShvN gN7f)aRDelete an assistant. Args: assistant_id: The assistant ID to delete. delete_threads: If true, delete all threads with `metadata.assistant_id` matching this assistant, along with runs and checkpoints belonging to those threads. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. Returns: `None` ???+ example "Example Usage" ```python client = get_client(url="http://localhost:2024") await client.assistants.delete( assistant_id="my_assistant_id" ) ``` TrPr'Nr#)r0rdelete)rr+rPr$r%r1s rrRAssistantsClient.deletesa>(* -1L) *     'ii<. )'4   sAAAA r) r?rDrAlimitoffsetsort_by sort_orderselectr$r%c  # g7fr rr?rDrArUrVrWrXrYresponse_formatr$r%s rsearchAssistantsClient.searchs $'array) r?rDrArUrVrWrXrYr]r$r%c  # g7frr[r\s rr^r_s r`c z^# U S;a[SU <35eUUS.n U(aXS'U(aX,S'U(aXURRS5mg)NzX-Pagination-Next)r$r))response next_cursors rcapture_pagination3AssistantsClient.search..capture_paginationVs"**../BCKr"z/assistants/searchrd)rGr$r% on_response) assistantsnext)rgzhttpx.ResponsereturnNone) ValueErrorrlistr rrI)rr?rDrArUrVrWrXrYr]r$r%rJrirlrhs @rr^r_ sn "5 5COCVW #  "*J  "*J  "FO !(I  $.L !  &H "&  D O))..$2AX2M.SW !    h &",kB B sB B;#B9 $B;)r?rDrAr$r%c# 0nU(aXS'U(aX&S'U(aX6S'URRSXdUS9IShvN $N7f)aCount assistants matching filters. Args: metadata: Metadata to filter by. Exact match for each key/value. graph_id: Optional graph id to filter by. name: Optional name to filter by. The filtering logic will match assistants where 'name' is a substring (case insensitive) of the assistant name. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. Returns: int: Number of assistants matching the criteria. r?rDrAz/assistants/countrFNrH)rr?rDrAr$r%rJs rcountAssistantsClient.counthsW,#% "*J  "*J  "FOYY^^ gv$    sAA A A c~# UUS.nU(aX'S'URRSUS3UUUS9IShvN $N7f)aList all versions of an assistant. Args: assistant_id: The assistant ID to get versions for. metadata: Metadata to filter versions by. Exact match filter for each KV pair. limit: The maximum number of versions to return. offset: The number of versions to skip. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. Returns: A list of assistant versions. ???+ example "Example Usage" ```python client = get_client(url="http://localhost:2024") assistant_versions = await client.assistants.get_versions( assistant_id="my_assistant_id" ) ``` rer?r'z /versionsrFNrH)rr+r?rUrVr$r%rJs r get_versionsAssistantsClient.get_versionss[D#  "*J YY^^<. 2 $    s 4=;=cf# SU0nURRSUS3UUUS9IShvN $N7f)aChange the version of an assistant. Args: assistant_id: The assistant ID to delete. version: The version to change to. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. Returns: Assistant Object. ???+ example "Example Usage" ```python client = get_client(url="http://localhost:2024") new_version_assistant = await client.assistants.set_latest( assistant_id="my_assistant_id", version=3 ) ``` versionr'z/latestrFNrH)rr+ryr$r%rJs r set_latestAssistantsClient.set_latestsJ>$-g"6YY^^<. 0 $    s (1/1r)rr rnro)r+strr$Mapping[str, str] | Noner%QueryParamTypes | Nonernr ) r+r|r-z int | boolr$r}r%r~rnzdict[str, list[dict[str, Any]]])r+r|r$r}r%r~rnr)NF) r+r|r: str | Noner8boolr$r}r%r~rnrr)rDrrE Config | Noner>Context | Noner?rr+rr@zOnConflictBehavior | NonerArr$r}rBrr%r~rnr )r+r|rDrrErr>rr?rrArr$r}rBrr%r~rnr ) r+r|rPrr$r}r%r~rnro)r?rrDrrArrUintrVrrWAssistantSortBy | NonerXSortOrder | NonerY!list[AssistantSelectField] | Noner]zLiteral['object']r$r}r%r~rnr )r?rrDrrArrUrrVrrWrrXrrYrr]zLiteral['array']r$r}r%r~rnzlist[Assistant])r?rrDrrArrUrrVrrWrrXrrYrr]zLiteral['array', 'object']r$r}r%r~rnz*AssistantsSearchResponse | list[Assistant]) r?rrDrrArr$r}r%r~rnr)NrTr)r+r|r?rrUrrVrr$r}r%r~rnzlist[AssistantVersion]) r+r|ryrr$r}r%r~rnr )__name__ __module__ __qualname____firstlineno____doc__r r)r2r5r<rKr0rRrr^rsrvrz__static_attributes__r[r"rrrs -1)- + + * + ' +  + b!,0)- 8 8  8 * 8 ' 8  )8 |-1)- w w * w ' w  w x!% $ -1)-$$$ $ * $'$ $R!%E #'#'/3,0"&)-E E E  E  E !E -E E *E  E 'E  E V $ $"&,0"&)-A A  A  A  A A A *A  A 'A  A N %,0)- ( (  ( * ( ' (  ( T#*.'+48,0)-'' '  '  ''('%'2'+'*''' "'' #*.'+48,3,0)-     (%2**' &#*.'+486=,0)-]] ]  ]  ]](]%]2]4]*]'] 4]D#,0)-      *  '   H , -1)-, , ,  ,  , *, ',  , f-1)- & & & * & ' &  & & r"r)r __future__rcollections.abcrtypingrrrrhttpxlanggraph_sdk._async.httpr langgraph_sdk.schemar r r r rrrrrrrrrrr[r"rrs:8"#// 0"A  A  r"