@h5ZSrSSKJr SSKJrJrJr SSKJr SSK J r J r SSK J r Jr SSKJr SSKJrJr SS KJr SS KJrJrJr SS KJr SS KJrJr SS KJ r SSK!J"r" SSK#J$r$ SSK%J&r& SSK'J(r( SSK)J*r* SSK+J,r, \-"5r.\"SSSS9"SS\(55r/S\S\\ S\S\4Sjr0g) zHModule implements an agent that uses OpenAI's APIs function enabled API.)Sequence)AnyOptionalUnion) deprecated) AgentAction AgentFinish)BaseCallbackManager Callbacks)BaseLanguageModel) BaseMessage SystemMessage)BasePromptTemplate)ChatPromptTemplateHumanMessagePromptTemplateMessagesPlaceholder)BaseMessagePromptTemplate)RunnableRunnablePassthrough)BaseTool)convert_to_openai_function)model_validator)Self)BaseSingleActionAgent"format_to_openai_function_messages) OpenAIFunctionsAgentOutputParserz0.1.0create_openai_functions_agentz1.0) alternativeremovalc\rSrSr%Sr\\S'\\\S'\ \S'\ r \ \ \S'S\ \4Sjr\"S S 9S\4S j5r\S\ \4S j5r\S\ \4S j5rSS\ \\\4S\S\S\S\\\44 SjjrSS\ \\\4S\S\S\\\44SjjrS\S\ \\\4S\S\4Sjr \!\"S4S\#\$S\#\ \%S\&4Sjj5r'\!SS\"4S\S\\S\#\(S\#\ \%S\#\$S\S\)4Sjj5r*Sr+g)OpenAIFunctionsAgent&aNAn Agent driven by OpenAIs function powered API. Args: llm: This should be an instance of ChatOpenAI, specifically a model that supports using `functions`. tools: The tools this agent has access to. prompt: The prompt for this agent, should support agent_scratchpad as one of the variables. For an easy way to construct this prompt, use `OpenAIFunctionsAgent.create_prompt(...)` output_parser: The output parser for this agent. Should be an instance of OpenAIFunctionsAgentOutputParser. Defaults to OpenAIFunctionsAgentOutputParser. llmtoolsprompt output_parserreturncVURVs/sHoRPM sn$s snf)zGet allowed tools.)r%nameselfts d/var/www/html/shao/venv/lib/python3.13/site-packages/langchain/agents/openai_functions_agent/base.pyget_allowed_tools&OpenAIFunctionsAgent.get_allowed_tools=s $ + 1 +++s&after)modecrURnSUR;aSUR3n[U5eU$)zValidate prompt. Args: values: Values to validate. Returns: Validated values. Raises: ValueError: If `agent_scratchpad` is not in the prompt. agent_scratchpadzE`agent_scratchpad` should be one of the variables in the prompt, got )r&input_variables ValueError)r,r&msgs r.validate_prompt$OpenAIFunctionsAgent.validate_promptAsG&*[[ V%;%; ;--.0 S/ ! cS/$)z0Get input keys. Input refers to user input here.input)r,s r. input_keysOpenAIFunctionsAgent.input_keysWs yr:chURVs/sHn[[U55PM sn$s snf)zGet functions.)r%dictrr+s r. functionsOpenAIFunctionsAgent.functions\s,>BZZHZ/23ZHHHs/Nintermediate_steps callbackswith_functionskwargsc [U5nURRVs0sHofS:wdM XdU_M nn[S0UDSU0D6nURR"S0UD6n U R 5n U(a&UR RU URUS9n OUR RU US9n URRU 5$s snf)aGiven input, decided what to do. Args: intermediate_steps: Steps the LLM has taken to date, along with observations. callbacks: Callbacks to use. Defaults to None. with_functions: Whether to use functions. Defaults to True. **kwargs: User inputs. Returns: Action specifying what tool to use. If the agent is finished, returns an AgentFinish. If the agent is not finished, returns an AgentAction. r4rBrE)rEr=) rr&r5rA format_prompt to_messagesr$predict_messagesrBr'_parse_ai_message) r,rDrErFrGr4kselected_inputs full_inputsr&messagespredicted_messages r.planOpenAIFunctionsAgent.planbs*>>PQ"&++"="= "=QFXAXLAayL"=  P_P?OP **9[9%%'  $ 9 9..#!:!  !% 9 9#!:! !!334EFF# s C Cc# [U5nURRVs0sHoUS:wdM XSU_M nn[S0UDSU0D6nURR"S0UD6nUR 5n UR RU URUS9IShvN n URRU 5$s snfN$7f)axAsync given input, decided what to do. Args: intermediate_steps: Steps the LLM has taken to date, along with observations. callbacks: Callbacks to use. Defaults to None. **kwargs: User inputs. Returns: Action specifying what tool to use. If the agent is finished, returns an AgentFinish. If the agent is not finished, returns an AgentAction. r4rINr=) rr&r5rArJrKr$apredict_messagesrBr'rM) r,rDrErGr4rNrOrPr&rQrRs r.aplanOpenAIFunctionsAgent.aplans&>>PQ"&++"="= "=QFXAXLAayL"=  P_P?OP **9[9%%'"&(("<"< nn#=#   !!334EFF  s!$CC CA%C C!%Cearly_stopping_methodc US:Xa[SS0S5$US:Xa<UR"U4SS0UD6n[U[5(aU$SU3n[U5eS U3n[U5e) avReturn response when agent has been stopped due to max iterations. Args: early_stopping_method: The early stopping method to use. intermediate_steps: Intermediate steps. **kwargs: User inputs. Returns: AgentFinish. Raises: ValueError: If `early_stopping_method` is not `force` or `generate`. ValueError: If `agent_decision` is not an AgentAction. forceoutputz3Agent stopped due to iteration limit or time limit.generaterFFz,got AgentAction with no functions provided: zBearly_stopping_method should be one of `force` or `generate`, got )r rS isinstancer6)r,rYrDrGagent_decisionr7s r.return_stopped_response,OpenAIFunctionsAgent.return_stopped_responses( !G +PQ  !J .!YY"$N .+66%%@@PQCS/ ! () + or:system_messageextra_prompt_messagescU=(d /nU[LaUO[SS9nU(aU/O/nUR/UQ[R"S5P[ SS9P5 [ US9$)a@Create prompt for this agent. Args: system_message: Message to use as the system message that will be the first in the prompt. extra_prompt_messages: Prompt messages that will be placed between the system message and the new human input. Returns: A prompt template to pass into this agent. You are a helpful AI assistant.contentz{input}r4) variable_name)rQ)_NOT_SETrextendr from_templaterr)clsrcrd_promptssystem_message_rQs r. create_prompt"OpenAIFunctionsAgent.create_prompts").BX- 'HI  )8O$R  *88C $2DE  "844r:callback_managerc dU[LaUO[SS9nURUUS9nU"SUUUUS.UD6$)aConstruct an agent from an LLM and tools. Args: llm: The LLM to use as the agent. tools: The tools to use. callback_manager: The callback manager to use. Defaults to None. extra_prompt_messages: Extra prompt messages to use. Defaults to None. system_message: The system message to use. Defaults to a default system message. kwargs: Additional parameters to pass to the agent. rfrg)rdrc)r$r&r%rrr=)rjrrp) rmr$r%rrrdrcrGror&s r.from_llm_and_tools'OpenAIFunctionsAgent.from_llm_and_toolssf.X- 'HI  """7*#  -     r:r=)NT)N),__name__ __module__ __qualname____firstlineno____doc__r __annotations__rrrrr'typeliststrr/rrr8propertyr>rArBtuplerr boolrrr rSrWra classmethodrjrrrrrpr rrt__static_attributes__r=r:r.r"r"&sT   H  (489,49,'"#*DII4:II $# 'G {C'7!89'G'G 'G  'G {K' ( 'GX $G {C'7!89GG G {K' ( GB)")!{C'7!89) )  )V3;KO 5 / 5 (-F(GH 5  5 5D ;?KO2: # # !# ##67 # (-F(GH # !/ # #  # # r:r"r$r%r&r(c*SUR[UR5-;aSURS3n[U5eUR UVs/sHn[ U5PM snS9n[ R"SS9U-U-[5-$s snf)aCreate an agent that uses OpenAI function calling. Args: llm: LLM to use as the agent. Should work with OpenAI function calling, so either be an OpenAI model that supports that or a wrapper of a different model that adds in equivalent support. tools: Tools this agent has access to. prompt: The prompt to use. See Prompt section below for more. Returns: A Runnable sequence representing an agent. It takes as input all the same input variables as the prompt passed in does. It returns as output either an AgentAction or AgentFinish. Raises: ValueError: If `agent_scratchpad` is not in the prompt. Example: Creating an agent with no memory .. code-block:: python from langchain_community.chat_models import ChatOpenAI from langchain.agents import AgentExecutor, create_openai_functions_agent from langchain import hub prompt = hub.pull("hwchase17/openai-functions-agent") model = ChatOpenAI() tools = ... agent = create_openai_functions_agent(model, tools, prompt) agent_executor = AgentExecutor(agent=agent, tools=tools) agent_executor.invoke({"input": "hi"}) # Using with chat history from langchain_core.messages import AIMessage, HumanMessage agent_executor.invoke( { "input": "what's my name?", "chat_history": [ HumanMessage(content="hi! my name is bob"), AIMessage(content="Hello Bob! How can I assist you today?"), ], } ) Prompt: The agent prompt must have an `agent_scratchpad` key that is a ``MessagesPlaceholder``. Intermediate agent actions and tool output messages will be passed in here. Here's an example: .. code-block:: python from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder prompt = ChatPromptTemplate.from_messages( [ ("system", "You are a helpful assistant"), MessagesPlaceholder("chat_history", optional=True), ("human", "{input}"), MessagesPlaceholder("agent_scratchpad"), ] ) r4zLPrompt must have input variable `agent_scratchpad`, but wasn't found. Found z instead.)rBc[US5$)NrDr)xs r./create_openai_functions_agent..vs'I&'(r:)r4) r5r}partial_variablesr6bindrrassignr)r$r%r&r7r-llm_with_toolss r.rr!sTf&>&>!?? ++,I 7 oXXPU(VPU1)CA)FPU(VXWN""       + , - )WsBN)1rzcollections.abcrtypingrrrlangchain_core._apirlangchain_core.agentsrr langchain_core.callbacksr r langchain_core.language_modelsr langchain_core.messagesr rlangchain_core.promptsrlangchain_core.prompts.chatrrrlangchain_core.prompts.messagerlangchain_core.runnablesrrlangchain_core.toolsr%langchain_core.utils.function_callingrpydanticrtyping_extensionsrlangchain.agentsr3langchain.agents.format_scratchpad.openai_functionsr0langchain.agents.output_parsers.openai_functionsrobjectrjr"rr=r:r.rsN$''*:C<6 EB)L$"2 8 G!@%Pw 0w Qw t\ \ H \ \ \r: