gh NdZddlmZddlmZmZddlmZddlm Z m Z m Z m Z m Z mZmZmZmZddlmZmZmZmZddlmZmZddlmZdd lmZmZmZm Z m!Z!m"Z"m#Z#dd l$m%Z%dd l&m'Z'm(Z(m)Z)dd l*m+Z+dd l,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5m6Z6m7Z7ddl8m9Z9ddl:m;Z;e rddleddZ? Gdde1eZ@Gdde@ZAGdde d ZBGd!d"e d ZCGd#d$e1ZDGd%d&eDZEGd'd(eDZFGd)d*eDZGGd+d,e+eZHee1eeHfZIeeIeJeeKeLfeeKeMeNeMeOffeKeNeKe ffZPGd-d.eHZQ d>d?d8ZR d>d@d<ZSeSZTd=S)AzChat prompt template.) annotations)ABCabstractmethod)Path) TYPE_CHECKING AnnotatedAnyOptional TypedDictTypeVarUnioncastoverload)Field PositiveIntSkipValidationmodel_validator)Selfoverride) deprecated) AIMessage AnyMessage BaseMessage ChatMessage HumanMessage SystemMessageconvert_to_messages)get_msg_title_repr)ChatPromptValueImageURL PromptValue)BasePromptTemplate)DictPromptTemplate)ImagePromptTemplate)BaseMessagePromptTemplate)PromptTemplate)PromptTemplateFormatStringPromptTemplateget_template_variables)get_colored_text)is_interactive_env)SequenceceZdZUdZded< dZded< dZded < dd dfdZddZe ddZ e dddZ xZ S)MessagesPlaceholderaPrompt template that assumes variable is already list of messages. A placeholder which can be used to pass in a list of messages. Direct usage: .. code-block:: python from langchain_core.prompts import MessagesPlaceholder prompt = MessagesPlaceholder("history") prompt.format_messages() # raises KeyError prompt = MessagesPlaceholder("history", optional=True) prompt.format_messages() # returns empty list [] prompt.format_messages( history=[ ("system", "You are an AI assistant."), ("human", "Hello!"), ] ) # -> [ # SystemMessage(content="You are an AI assistant."), # HumanMessage(content="Hello!"), # ] Building a prompt with chat history: .. code-block:: python from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder prompt = ChatPromptTemplate.from_messages( [ ("system", "You are a helpful assistant."), MessagesPlaceholder("history"), ("human", "{question}") ] ) prompt.invoke( { "history": [("human", "what's 5 + 2"), ("ai", "5 + 2 is 7")], "question": "now multiply that by 4" } ) # -> ChatPromptValue(messages=[ # SystemMessage(content="You are a helpful assistant."), # HumanMessage(content="what's 5 + 2"), # AIMessage(content="5 + 2 is 7"), # HumanMessage(content="now multiply that by 4"), # ]) Limiting the number of messages: .. code-block:: python from langchain_core.prompts import MessagesPlaceholder prompt = MessagesPlaceholder("history", n_messages=1) prompt.format_messages( history=[ ("system", "You are an AI assistant."), ("human", "Hello!"), ] ) # -> [ # HumanMessage(content="Hello!"), # ] str variable_nameFbooloptionalNzOptional[PositiveInt] n_messages)r2kwargsr returnNonec @tjd||d|dS)aCreate a messages placeholder. Args: variable_name: Name of variable to use as messages. optional: If True format_messages can be called with no arguments and will return an empty list. If False then a named argument with name `variable_name` must be passed in, even if the value is an empty list. Defaults to False.] r0r2N)super__init__)selfr0r2r4 __class__s X/var/www/FlaskApp/flask-venv/lib/python3.11/site-packages/langchain_core/prompts/chat.pyr;zMessagesPlaceholder.__init__sA  '(  >D     list[BaseMessage]c 2|jr||jgn ||j}t|ts,d|jd|dt |}t |t|}|jr||j d}|S)zFormat messages from kwargs. Args: **kwargs: Keyword arguments to use for formatting. Returns: List of BaseMessage. Raises: ValueError: If variable is not a list of messages. z variable z( should be a list of base messages, got z of type N) r2getr0 isinstancelisttype ValueErrorrr3)r<r4valuemsgs r>format_messagesz#MessagesPlaceholder.format_messagess} ,FJJt)2 . . .*+  %&& "5D.5555'+E{{55 S// !#E** ? .4?*,,-E r? list[str]c$|js|jgngSnInput variables for this prompt template. Returns: List of input variable names. )r2r0r<s r>input_variablesz#MessagesPlaceholder.input_variabless,0=@"##b@r?htmlcd|jzdz}|r"tdd}t|d}ntd}|d|S)Human-readable representation. Args: html: Whether to format as HTML. Defaults to False. Returns: Human-readable representation. {}zMessages PlaceholderTboldyellow )r0rr*)r<rPvartitles r> pretty_reprzMessagesPlaceholder.pretty_reprsdD&&,  ?&'=DIIIE"311CC&'=>>E""S"""r?)r0r/r2r1r4r r5r6r4r r5r@r5rJFrPr1r5r/)__name__ __module__ __qualname____doc____annotations__r2r3r;rIpropertyrOrr[ __classcell__r=s@r>r.r.:sFFP.H3)-J,,,,7<        $8AAAXA####X#####r?r.MessagePromptTemplateTBaseStringMessagePromptTemplate)boundceZdZUdZded< eeZded< e d$d%dZ ed&dZ e d'dZ d'dZ d(dZd(dZed)dZed*d+d#ZdS),rizJBase class for message prompt templates that use a string prompt template.r(promptdefault_factorydictadditional_kwargsf-stringNtemplater/template_formatr'partial_variablesOptional[dict[str, Any]]r4r r5rc Dtj|||}|dd|i|S)aCreate a class from a string template. Args: template: a template. template_format: format of the template. Defaults to "f-string". partial_variables: A dictionary of variables that can be used to partially fill in the template. For example, if the template is `"{variable1} {variable2}"`, and `partial_variables` is `{"variable1": "foo"}`, then the final prompt will be `"foo {variable2}"`. Defaults to None. **kwargs: keyword arguments to pass to the constructor. Returns: A new instance of this class. rsrtrlr9)r& from_template)clsrrrsrtr4rls r>rxz-BaseStringMessagePromptTemplate.from_templatesA0 - +/    s++&+F+++r? template_fileUnion[str, Path]rOrJc @tj||}|dd|i|S)6Create a class from a template file. Args: template_file: path to a template file. String or Path. input_variables: list of input variables. **kwargs: keyword arguments to pass to the constructor. Returns: A new instance of this class. rlr9)r& from_file)ryrzrOr4rls r>from_template_filez2BaseStringMessagePromptTemplate.from_template_files1" )-IIs++&+F+++r?rc dS)Format the prompt template. Args: **kwargs: Keyword arguments to use for formatting. Returns: Formatted message. Nr9r<r4s r>formatz&BaseStringMessagePromptTemplate.formatr?c K|jdi|S)Async format the prompt template. Args: **kwargs: Keyword arguments to use for formatting. Returns: Formatted message. r9rrs r>aformatz'BaseStringMessagePromptTemplate.aformat%s t{$$V$$$r?r@c |jdi|gSzFormat messages from kwargs. Args: **kwargs: Keyword arguments to use for formatting. Returns: List of BaseMessages. r9rrs r>rIz/BaseStringMessagePromptTemplate.format_messages0 %%f%%&&r?c.K|jdi|d{VgSzAsync format messages from kwargs. Args: **kwargs: Keyword arguments to use for formatting. Returns: List of BaseMessages. Nr9rrs r>aformat_messagesz0BaseStringMessagePromptTemplate.aformat_messages;5#dl,,V,,,,,,,,--r?c|jjSrL)rlrOrNs r>rOz/BaseStringMessagePromptTemplate.input_variablesFs{**r?FrPr1c|jjdd}t||}|d|j|S)rRMessagePromptTemplate MessagerUrXrP)r=r`replacerrlr[)r<rPrZs r>r[z+BaseStringMessagePromptTemplate.pretty_reprOsX'//0GTT"5t444AAT[44$4??AAAr?)rqN) rrr/rsr'rtrur4r r5r)rzr{rOrJr4r r5rr4r r5rr\r]r^r_)r`rarbrcrdrrorp classmethodrxrrrrrIrrerOrr[r9r?r>riris@TT    !#eD9999999F1;6: ,,,,[,<,,,[,&   ^  % % % % ' ' ' ' . . . .+++X+ B B B BX B B Br?c0eZdZUdZded< d dZd d Zd S) ChatMessagePromptTemplatezChat message prompt template.r/roler4r r5rc ^|jjdi|}t||j|jS)rcontentrrpr9)rlrrrrpr<r4texts r>rz ChatMessagePromptTemplate.formatesA"t{!++F++tyDrz!ChatMessagePromptTemplate.aformatssW)T[(22622222222tyDrr_sP'' III            r?rceZdZUded<dS)_TextTemplateParamUnion[str, dict]rNr`rarbrdr9r?r>rrsr?rF)totalceZdZUded<dS)_ImageTemplateParamr image_urlNrr9r?r>rrsr?rceZdZUdZded< eeZded< ded<e d*d d d+dZ ed,dZ d-dZ d-d Z e d.d!Zd/d#Zd/d$Zed0d1d)Zd S)2!_StringImageMessagePromptTemplateDHuman message prompt template. This is a message sent from the user.zgUnion[StringPromptTemplate, list[Union[StringPromptTemplate, ImagePromptTemplate, DictPromptTemplate]]]rlrmrorptype[BaseMessage] _msg_classrqN)rtry type[Self]rrUUnion[str, list[Union[str, _TextTemplateParam, _ImageTemplateParam, dict[str, Any]]]]rsr'rtrur4r r5rc 6t|tr!tj|||}|dd|i|St|tr|$t |dkrd}t |g}|D]}t|ts@t|trd|vrt| ddhkrXt|tr|}ntd|d}| tj|| t|trJd |vrEt| dd hkrtd |d } g} t| tr\t| |} | r3t | d krd | d|}t || dg} d| i} t| | |} n}t| trTt| } dD]/} | | vr)| t| | |0t| | |} nd|}t || | t|trM|dkrd}t |ttd||}| |rd|}t ||dd|i|Sd|}t |)aDCreate a class from a string template. Args: template: a template. template_format: format of the template. Options are: 'f-string', 'mustache', 'jinja2'. Defaults to "f-string". partial_variables: A dictionary of variables that can be used too partially. Defaults to None. **kwargs: keyword arguments to pass to the constructor. Returns: A new instance of this class. Raises: ValueError: If the template is not a string or list of strings. rwrlNrz:Partial variables are not supported for list of templates.rrErrsrrz:Only one format variable allowed per image template. Got: z From: url)rOrrrs)rpathdetailzInvalid image template: jinja2zsjinja2 is unsafe and is not supported for templates expressed as dicts. Please use 'f-string' or 'mustache' format.zdict[str, Any])rrrszInvalid template: r9)rCr/r&rxrDlenrFrosetkeysrappendr)r$extendr#)ryrrrsrtr4rlrHtmplr img_templaterOvarsimg_template_objkeydata_template_objs r>rxz/_StringImageMessagePromptTemplate.from_templates8 h $ $ 08F8T /"3999F 3//f/// / h % %S 0!-37H3I3IA3M3MR oo%F M *M *tS))L*!$--L*$DIIKK((VV,<<<!$,,H$(#$8$??GMM&4 / tT**=*#t++DIIKK((# $((=t#D#D[#QL&(O!,44!.5lOTT8"4yy1}}%68<%6%6/3%6%6!$ '1oo 5/3AwiO(-|'< +>,;%1,;,,,(( $L$77.'+L'9'9 #<""C"l22 / 6 6$:(4S(9?%&%&!"!"!" ,?,;%1,;,,,(( @??(oo-MM"23333d++*&(22& )oo-(:!%&6!=!=(7)))%MM"344445t55C$S//)3//f/// /-8--oor?rzr{rOrJc dt|}|j|fd|i|S)r}rO)r read_textrx)ryrzrOr4rrs r>rz4_StringImageMessagePromptTemplate.from_template_files=" &&0022 s UU?UfUUUr?r@c |jdi|gSrrrs r>rIz1_StringImageMessagePromptTemplate.format_messages%rr?c.K|jdi|d{VgSrrrs r>rz2_StringImageMessagePromptTemplate.aformat_messages0rr?clt|jtr|jn|jg}d|DS)rMc&g|]}|jD]}|Sr9rO).0rlivs r> zE_StringImageMessagePromptTemplate.input_variables..Cs(JJJv63IJJRJJJJr?)rCrlrD)r<promptss r>rOz1_StringImageMessagePromptTemplate.input_variables;s8",DK!>!>Q$++T[MJJJJJJr?rc dt|jtr.|jjdi}|||jSg}|jD]}fd|jD}t|tr&|jdi|}|d|dPt|tr&|jdi|}|d|dt|tr"|jdi|}|||||jS)rrrpc"i|] }|| Sr9r9rrYr4s r> z<_StringImageMessagePromptTemplate.format..UIII3c6#;IIIr?rrErrrErr9) rCrlr(rrrprOrr$r#r<r4rrrlinputs formatteds ` r>rz(_StringImageMessagePromptTemplate.formatEs dk#7 8 8 %4;%////D??0F# k * *FIIII&2HIIIF&"677 *BO&-CCCC  BBCCCCF$788 *)FM33F33  )LLMMMMF$677 *)FM33F33 y)))t/E   r?cKt|jtr4|jjdid{V}|||jSg}|jD]}fd|jD}t|tr,|jdi|d{V}|d|dVt|tr,|jdi|d{V}|d|dt|tr"|j di|}|||||jS) rNrc"i|] }|| Sr9r9rs r>rz=_StringImageMessagePromptTemplate.aformat..urr?rrrrr9) rCrlr(rrrprOrr$r#rrs ` r>rz)_StringImageMessagePromptTemplate.aformates dk#7 8 8 ,,66v66666666D??0F# k * *FIIII&2HIIIF&"677 *HVIIIICCCCCC  BBCCCCF$788 *"0&.":":6":":::::::  )LLMMMMF$677 *)FM33F33 y)))t/E   r?FrPr1r/c|jjdd}t|}t |jt r|jn|jg}dfd|D}|d|S)rRrrrUrXc3DK|]}|VdSrNr[)rrlrPs r> z@_StringImageMessagePromptTemplate.pretty_repr..s4"W"WV6#5#54#5#@#@"W"W"W"W"W"Wr?)r=r`rrrCrlrDjoin)r<rPrZr prompt_reprss ` r>r[z-_StringImageMessagePromptTemplate.pretty_reprs'//0GTT"5t444!+DK!>!>Q$++T[M{{"W"W"W"Ww"W"W"WWW ++\+++r?rq) ryrrrrrsr'rtrur4r r5r) ryrrzr{rOrJr4r r5rr\r]rr^r_)r`rarbrcrdrrorprrxrrIrrerOrrrr[r9r?r>rrsaNN#eD9999999F!!!!1; w7;wwwww[wrVVV[V& ' ' ' ' . . . .KKKXK    @    @,,,,X,,,r?rc"eZdZUdZeZded<dS)HumanMessagePromptTemplaterrrN)r`rarbrcrrrdr9r?r>rrs)NN$0J000000r?rc"eZdZUdZeZded<dS)AIMessagePromptTemplatez?AI message prompt template. This is a message sent from the AI.rrN)r`rarbrcrrrdr9r?r>rrs)II$-J------r?rc"eZdZUdZeZded<dS)SystemMessagePromptTemplatezYSystem message prompt template. This is a message that is not sent to the user. rrN)r`rarbrcrrrdr9r?r>rrs/ %2J111111r?rceZdZdZeeddZddZdd Zdd Z dd Z e ddZ ddZ dddZddZdS)BaseChatPromptTemplatez%Base class for chat prompt templates.r5rocd|jiS)NrOrrNs r> lc_attributesz$BaseChatPromptTemplate.lc_attributess"4#788r?r4r r/c @|jdi|S)a Format the chat template into a string. Args: **kwargs: keyword arguments to use for filling in template variables in all the template messages in this chat template. Returns: formatted string. r9) format_prompt to_stringrs r>rzBaseChatPromptTemplate.formats)"t!++F++55777r?cPK|jdi|d{VS)aAsync format the chat template into a string. Args: **kwargs: keyword arguments to use for filling in template variables in all the template messages in this chat template. Returns: formatted string. Nr9)aformat_promptrrs r>rzBaseChatPromptTemplate.aformats?*d)33F33333333>>@@@r?r!c <|jdi|}t|S)zFormat prompt. Should return a PromptValue. Args: **kwargs: Keyword arguments to use for formatting. Returns: PromptValue. messagesr9)rIrr<r4rs r>rz$BaseChatPromptTemplate.format_prompts-(4'11&111111r?cLK|jdi|d{V}t|S)zAsync format prompt. Should return a PromptValue. Args: **kwargs: Keyword arguments to use for formatting. Returns: PromptValue. Nrr9)rrrs r>rz%BaseChatPromptTemplate.aformat_promptsC/.88888888881111r?r@c dS)z&Format kwargs into a list of messages.Nr9rs r>rIz&BaseChatPromptTemplate.format_messagesrr?c K|jdi|S)z,Async format kwargs into a list of messages.r9)rIrs r>rz'BaseChatPromptTemplate.aformat_messagess#t#--f---r?FrPr1ct)rRNotImplementedErrorr<rPs r>r[z"BaseChatPromptTemplate.pretty_reprs "!r?r6cdt|tdS)z&Print a human-readable representation.rN)printr[r+rNs r> pretty_printz#BaseChatPromptTemplate.pretty_prints. d$6$8$899:::::r?N)r5ro)r4r r5r/)r4r r5r!r\r^r_)r5r6)r`rarbrcrerrrrrrrrIrr[rr9r?r>rrs//  999XX9 8 8 8 8 A A A A 2 2 2 2 2 2 2 2555^5....  " " " " ";;;;;;r?rceZdZUdZded< dZded< ddd?fdZed@dZdAdZ e dedBdZ edCdZ ee ddd dDd#Zee ddd dEd%Ze dFdGd&ZdHd(ZdHd)ZdId*ZdJd-ZdKd.ZedLd2ZedMd4ZdNd7ZdOd8ZedPd9ZdQd<ZedRdSd>ZxZS)TChatPromptTemplateaPrompt template for chat models. Use to create flexible templated prompts for chat models. Examples: .. versionchanged:: 0.2.24 You can pass any Message-like formats supported by ``ChatPromptTemplate.from_messages()`` directly to ``ChatPromptTemplate()`` init. .. code-block:: python from langchain_core.prompts import ChatPromptTemplate template = ChatPromptTemplate([ ("system", "You are a helpful AI bot. Your name is {name}."), ("human", "Hello, how are you doing?"), ("ai", "I'm doing well, thanks!"), ("human", "{user_input}"), ]) prompt_value = template.invoke( { "name": "Bob", "user_input": "What is your name?" } ) # Output: # ChatPromptValue( # messages=[ # SystemMessage(content='You are a helpful AI bot. Your name is Bob.'), # HumanMessage(content='Hello, how are you doing?'), # AIMessage(content="I'm doing well, thanks!"), # HumanMessage(content='What is your name?') # ] #) Messages Placeholder: .. code-block:: python # In addition to Human/AI/Tool/Function messages, # you can initialize the template with a MessagesPlaceholder # either using the class directly or with the shorthand tuple syntax: template = ChatPromptTemplate([ ("system", "You are a helpful AI bot."), # Means the template will receive an optional list of messages under # the "conversation" key ("placeholder", "{conversation}") # Equivalently: # MessagesPlaceholder(variable_name="conversation", optional=True) ]) prompt_value = template.invoke( { "conversation": [ ("human", "Hi!"), ("ai", "How can I assist you today?"), ("human", "Can you make me an ice cream sundae?"), ("ai", "No.") ] } ) # Output: # ChatPromptValue( # messages=[ # SystemMessage(content='You are a helpful AI bot.'), # HumanMessage(content='Hi!'), # AIMessage(content='How can I assist you today?'), # HumanMessage(content='Can you make me an ice cream sundae?'), # AIMessage(content='No.'), # ] #) Single-variable template: If your prompt has only a single input variable (i.e., 1 instance of "{variable_nams}"), and you invoke the template with a non-dict object, the prompt template will inject the provided argument into that variable location. .. code-block:: python from langchain_core.prompts import ChatPromptTemplate template = ChatPromptTemplate([ ("system", "You are a helpful AI bot. Your name is Carl."), ("human", "{user_input}"), ]) prompt_value = template.invoke("Hello, there!") # Equivalent to # prompt_value = template.invoke({"user_input": "Hello, there!"}) # Output: # ChatPromptValue( # messages=[ # SystemMessage(content='You are a helpful AI bot. Your name is Carl.'), # HumanMessage(content='Hello, there!'), # ] # ) z.Annotated[list[MessageLike], SkipValidation()]rFr1validate_templaterqr#Sequence[MessageLikeRepresentation]rsr'r4r r5r6c fd|D}t}t}i}|D]y}t|tr,|jr%g||j<||jCt|t tfr||j zt|t||d|}tdtj dd|i|dS)adCreate a chat prompt template from a variety of message formats. Args: messages: sequence of message representations. A message can be represented using the following formats: (1) BaseMessagePromptTemplate, (2) BaseMessage, (3) 2-tuple of (message type, template); e.g., ("human", "{user_input}"), (4) 2-tuple of (message class, template), (5) a string which is shorthand for ("human", template); e.g., "{user_input}". template_format: format of the template. Defaults to "f-string". input_variables: A list of the names of the variables whose values are required as inputs to the prompt. optional_variables: A list of the names of the variables for placeholder or MessagePlaceholder that are optional. These variables are auto inferred from the prompt and user need not provide them. partial_variables: A dictionary of the partial variables the prompt template carries. Partial variables populate the template so that you don't need to pass them in every time you call the prompt. validate_template: Whether to validate the template. input_types: A dictionary of the types of the variables the prompt template expects. If not provided, all variables are assumed to be strings. Returns: A chat prompt template. Examples: Instantiation from a list of message templates: .. code-block:: python template = ChatPromptTemplate([ ("human", "Hello, how are you?"), ("ai", "I'm doing well, thanks!"), ("human", "That's good to hear."), ]) Instantiation from mixed message formats: .. code-block:: python template = ChatPromptTemplate([ SystemMessage(content="hello"), ("human", "Hello, how are you?"), ]) c0g|]}t|Sr9_convert_to_message_template)rmessagerss r>rz/ChatPromptTemplate.__init__..s3    )/ B B   r?)rOoptional_variablesrtztype[ChatPromptTemplate]rNr9)rrCr.r2r0addrr%updaterOsortedrr:r;) r<rrsr4 _messages input_varsr  partial_vars_messager=s ` r>r;zChatPromptTemplate.__init__~s:l    #   #uu '*uu') ! < >>>13LM <!!(":;;; &j11"();"<"get_lc_namespacez#ChatPromptTemplate.get_lc_namespaces0///r?otherc i|j}t|dr!|jr||jt|tr(t |j|jzjdi|St|tttfr$t |j|gzjdi|St|ttfrBt |}t |j|jzjdi|St|tr>t|}t |j|gzjdi|Sdt!|}t#|)zCombine two prompt templates. Args: other: Another prompt template. Returns: Combined prompt template. rtrz Unsupported operand type for +: Nr9)rthasattrr rCrrpartialr%rrrDtuple from_messagesr/rrxrEr)r<rpartials_otherrlrHs r>__add__zChatPromptTemplate.__add__s.d,- 5- . . 553J 5 OOE3 4 4 4 e/ 0 0 V%t}u~/MNNNV   -{>!#&&&r?before)modevaluesroc.|d}t}t}|di}|D]}t|ttfr||jt|trld|vri|d<|jr9|j |dvr*g|d|j <| |j |j |vrtt||j <d|vr|t|dz }|r||z }d|vrL|dr7|t|dkrd|d|d}t|nt||d<|rt||d<||d<|S) aGValidate input variables. If input_variables is not set, it will be set to the union of all input variables in the messages. Args: values: values to validate. Returns: Validated values. Raises: ValueError: If input variables do not match. r input_typesrtrOrz*Got mismatched input_variables. Expected: z. Got: r )rrBrCr%rr rOr.r2r0r rDrrFr )ryr rrr r"rrHs r>validate_input_variablesz+ChatPromptTemplate.validate_input_variabless"*%%%  UU&,jj&C&C  J JG'$=?U#VWW ;!!'"9:::'#677 J&f4424F./$B-Vrxz ChatPromptTemplate.from_template1sB)6xJJ6JJ,ODDD  '+++r?z0.0.1rT) alternativependingstring_messageslist[tuple[str, str]]c.|d|DS)zCreate a chat prompt template from a list of (role, template) tuples. Args: string_messages: list of (role, template) tuples. Returns: a chat prompt template. cLg|]!\}}t||"S))r)rrx)rrrrs r>rz8ChatPromptTemplate.from_role_strings..Qs?"D(*77t7LLr?rr9ryr)s r>from_role_stringsz$ChatPromptTemplate.from_role_stringsCs9s&5    r?1list[tuple[type[BaseMessagePromptTemplate], str]]c,||S)zCreate a chat prompt template from a list of (role class, template) tuples. Args: string_messages: list of (role class, template) tuples. Returns: a chat prompt template. )rr-s r> from_stringszChatPromptTemplate.from_stringsWs  111r?c|||S)aCreate a chat prompt template from a variety of message formats. Examples: Instantiation from a list of message templates: .. code-block:: python template = ChatPromptTemplate.from_messages([ ("human", "Hello, how are you?"), ("ai", "I'm doing well, thanks!"), ("human", "That's good to hear."), ]) Instantiation from mixed message formats: .. code-block:: python template = ChatPromptTemplate.from_messages([ SystemMessage(content="hello"), ("human", "Hello, how are you?"), ]) Args: messages: sequence of message representations. A message can be represented using the following formats: (1) BaseMessagePromptTemplate, (2) BaseMessage, (3) 2-tuple of (message type, template); e.g., ("human", "{user_input}"), (4) 2-tuple of (message class, template), (5) a string which is shorthand for ("human", template); e.g., "{user_input}". template_format: format of the template. Defaults to "f-string". Returns: a chat prompt template. rr9)ryrrss r>rz ChatPromptTemplate.from_messagesfsPs8_====r?r@c 4|jdi|}g}|jD]}t|tr||g.t|t t fr#|jdi|}||md|}t||S)a(Format the chat template into a list of finalized messages. Args: **kwargs: keyword arguments to use for filling in template variables in all the template messages in this chat template. Returns: list of formatted messages. Unexpected input: r9) !_merge_partial_and_user_variablesrrCrrr%rrIrFr<r4resultmessage_templaterrHs r>rIz"ChatPromptTemplate.format_messagess87AA&AA $ & & *K88 & /01111 #<>T"U &;*:DDVDD g&&&&=+;== oo% r?cDK|jdi|}g}|jD]}t|tr||g.t|t t fr)|jdi|d{V}||sd|}t||S)alAsync format the chat template into a list of finalized messages. Args: **kwargs: keyword arguments to use for filling in template variables in all the template messages in this chat template. Returns: list of formatted messages. Raises: ValueError: If unexpected input. Nr4r9) r5rrCrrr%rrrFr6s r>rz#ChatPromptTemplate.aformat_messagess87AA&AA $ & & *K88 & /01111 #<>T"U &!B 0 A K KF K KKKKKKK g&&&&=+;== oo% r?c |j}tt|j||d<i|j||d<t|di|S)aGet a new ChatPromptTemplate with some input variables already filled in. Args: **kwargs: keyword arguments to use for filling in template variables. Ought to be a subset of the input variables. Returns: A new ChatPromptTemplate. Example: .. code-block:: python from langchain_core.prompts import ChatPromptTemplate template = ChatPromptTemplate.from_messages( [ ("system", "You are an AI assistant named {name}."), ("human", "Hi I'm {user}"), ("ai", "Hi there, {user}, I'm {name}."), ("human", "{input}"), ] ) template2 = template.partial(user="Lucy", name="R2D2") template2.format_messages(input="hello") rOrtr9)__dict__copyrDrrO differencertrE)r<r4 prompt_dicts r>rzChatPromptTemplate.partials:m((** )- $ % % 0 0 8 8* * %&,Pd.D+O+O '(tDzz((K(((r?rMessageLikeRepresentationcT|jt|dS)zAppend a message to the end of the chat template. Args: message: representation of a message to append. N)rrr)r<rs r>rzChatPromptTemplate.appends) 9'BBCCCCCr?cN|jd|DdS)zExtend the chat template with a sequence of messages. Args: messages: sequence of message representations to append. c,g|]}t|Sr9r)rrs r>rz-ChatPromptTemplate.extend..s! K K Kw )' 2 2 K K Kr?N)rr)r<rs r>rzChatPromptTemplate.extends9  K K( K K K     r?indexint MessageLikecdSNr9r<rCs r> __getitem__zChatPromptTemplate.__getitem__s69cr?slicecdSrGr9rHs r>rIzChatPromptTemplate.__getitem__s?Bsr?Union[int, slice]&Union[MessageLike, ChatPromptTemplate]ct|trU|t|j\}}}|j|||}t |S|j|S)z$Use to index into the chat template.)rCrJindicesrrrr)r<rCstartstopsteprs r>rIzChatPromptTemplate.__getitem__sk eU # # > % c$-.@.@ A A E4}U4_5H%33H== =}U##r?c*t|jS)z$Get the length of the chat template.)rrrNs r>__len__zChatPromptTemplate.__len__ s4=!!!r?cdS)z,Name of prompt type. Used for serialization.rr9rNs r> _prompt_typezChatPromptTemplate._prompt_types vr? file_pathUnion[Path, str]ct)zQSave prompt to file. Args: file_path: path to file. r)r<rWs r>savezChatPromptTemplate.saves "!r?rPcPdfd|jDS)rRrXc3DK|]}|VdSrr)rrHrPs r>rz1ChatPromptTemplate.pretty_repr..'s1OO#3???55OOOOOOr?)rrrs `r>r[zChatPromptTemplate.pretty_reprs.{{OOOOOOOOOOr?)rrrsr'r4r r5r6r])rr r5r)r ror5r )rrr/r4r r5r)r)r*r5r)r)r/r5rr)rrrsr'r5rr\)r4r r5r)rr?r5r6)rrr5r6)rCrDr5rE)rCrJr5r)rCrLr5rM)r5rD)r5r/)rWrXr5r6r^r_)r`rarbrcrdrr;rrrrr#rxrr.r1rrIrrrrrrIrTrerVrZrr[rfrgs@r>rr sjjX=<<<U#####8 1; NYNYNYNYNYNYNYNY`000[0&'&'&'&'P_(###222[$#2h,,,[,"Z_dCCC   DC[ $Z_dCCC 2 2 2DC[ 21;'>'>'>'>['>R28")")")")HDDDD    999X9 BBBXB$$$$""""X"""" P P P PX P P P P Pr?rrq message_typer/rrUnion[str, list]rsr'r5r%ct|dvrt||}n|dvr,ttd||}ne|dkr,ttd||}n3|dkrt |t rI|ddks |d d krd |d }t||d d }t|d}nt|dkrt |d trw|\}}t |t sd|}t||ddks |d d krd |d }t||d d }t||}n)d|}t|d|d}t||S)aCreate a message prompt template from a message type and template string. Args: message_type: str the type of the message template (e.g., "human", "ai", etc.) template: str the template string. template_format: format of the template. Defaults to "f-string". Returns: a message prompt template of the appropriate type. Raises: ValueError: If unexpected message type. )humanuserr)ai assistantr/system placeholderrrSrTzInvalid placeholder template: z6. Expected a variable name surrounded by curly braces.rTr8z,Expected variable name to be a string. Got: zUnexpected arguments for placeholder message type. Expected either a single string variable name or a list of [variable_name: str, is_optional: bool]. Got: zUnexpected message type: z=. Use one of 'human', 'user', 'ai', 'assistant', or 'system'.) rrxrrrrCr/rFr.rr1)r]rrrsrrHvar_namevar_name_wrapped is_optionals r>"_create_template_from_message_typerk*sN$(((-G-U-U o.V. .  , , ,)77  ! !?8    ! !-;;  ! !?<    & & h $ $ "{c!!Xb\S%8%8LXLLL!oo%"~H)4PPPGG ]]a  Jx{D$A$A ,4 ) k.44 &WEUWW oo%"c))-=b-AS-H-HL5ELLL!oo%'"-H);WWWGG$"$$  S// ! 8  8 8 8 oo Nr?rr?EUnion[BaseMessage, BaseMessagePromptTemplate, BaseChatPromptTemplate]c t|ttfr|}nbt|tr|}nIt|trt d||}n t|t tfrt|trKt| ddhkrd|}t||d|df}t|dkrd|}t||\}}t|trt |||}nP|tj td|| }n!d t|}t!||S) aInstantiate a message from a variety of message formats. The message format can be one of the following: - BaseMessagePromptTemplate - BaseMessage - 2-tuple of (role string, template); e.g., ("human", "{user_input}") - 2-tuple of (message class, template) - string: shorthand for ("human", template); e.g., "{user_input}" Args: message: a representation of a message in one of the supported formats. template_format: format of the template. Defaults to "f-string". Returns: an instance of a message or a message template. Raises: ValueError: If unexpected message type. ValueError: If 2-tuple does not have 2 elements. r`rrrzrrqs2'57MNOO#'   G[ ) )' GS ! !'5 Wo    GeT] + +' gt $ $ <7<<>>""y&&999'$''!oo%v (:;G w<<1  HwHHCS// !%,"( & , , 9 (OHH('%3))?HH ;4==::!#&&& Or?Nr)r]r/rrr^rsr'r5r%)rr?rsr'r5rl)Urc __future__rabcrrpathlibrtypingrrr r r r r rrpydanticrrrrtyping_extensionsrrlangchain_core._apirlangchain_core.messagesrrrrrrrlangchain_core.messages.baserlangchain_core.prompt_valuesrr r!langchain_core.prompts.baser"langchain_core.prompts.dictr#langchain_core.prompts.imager$langchain_core.prompts.messager%langchain_core.prompts.promptr&langchain_core.prompts.stringr'r(r)langchain_core.utilsr*$langchain_core.utils.interactive_envr+collections.abcr,r.rhrirrrrrrrrrErr/rErDroobjectr?rrkr_convert_to_messager9r?r>rs""""""########                       -,,,,,,,******<;;;;;OOOOOOOOOO::::::::::::<<<<<<988888 211111CCCCCC)((((((\#\#\#\#\#3\#\#\#~!$E2}B}B}B}B}B&?}B}B}B@      ?    F%     )5    J,J,J,J,J,(AJ,J,J,Z11111!B111 .....?... 22222"C222P;P;P;P;P;/P;P;P;f-{>>>>D3r?