a
    •˜ëjàõ  ã                   @  sØ  d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl	m
Z
 ddlmZmZmZ ddlmZ ddlmZmZmZmZmZ ddlZddlmZ dd	lmZmZmZ dd
lmZm Z m!Z!m"Z"m#Z#m$Z$ ddl%m&Z& ddl'm(Z( ddl)m*Z* ddl+m,Z, ddl-m.Z. ddl/m0Z0 ddl1m2Z2 ddl3m4Z4m5Z5m6Z6 ddl7m8Z8 ddl9m:Z: ddl;m<Z< ddl=m>Z>m?Z?m@Z@ ddlAmBZBmCZC ddlDmEZE ddlFmGZG ddlHmIZI ddlJmKZK ddlLmMZM ddlNmOZO ddlPmQZQ e ReS¡ZTG dd „ d e>ƒZUG d!d"„ d"e>ƒZVG d#d$„ d$e,eeef  ƒZWG d%d&„ d&e,eeXe ef  ƒZYG d'd(„ d(eUƒZZG d)d*„ d*eVƒZ[ed+eEd,d-�G d.d/„ d/eUƒƒZ\ed+eEd,d-�G d0d1„ d1eUƒƒZ]G d2d3„ d3e:ƒZ^eXeeeef  Z_eeZe[f Z`G d4d5„ d5eMƒZadS )6zEChain that takes in an input and produces an action and action input.é    )ÚannotationsN)Úabstractmethod)ÚAsyncIteratorÚIteratorÚSequence)ÚPath)ÚAnyÚCallableÚOptionalÚUnionÚcast)Ú
deprecated)ÚAgentActionÚAgentFinishÚ	AgentStep)ÚAsyncCallbackManagerForChainRunÚAsyncCallbackManagerForToolRunÚBaseCallbackManagerÚCallbackManagerForChainRunÚCallbackManagerForToolRunÚ	Callbacks)ÚOutputParserException)ÚBaseLanguageModel)ÚBaseMessage)ÚBaseOutputParser)ÚBasePromptTemplate)ÚFewShotPromptTemplate)ÚPromptTemplate)ÚRunnableÚRunnableConfigÚensure_config)ÚAddableDict)ÚBaseTool)Úget_color_mapping)Ú	BaseModelÚ
ConfigDictÚmodel_validator)ÚSelfÚoverride)ÚAGENT_DEPRECATION_WARNING)ÚAgentExecutorIterator)Ú	AgentType)ÚInvalidTool)ÚChain)ÚLLMChain)Úasyncio_timeoutc                      sö   e Zd ZdZeddœdd„ƒZddœdd„Zed-d
ddddœdd„ƒZed.d
ddddœdd„ƒZ	eeddœdd„ƒƒZ
dd
dddœdd„Zed/ddddd dœdd„ƒZeddœd d!„ƒZedd"d#œ‡ fd$d%„ƒZd&d'd(œd)d*„Zd"dœd+d,„Z‡  ZS )0ÚBaseSingleActionAgentzBase Single Action Agent class.ú	list[str]©Úreturnc                 C  s   dgS ©úReturn values of the agent.Úoutput© ©Úselfr7   r7   úU/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/langchain/agents/agent.pyÚreturn_values=   s    z#BaseSingleActionAgent.return_valuesúOptional[list[str]]c                 C  s   dS )úGet allowed tools.Nr7   r8   r7   r7   r:   Úget_allowed_toolsB   s    z'BaseSingleActionAgent.get_allowed_toolsNúlist[tuple[AgentAction, str]]r   r   úUnion[AgentAction, AgentFinish]©Úintermediate_stepsÚ	callbacksÚkwargsr3   c                 K  s   dS )á0  Given input, decided what to do.

        Args:
            intermediate_steps: Steps the LLM has taken to date,
                along with observations.
            callbacks: Callbacks to run.
            **kwargs: User inputs.

        Returns:
            Action specifying what tool to use.
        Nr7   ©r9   rB   rC   rD   r7   r7   r:   ÚplanF   s    zBaseSingleActionAgent.planc                 Ë  s   dS )á6  Async given input, decided what to do.

        Args:
            intermediate_steps: Steps the LLM has taken to date,
                along with observations.
            callbacks: Callbacks to run.
            **kwargs: User inputs.

        Returns:
            Action specifying what tool to use.
        Nr7   rF   r7   r7   r:   ÚaplanY   s    zBaseSingleActionAgent.aplanc                 C  s   dS ©ú7Return the input keys.

        :meta private:
        Nr7   r8   r7   r7   r:   Ú
input_keysl   s    z BaseSingleActionAgent.input_keysÚstrr   ©Úearly_stopping_methodrB   Ú_r3   c                 K  s.   |dkrt ddidƒS d|› d�}t|ƒ‚dS )áŸ  Return response when agent has been stopped due to max iterations.

        Args:
            early_stopping_method: Method to use for early stopping.
            intermediate_steps: Steps the LLM has taken to date,
                along with observations.

        Returns:
            AgentFinish: Agent finish object.

        Raises:
            ValueError: If `early_stopping_method` is not supported.
        Úforcer6   ú3Agent stopped due to iteration limit or time limit.Ú ú'Got unsupported early_stopping_method `ú`N©r   Ú
ValueError©r9   rO   rB   rP   Úmsgr7   r7   r:   Úreturn_stopped_responset   s    þz-BaseSingleActionAgent.return_stopped_responser   úSequence[BaseTool]úOptional[BaseCallbackManager])ÚllmÚtoolsÚcallback_managerrD   r3   c                 K  s   t ‚dS )a.  Construct an agent from an LLM and tools.

        Args:
            llm: Language model to use.
            tools: Tools to use.
            callback_manager: Callback manager to use.
            kwargs: Additional arguments.

        Returns:
            BaseSingleActionAgent: Agent object.
        N©ÚNotImplementedError)Úclsr^   r_   r`   rD   r7   r7   r:   Úfrom_llm_and_tools�   s    z(BaseSingleActionAgent.from_llm_and_toolsc                 C  s   t ‚dS ©z#Return Identifier of an agent type.Nra   r8   r7   r7   r:   Ú_agent_type¥   s    z!BaseSingleActionAgent._agent_typeúbuiltins.dict©rD   r3   c                   sZ   t ƒ  ¡ }z
| j}W n ty*   d}Y n0 t|tƒrFt|jƒ|d< n|durV||d< |S )z{Return dictionary representation of agent.

        Returns:
            Dict: Dictionary representation of agent.
        NÚ_type)ÚsuperÚ
model_dumprf   rb   Ú
isinstancer+   rM   Úvalue)r9   rD   Ú_dictri   ©Ú	__class__r7   r:   Údictª   s    



zBaseSingleActionAgent.dictúUnion[Path, str]ÚNone©Ú	file_pathr3   c                 C  sò   t |tƒrt|ƒn|}|j}|jddd� |  ¡ }d|vrNd| › d�}t|ƒ‚|jdkr”| d¡� }t	j
||dd	� W d
  ƒ qî1 sˆ0    Y  nZ|j d¡rÜ| d¡� }tj
||dd� W d
  ƒ qî1 sÐ0    Y  n|› d�}t|ƒ‚d
S )zûSave the agent.

        Args:
            file_path: Path to file to save the agent to.

        Example:
        .. code-block:: python

            # If working with agent executor
            agent.agent.save(file_path="path/agent.yaml")

        T©ÚparentsÚexist_okri   úAgent z does not support savingú.jsonÚwé   ©ÚindentN©z.yamlz.ymlF©Zdefault_flow_styleú must be json or yaml)rl   rM   r   ÚparentÚmkdirrq   rb   ÚsuffixÚopenÚjsonÚdumpÚendswithÚyamlrX   )r9   ru   Ú	save_pathÚdirectory_pathÚ
agent_dictrZ   Úfr7   r7   r:   Úsave¼   s    
00
zBaseSingleActionAgent.savec                 C  s   i S ©ú#Return logging kwargs for tool run.r7   r8   r7   r7   r:   Útool_run_logging_kwargsß   s    z-BaseSingleActionAgent.tool_run_logging_kwargs)N)N)N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Úpropertyr;   r>   r   rG   rI   rL   r[   Úclassmethodrd   rf   r(   rq   rŽ   r‘   Ú__classcell__r7   r7   ro   r:   r0   :   s.    ý ý ü#r0   c                      sÚ   e Zd ZdZeddœdd„ƒZddœdd„Zed'd
ddddœdd„ƒZed(d
ddddœdd„ƒZ	eeddœdd„ƒƒZ
dd
dddœdd„Zeddœdd„ƒZedddœ‡ fdd„ƒZd d!d"œd#d$„Zddœd%d&„Z‡  ZS ))ÚBaseMultiActionAgentzBase Multi Action Agent class.r1   r2   c                 C  s   dgS r4   r7   r8   r7   r7   r:   r;   ç   s    z"BaseMultiActionAgent.return_valuesr<   c                 C  s   dS )z]Get allowed tools.

        Returns:
            Optional[List[str]]: Allowed tools.
        Nr7   r8   r7   r7   r:   r>   ì   s    z&BaseMultiActionAgent.get_allowed_toolsNr?   r   r   ú%Union[list[AgentAction], AgentFinish]rA   c                 K  s   dS )a5  Given input, decided what to do.

        Args:
            intermediate_steps: Steps the LLM has taken to date,
                along with the observations.
            callbacks: Callbacks to run.
            **kwargs: User inputs.

        Returns:
            Actions specifying what tool to use.
        Nr7   rF   r7   r7   r:   rG   ô   s    zBaseMultiActionAgent.planc                 Ë  s   dS )a;  Async given input, decided what to do.

        Args:
            intermediate_steps: Steps the LLM has taken to date,
                along with the observations.
            callbacks: Callbacks to run.
            **kwargs: User inputs.

        Returns:
            Actions specifying what tool to use.
        Nr7   rF   r7   r7   r:   rI     s    zBaseMultiActionAgent.aplanc                 C  s   dS rJ   r7   r8   r7   r7   r:   rL     s    zBaseMultiActionAgent.input_keysrM   r   rN   c                 K  s.   |dkrt ddidƒS d|› d�}t|ƒ‚dS )rQ   rR   r6   z$Agent stopped due to max iterations.rT   rU   rV   NrW   rY   r7   r7   r:   r[   "  s    z,BaseMultiActionAgent.return_stopped_responsec                 C  s   t ‚dS re   ra   r8   r7   r7   r:   rf   ;  s    z BaseMultiActionAgent._agent_typerg   rh   c                   sF   t ƒ  ¡ }t t¡� t| jƒ|d< W d  ƒ n1 s80    Y  |S )ú*Return dictionary representation of agent.ri   N)rj   rk   Ú
contextlibÚsuppressrb   rM   rf   ©r9   rD   rn   ro   r7   r:   rq   @  s    
,zBaseMultiActionAgent.dictrr   rs   rt   c                 C  sò   t |tƒrt|ƒn|}|  ¡ }d|vr:d| › d�}t|ƒ‚|j}|jddd� |jdkr”| d¡� }t	j
||dd	� W d
  ƒ qî1 sˆ0    Y  nZ|j d¡rÜ| d¡� }tj
||dd� W d
  ƒ qî1 sÐ0    Y  n|› d�}t|ƒ‚d
S )a‰  Save the agent.

        Args:
            file_path: Path to file to save the agent to.

        Raises:
            NotImplementedError: If agent does not support saving.
            ValueError: If file_path is not json or yaml.

        Example:
        .. code-block:: python

            # If working with agent executor
            agent.agent.save(file_path="path/agent.yaml")

        ri   ry   z does not support saving.Trv   rz   r{   r|   r}   Nr   Fr€   r�   )rl   rM   r   rq   rb   r‚   rƒ   r„   r…   r†   r‡   rˆ   r‰   rX   )r9   ru   rŠ   rŒ   rZ   r‹   r�   r7   r7   r:   rŽ   H  s    
00
zBaseMultiActionAgent.savec                 C  s   i S r�   r7   r8   r7   r7   r:   r‘   o  s    z,BaseMultiActionAgent.tool_run_logging_kwargs)N)N)r’   r“   r”   r•   r–   r;   r>   r   rG   rI   rL   r[   rf   r(   rq   rŽ   r‘   r˜   r7   r7   ro   r:   r™   ä   s(    ý ý'r™   c                   @  s$   e Zd ZdZedddœdd„ƒZdS )ÚAgentOutputParserz=Base class for parsing agent output into agent action/finish.rM   r@   ©Útextr3   c                 C  s   dS )z$Parse text into agent action/finish.Nr7   ©r9   r¡   r7   r7   r:   Úparsew  s    zAgentOutputParser.parseN©r’   r“   r”   r•   r   r£   r7   r7   r7   r:   rŸ   t  s   rŸ   c                   @  s$   e Zd ZdZedddœdd„ƒZdS )ÚMultiActionAgentOutputParserz‚Base class for parsing agent output into agent actions/finish.

    This is used for agents that can return multiple actions.
    rM   rš   r    c                 C  s   dS )zÚParse text into agent actions/finish.

        Args:
            text: Text to parse.

        Returns:
            Union[List[AgentAction], AgentFinish]:
                List of agent actions or agent finish.
        Nr7   r¢   r7   r7   r:   r£   „  s    z"MultiActionAgentOutputParser.parseNr¤   r7   r7   r7   r:   r¥   |  s   r¥   c                   @  s˜   e Zd ZU dZded< g Zded< g Zded< dZded	< edd
�Z	e
ddœdd„ƒZe
ddœdd„ƒZddddddœdd„Zddddddœdd„ZdS )ÚRunnableAgentúAgent powered by Runnables.z/Runnable[dict, Union[AgentAction, AgentFinish]]Úrunnabler1   Úinput_keys_argÚreturn_keys_argTÚboolÚstream_runnable©Zarbitrary_types_allowedr2   c                 C  s   | j S ©r5   ©rª   r8   r7   r7   r:   r;   ¥  s    zRunnableAgent.return_valuesc                 C  s   | j S )zReturn the input keys.©r©   r8   r7   r7   r:   rL   ª  s    zRunnableAgent.input_keysNr?   r   r   r@   rA   c                 K  sd   i |¥d|i¥}d}| j rL| jj|d|id�D ]}|du r@|}q.||7 }q.n| jj|d|id�}|S ©aP  Based on past history and current inputs, decide what to do.

        Args:
            intermediate_steps: Steps the LLM has taken to date,
                along with the observations.
            callbacks: Callbacks to run.
            **kwargs: User inputs.

        Returns:
            Action specifying what tool to use.
        rB   NrC   ©Úconfig©r¬   r¨   ÚstreamZinvoke©r9   rB   rC   rD   ÚinputsÚfinal_outputÚchunkr7   r7   r:   rG   ¯  s    zRunnableAgent.planc                 Ë  st   i |¥d|i¥}d}| j rV| jj|d|id�2 z"3 dH W }|du rH|}q.||7 }q.6 n| jj|d|id�I dH }|S ©aR  Async based on past history and current inputs, decide what to do.

        Args:
            intermediate_steps: Steps the LLM has taken to date,
                along with observations.
            callbacks: Callbacks to run.
            **kwargs: User inputs.

        Returns:
            Action specifying what tool to use.
        rB   NrC   r²   ©r¬   r¨   ÚastreamZainvoker¶   r7   r7   r:   rI   Ó  s    þþzRunnableAgent.aplan)N)N©r’   r“   r”   r•   Ú__annotations__r©   rª   r¬   r%   Zmodel_configr–   r;   rL   rG   rI   r7   r7   r7   r:   r¦   ‘  s    
	ÿ ý' ýr¦   c                   @  s˜   e Zd ZU dZded< g Zded< g Zded< dZded	< edd
�Z	e
ddœdd„ƒZe
ddœdd„ƒZddddddœdd„Zddddddœdd„ZdS )ÚRunnableMultiActionAgentr§   z5Runnable[dict, Union[list[AgentAction], AgentFinish]]r¨   r1   r©   rª   Tr«   r¬   r­   r2   c                 C  s   | j S r®   r¯   r8   r7   r7   r:   r;     s    z&RunnableMultiActionAgent.return_valuesc                 C  s   | j S )úQReturn the input keys.

        Returns:
            List of input keys.
        r°   r8   r7   r7   r:   rL     s    z#RunnableMultiActionAgent.input_keysNr?   r   r   rš   rA   c                 K  sd   i |¥d|i¥}d}| j rL| jj|d|id�D ]}|du r@|}q.||7 }q.n| jj|d|id�}|S r±   r´   r¶   r7   r7   r:   rG   "  s    zRunnableMultiActionAgent.planc                 Ë  st   i |¥d|i¥}d}| j rV| jj|d|id�2 z"3 dH W }|du rH|}q.||7 }q.6 n| jj|d|id�I dH }|S rº   r»   r¶   r7   r7   r:   rI   I  s    þþzRunnableMultiActionAgent.aplan)N)Nr½   r7   r7   r7   r:   r¿      s    
	ÿ ý* ýr¿   z0.1.0z1.0)ÚmessageZremovalc                      s’   e Zd ZU dZded< ded< ded< eddœd	d
„ƒZedddœ‡ fdd„ƒZddddddœdd„Z	ddddddœdd„Z
ddœdd„Z‡  ZS )ÚLLMSingleActionAgentz$Base class for single action agents.r.   Ú	llm_chainrŸ   Úoutput_parserr1   Ústopr2   c                 C  s   t t| jjƒdh ƒS )rÀ   rB   ©ÚlistÚsetrÃ   rL   r8   r7   r7   r:   rL   †  s    zLLMSingleActionAgent.input_keysr   rg   rh   c                   s   t ƒ  ¡ }|d= |S ©r›   rÄ   ©rj   rq   rž   ro   r7   r:   rq   �  s    
zLLMSingleActionAgent.dictNr?   r   r@   rA   c                 K  s(   | j jf || j|dœ|¤Ž}| j |¡S )a4  Given input, decided what to do.

        Args:
            intermediate_steps: Steps the LLM has taken to date,
                along with the observations.
            callbacks: Callbacks to run.
            **kwargs: User inputs.

        Returns:
            Action specifying what tool to use.
        ©rB   rÅ   rC   )rÃ   ÚrunrÅ   rÄ   r£   ©r9   rB   rC   rD   r6   r7   r7   r:   rG   –  s    ýüzLLMSingleActionAgent.planc                 Ë  s.   | j jf || j|dœ|¤ŽI dH }| j |¡S )rH   rË   N)rÃ   ÚarunrÅ   rÄ   r£   rÍ   r7   r7   r:   rI   ¯  s    ýüzLLMSingleActionAgent.aplanc                 C  s"   dt | jƒdkrdn| jd dœS )r�   rT   r   ©Ú
llm_prefixÚobservation_prefix)ÚlenrÅ   r8   r7   r7   r:   r‘   È  s    þz,LLMSingleActionAgent.tool_run_logging_kwargs)N)N)r’   r“   r”   r•   r¾   r–   rL   r(   rq   rG   rI   r‘   r˜   r7   r7   ro   r:   rÂ   w  s   
	 ý ýrÂ   c                	      s¤  e Zd ZU dZded< ded< dZded< ed	d
dœ‡ fdd„ƒZddœdd„Ze	ddœdd„ƒZ
e	ddœdd„ƒZdddœdd„ZdHddd	ddœdd„ZdIddd	ddœd d!„Zdd	d"d#œd$d%„Ze	ddœd&d'„ƒZed(d)�d*dœd+d,„ƒZe	ed-dœd.d/„ƒƒZe	ed-dœd0d1„ƒƒZeed2d3d4œd5d6„ƒƒZed2d7d4œd8d9„ƒZeed	ddœd:d;„ƒƒZedJd<d2d=d>d	d d?œd@dA„ƒZd-dd	dBdCœdDdE„Zd
dœdFdG„Z‡  ZS )KÚAgentzèAgent that calls the language model and deciding the action.

    This is driven by a LLMChain. The prompt in the LLMChain MUST include
    a variable called "agent_scratchpad" where the agent can put its
    intermediary work.
    r.   rÃ   rŸ   rÄ   Nr<   Úallowed_toolsr   rg   rh   c                   s   t ƒ  ¡ }|d= |S rÉ   rÊ   rž   ro   r7   r:   rq   ä  s    
z
Agent.dictr2   c                 C  s   | j S )r=   )rÔ   r8   r7   r7   r:   r>   ë  s    zAgent.get_allowed_toolsr1   c                 C  s   dgS r4   r7   r8   r7   r7   r:   r;   ï  s    zAgent.return_valuesc                 C  s    d| j  ¡ › �d| j  ¡ › �gS )NÚ
z
	)rÑ   Úrstripr8   r7   r7   r:   Ú_stopô  s    þzAgent._stopr?   zUnion[str, list[BaseMessage]]©rB   r3   c                 C  s<   d}|D ].\}}||j 7 }|d| j› |› d| j› �7 }q|S )zJConstruct the scratchpad that lets the agent continue its thought process.rT   rÕ   )ÚlogrÑ   rÐ   )r9   rB   ÚthoughtsÚactionÚobservationr7   r7   r:   Ú_construct_scratchpadû  s
    
zAgent._construct_scratchpadr   r@   rA   c                 K  s4   | j |fi |¤Ž}| jjf d|i|¤Ž}| j |¡S )rE   rC   )Úget_full_inputsrÃ   ÚpredictrÄ   r£   ©r9   rB   rC   rD   Úfull_inputsÚfull_outputr7   r7   r:   rG     s    z
Agent.planc                 Ë  s@   | j |fi |¤Ž}| jjf d|i|¤ŽI dH }| j |¡I dH S )rH   rC   N)rÞ   rÃ   ZapredictrÄ   Zaparserà   r7   r7   r:   rI     s    zAgent.aplanzbuiltins.dict[str, Any])rB   rD   r3   c                 K  s"   |   |¡}|| jdœ}i |¥|¥S )a1  Create the full inputs for the LLMChain from intermediate steps.

        Args:
            intermediate_steps: Steps the LLM has taken to date,
                along with observations.
            **kwargs: User inputs.

        Returns:
            Dict[str, Any]: Full inputs for the LLMChain.
        ©Úagent_scratchpadrÅ   )rÝ   r×   )r9   rB   rD   rÚ   Ú
new_inputsr7   r7   r:   rÞ   0  s    
zAgent.get_full_inputsc                 C  s   t t| jjƒdh ƒS )rK   rä   rÆ   r8   r7   r7   r:   rL   C  s    zAgent.input_keysÚafter©Úmoder'   c                 C  sv   | j j}d|jvrrt d¡ |j d¡ t|tƒrB| jd7  _n0t|t	ƒr\| j
d7  _
ndt|ƒ› �}t|ƒ‚| S )aF  Validate that prompt matches format.

        Args:
            values: Values to validate.

        Returns:
            Dict: Validated values.

        Raises:
            ValueError: If `agent_scratchpad` is not in prompt.input_variables
             and prompt is not a FewShotPromptTemplate or a PromptTemplate.
        rä   zl`agent_scratchpad` should be a variable in prompt.input_variables. Did not find it, so adding it at the end.z
{agent_scratchpad}zGot unexpected prompt type )rÃ   ÚpromptZinput_variablesÚloggerÚwarningÚappendrl   r   Útemplater   r„   ÚtyperX   )r9   ré   rZ   r7   r7   r:   Úvalidate_promptK  s    
ÿ

zAgent.validate_promptrM   c                 C  s   dS )z&Prefix to append the observation with.Nr7   r8   r7   r7   r:   rÑ   i  s    zAgent.observation_prefixc                 C  s   dS )z#Prefix to append the LLM call with.Nr7   r8   r7   r7   r:   rÐ   n  s    zAgent.llm_prefixr\   r   )r_   r3   c                 C  s   dS )z›Create a prompt for this class.

        Args:
            tools: Tools to use.

        Returns:
            BasePromptTemplate: Prompt template.
        Nr7   ©rc   r_   r7   r7   r:   Úcreate_prompts  s    zAgent.create_promptrs   c                 C  s   dS )zgValidate that appropriate tools are passed in.

        Args:
            tools: Tools to use.
        Nr7   rð   r7   r7   r:   Ú_validate_tools  s    zAgent._validate_toolsc                 K  s   dS )z)Get default output parser for this class.Nr7   )rc   rD   r7   r7   r:   Ú_get_default_output_parser‡  s    z Agent._get_default_output_parserr   r]   zOptional[AgentOutputParser])r^   r_   r`   rÄ   rD   r3   c           	      K  sN   |   |¡ t||  |¡|d�}dd„ |D ƒ}|p6|  ¡ }| f |||dœ|¤ŽS )aO  Construct an agent from an LLM and tools.

        Args:
            llm: Language model to use.
            tools: Tools to use.
            callback_manager: Callback manager to use.
            output_parser: Output parser to use.
            kwargs: Additional arguments.

        Returns:
            Agent: Agent object.
        )r^   ré   r`   c                 S  s   g | ]
}|j ‘qS r7   ©Úname©Ú.0Útoolr7   r7   r:   Ú
<listcomp>§  ó    z,Agent.from_llm_and_tools.<locals>.<listcomp>)rÃ   rÔ   rÄ   )rò   r.   rñ   ró   )	rc   r^   r_   r`   rÄ   rD   rÃ   Z
tool_namesZ_output_parserr7   r7   r:   rd   Œ  s    
ýýüzAgent.from_llm_and_toolsr   )rO   rB   rD   r3   c                 K  sÆ   |dkrt ddidƒS |dkr°d}|D ].\}}||j7 }|d| j› |› d| j› �7 }q&|d7 }|| jdœ}i |¥|¥}| jjf i |¤Ž}	| j |	¡}
t	|
t ƒr¢|
S t d|	i|	ƒS d	|› �}t
|ƒ‚d
S )aÑ  Return response when agent has been stopped due to max iterations.

        Args:
            early_stopping_method: Method to use for early stopping.
            intermediate_steps: Steps the LLM has taken to date,
                along with observations.
            **kwargs: User inputs.

        Returns:
            AgentFinish: Agent finish object.

        Raises:
            ValueError: If `early_stopping_method` is not in ['force', 'generate'].
        rR   r6   rS   rT   ÚgeneraterÕ   zB

I now need to return a final answer based on the previous steps:rã   zBearly_stopping_method should be one of `force` or `generate`, got N)r   rÙ   rÑ   rÐ   r×   rÃ   rß   rÄ   r£   rl   rX   )r9   rO   rB   rD   rÚ   rÛ   rÜ   rå   rá   râ   Zparsed_outputrZ   r7   r7   r:   r[   °  s6    þ
ÿÿ
ÿÿzAgent.return_stopped_responsec                 C  s   | j | jdœS )r�   rÏ   rÏ   r8   r7   r7   r:   r‘   ç  s    þzAgent.tool_run_logging_kwargs)N)N)NN)r’   r“   r”   r•   r¾   rÔ   r(   rq   r>   r–   r;   r×   rÝ   rG   rI   rÞ   rL   r&   rï   r   rÑ   rÐ   r—   rñ   rò   ró   rd   r[   r‘   r˜   r7   r7   ro   r:   rÓ   Ð  sR   
 ý ý
  û#7rÓ   c                   @  sZ   e Zd ZU dZdZded< dZded< eddddd	œd
d„ƒZeddddd	œdd„ƒZ	dS )ÚExceptionToolz!Tool that just returns the query.Ú
_ExceptionrM   rõ   zException toolÚdescriptionNz#Optional[CallbackManagerForToolRun])ÚqueryÚrun_managerr3   c                 C  s   |S ©Nr7   ©r9   rÿ   r   r7   r7   r:   Ú_run÷  s    zExceptionTool._runz(Optional[AsyncCallbackManagerForToolRun]c                 Ã  s   |S r  r7   r  r7   r7   r:   Ú_arunÿ  s    zExceptionTool._arun)N)N)
r’   r“   r”   r•   rõ   r¾   rþ   r(   r  r  r7   r7   r7   r:   rü   ï  s   
 ý ýrü   c                   @  s¨  e Zd ZU dZded< ded< dZded< d	Zd
ed< dZded< dZded< dZ	ded< dZ
ded< ed}ddddd dœdd„ƒZedd�ddœd d!„ƒZed"d�ed#dd$œd%d&„ƒƒZed'dœd(d)„ƒZed*d+d,œd-d.„ƒZd*d+d,œd/d0„Zd~ddd1œddddd2d3œd4d5„Zed6dœd7d8„ƒZed6dœd9d:„ƒZdd;d<œd=d>„Zd?d@ddAœdBdC„ZddDdEdFdGdHœdIdJ„Zd€dDdEdKdGdHœdLdM„ZdNdOd$œdPdQ„Zd�dRdSdSdTdFdOdUœdVdW„Zd‚dRdSdSdTdFdXdUœdYdZ„ZdƒdRdSd[dFd\d]œd^d_„Zd„dRdSdSdTdKdOdUœd`da„Z d…dRdSdSdTdKdbdUœdcdd„Z!d†dRdSd[dKd\d]œdedf„Z"d‡dSdFdGdgœdhdi„Z#dˆdSdKdSdgœdjdk„Z$dldmdnœdodp„Z%dTdTdqœdrds„Z&ed‰dtduddvdwœdxdy„ƒZ'edŠdtduddzdwœd{d|„ƒZ(dS )‹ÚAgentExecutorzAgent that is using tools.z<Union[BaseSingleActionAgent, BaseMultiActionAgent, Runnable]Úagentr\   r_   Fr«   Úreturn_intermediate_stepsé   zOptional[int]Úmax_iterationsNzOptional[float]Úmax_execution_timerR   rM   rO   z8Union[bool, str, Callable[[OutputParserException], str]]Úhandle_parsing_errorséÿÿÿÿzTUnion[int, Callable[[list[tuple[AgentAction, str]]], list[tuple[AgentAction, str]]]]Útrim_intermediate_stepsr   r   )r  r_   rC   rD   r3   c                 K  s   | f |||dœ|¤ŽS )a  Create from agent and tools.

        Args:
            agent: Agent to use.
            tools: Tools to use.
            callbacks: Callbacks to use.
            kwargs: Additional arguments.

        Returns:
            AgentExecutor: Agent executor object.
        )r  r_   rC   r7   )rc   r  r_   rC   rD   r7   r7   r:   Úfrom_agent_and_tools=  s    ýüz"AgentExecutor.from_agent_and_toolsræ   rç   r'   r2   c                 C  sZ   | j }| j}| ¡ }|durVt|ƒdd„ |D ƒkrVd|› ddd„ |D ƒ› d�}t|ƒ‚| S )	a  Validate that tools are compatible with agent.

        Args:
            values: Values to validate.

        Returns:
            Dict: Validated values.

        Raises:
            ValueError: If allowed tools are different than provided tools.
        Nc                 S  s   h | ]
}|j ’qS r7   rô   rö   r7   r7   r:   Ú	<setcomp>g  s   z/AgentExecutor.validate_tools.<locals>.<setcomp>zAllowed tools (z!) different than provided tools (c                 S  s   g | ]
}|j ‘qS r7   rô   rö   r7   r7   r:   rù   l  rú   z0AgentExecutor.validate_tools.<locals>.<listcomp>ú))r  r_   r>   rÈ   rX   )r9   r  r_   rÔ   rZ   r7   r7   r:   Úvalidate_toolsW  s    ÿÿÿzAgentExecutor.validate_toolsÚbeforerq   )Úvaluesr3   c                 C  s¢   |  d¡}|ržt|tƒržz
|j}W n4 ty8   d}Y n4 tyV   t d¡ d}Y n0 |tt	t
 tf k}| dd¡}|rŽt||d�|d< nt||d�|d< |S )z�Convert runnable to agent if passed in.

        Args:
            values: Values to validate.

        Returns:
            Dict: Validated values.
        r  Fz.Unexpected error getting OutputType from agentr¬   T)r¨   r¬   )Úgetrl   r   Z
OutputTypeÚ	TypeErrorÚ	Exceptionrê   Ú	exceptionr   rÇ   r   r   Úpopr¿   r¦   )rc   r  r  Úoutput_typeZmulti_actionr¬   r7   r7   r:   Úvalidate_runnable_agentq  s*    



þþ
z%AgentExecutor.validate_runnable_agentz2Union[BaseSingleActionAgent, BaseMultiActionAgent]c                 C  s   t | jtƒrtd| jƒS | jS )aC  Type cast self.agent.

        If the `agent` attribute is a Runnable, it will be converted one of
        RunnableAgentType in the validate_runnable_agent root_validator.

        To support instantiating with a Runnable, here we explicitly cast the type
        to reflect the changes made in the root_validator.
        ÚRunnableAgentType)rl   r  r   r   r8   r7   r7   r:   Ú_action_agent•  s    
zAgentExecutor._action_agentrr   rs   rt   c                 C  s   d}t |ƒ‚dS )zÊRaise error - saving not supported for Agent Executors.

        Args:
            file_path: Path to save to.

        Raises:
            ValueError: Saving not supported for agent executors.
        zpSaving not supported for agent executors. If you are trying to save the agent, please use the `.save_agent(...)`N)rX   )r9   ru   rZ   r7   r7   r:   rŽ   £  s    ÿzAgentExecutor.savec                 C  s   | j  |¡S )zZSave the underlying agent.

        Args:
            file_path: Path to save to.
        )r  rŽ   )r9   ru   r7   r7   r:   Ú
save_agent´  s    zAgentExecutor.save_agent)Úinclude_run_infoÚasync_r*   )r·   rC   r  r  r3   c                C  s   t | ||| j|d�S )ag  Enables iteration over steps taken to reach final output.

        Args:
            inputs: Inputs to the agent.
            callbacks: Callbacks to run.
            include_run_info: Whether to include run info.
            async_: Whether to run async. (Ignored)

        Returns:
            AgentExecutorIterator: Agent executor iterator object.
        )Útagsr  )r*   r   )r9   r·   rC   r  r  r7   r7   r:   Úiter¼  s    ûzAgentExecutor.iterr1   c                 C  s   | j jS )rK   )r  rL   r8   r7   r7   r:   rL   ×  s    zAgentExecutor.input_keysc                 C  s   | j rg | jj¢d‘S | jjS )z@Return the singular output key.

        :meta private:
        rB   )r  r  r;   r8   r7   r7   r:   Úoutput_keysß  s    zAgentExecutor.output_keysr"   )rõ   r3   c                 C  s   dd„ | j D ƒ| S )z�Lookup tool by name.

        Args:
            name: Name of tool.

        Returns:
            BaseTool: Tool object.
        c                 S  s   i | ]}|j |“qS r7   rô   rö   r7   r7   r:   Ú
<dictcomp>ò  rú   z-AgentExecutor.lookup_tool.<locals>.<dictcomp>)r_   )r9   rõ   r7   r7   r:   Úlookup_toolé  s    	zAgentExecutor.lookup_toolÚintÚfloat)Ú
iterationsÚtime_elapsedr3   c                 C  s,   | j d ur|| j krdS | jd u p*|| jk S )NF)r	  r
  )r9   r'  r(  r7   r7   r:   Ú_should_continueô  s    zAgentExecutor._should_continuer   rÇ   z$Optional[CallbackManagerForChainRun]zdict[str, Any])r6   rB   r   r3   c                 C  s.   |r|j |d| jd� |j}| jr*||d< |S ©NÚgreen)ÚcolorÚverboserB   ©Zon_agent_finishr-  r;   r  ©r9   r6   rB   r   r¸   r7   r7   r:   Ú_returnù  s    zAgentExecutor._returnz)Optional[AsyncCallbackManagerForChainRun]c                 Ã  s4   |r|j |d| jd�I d H  |j}| jr0||d< |S r*  r.  r/  r7   r7   r:   Ú_areturn  s    ýzAgentExecutor._areturnÚNextStepOutputz1Union[AgentFinish, list[tuple[AgentAction, str]]]c                 C  s<   t |d tƒr.t|ƒdkr&d}t|ƒ‚|d S dd„ |D ƒS )Nr  é   z>Expected a single AgentFinish output, but got multiple values.c                 S  s"   g | ]}t |tƒr|j|jf‘qS r7   )rl   r   rÛ   rÜ   ©r÷   Úar7   r7   r:   rù      rú   z4AgentExecutor._consume_next_step.<locals>.<listcomp>)rl   r   rÒ   rX   )r9   r  rZ   r7   r7   r:   Ú_consume_next_step  s    z AgentExecutor._consume_next_stepzdict[str, BaseTool]zdict[str, str]r?   )Úname_to_tool_mapÚcolor_mappingr·   rB   r   r3   c              
   C  s   |   t|  |||||¡ƒ¡S r  )r6  rÇ   Ú_iter_next_step©r9   r7  r8  r·   rB   r   r7   r7   r:   Ú_take_next_step"  s    ûÿÿzAgentExecutor._take_next_stepz4Iterator[Union[AgentFinish, AgentAction, AgentStep]]c              
   c  sÆ  z4|   |¡}| jj|fd|r$| ¡ ndi|¤Ž}W �n0 t�yd } �zt| jtƒr^| j }nd}|rzd|›�}	t|	ƒ|‚t	|ƒ}
t| jtƒr°|j
rªt	|jƒ}t	|jƒ}
qèd}n8t| jt	ƒrÄ| j}n$t| jƒrÚ|  |¡}nd}	t|	ƒ|‚td||
ƒ}|�r|j|dd	� | j ¡ }tƒ j|jf| jd|�r2| ¡ ndd
œ|¤Ž}t||d�V  W Y d}~dS d}~0 0 t|tƒ�r||V  dS t|tƒ�rŽ|gn|}|D ]}|V  �q–|D ]}|  ||||¡V  �q¨dS )ú–Take a single step in the thought-action-observation loop.

        Override this to take control of how the agent makes and acts on choices.
        rC   NFú²An output parsing error occurred. In order to pass this error back to the agent and have it try again, pass `handle_parsing_errors=True` to the AgentExecutor. This is the error: úInvalid or incomplete responseú.Got unexpected type of `handle_parsing_errors`rý   r+  ©r,  ©r-  r,  rC   ©rÛ   rÜ   )Ú_prepare_intermediate_stepsr  rG   Ú	get_childr   rl   r  r«   rX   rM   Úsend_to_llmrÜ   Ú
llm_outputÚcallabler   Úon_agent_actionr‘   rü   rÌ   Ú
tool_inputr-  r   r   Ú_perform_agent_action)r9   r7  r8  r·   rB   r   r6   ÚeÚraise_errorrZ   r¡   rÜ   Útool_run_kwargsÚactionsÚagent_actionr7   r7   r:   r9  6  sv    
ÿþý
ýÿ




ÿüû
üzAgentExecutor._iter_next_stepr   r   )r7  r8  rO  r   r3   c           
      C  sÈ   |r|j |dd� |j|v rx||j }|j}||j }| j ¡ }|rLd|d< |j|jf| j||rh| ¡ nd dœ|¤Ž}	nD| j ¡ }t	ƒ j|jt
| ¡ ƒdœf| jd |r®| ¡ nd dœ|¤Ž}	t||	d�S )Nr+  r@  rT   rÐ   rA  ©Zrequested_tool_nameZavailable_tool_namesrB  )rH  rø   Úreturn_directr  r‘   rÌ   rI  r-  rD  r,   rÇ   Úkeysr   ©
r9   r7  r8  rO  r   rø   rQ  r,  rM  rÜ   r7   r7   r:   rJ  …  s>    



ÿüû

þÿùø
z#AgentExecutor._perform_agent_actionc              
   Ã  s(   |   dd„ |  |||||¡2 ƒI d H ¡S )Nc                 Ó  s   g | z3 d H W }|‘q6 S r  r7   r4  r7   r7   r:   rù   µ  s   ÿz2AgentExecutor._atake_next_step.<locals>.<listcomp>)r6  Ú_aiter_next_stepr:  r7   r7   r:   Ú_atake_next_step¬  s    ûþ
ÿzAgentExecutor._atake_next_stepz9AsyncIterator[Union[AgentFinish, AgentAction, AgentStep]]c              
    sÖ  z:ˆ  |¡}ˆjj|fdˆr$ˆ ¡ ndi|¤ŽI dH }W �n" t�y\ } �ztˆjtƒrdˆj }nd}|r€d|›�}	t|	ƒ|‚t	|ƒ}
tˆjtƒr¶|j
r°t	|jƒ}t	|jƒ}
qîd}n8tˆjt	ƒrÊˆj}n$tˆjƒràˆ |¡}nd}	t|	ƒ|‚td||
ƒ}ˆj ¡ }tƒ j|jfˆjdˆ�r$ˆ ¡ nddœ|¤ŽI dH }t||d	�V  W Y d}~dS d}~0 0 t|tƒ�rt|V  dS t|tƒ�r†|gn|}|D ]}|V  �qŽtj‡ ‡‡‡fd
d„|D ƒŽ I dH }|D ]}|V  �qÄdS )r<  rC   NFr=  r>  r?  rý   rA  rB  c                   s   g | ]}ˆ  ˆˆ |ˆ¡‘qS r7   )Ú_aperform_agent_action)r÷   rO  ©r8  r7  r   r9   r7   r:   rù   	  s   úüz2AgentExecutor._aiter_next_step.<locals>.<listcomp>)rC  r  rI   rD  r   rl   r  r«   rX   rM   rE  rÜ   rF  rG  r   r‘   rü   rÎ   rI  r-  r   r   ÚasyncioZgather)r9   r7  r8  r·   rB   r   r6   rK  rL  rZ   r¡   rÜ   rM  rN  rO  Úresultr¹   r7   rW  r:   rT  Á  sr    
ÿþý
ýÿ




ÿüû
ùÿ
zAgentExecutor._aiter_next_stepc           
      Ã  sÞ   |r|j || jdd�I d H  |j|v rˆ||j }|j}||j }| j ¡ }|rVd|d< |j|jf| j||rr| ¡ nd dœ|¤ŽI d H }	nJ| j ¡ }t	ƒ j|jt
| ¡ ƒdœf| jd |r¾| ¡ nd dœ|¤ŽI d H }	t||	d�S )Nr+  )r-  r,  rT   rÐ   rA  rP  rB  )rH  r-  rø   rQ  r  r‘   rÎ   rI  rD  r,   rÇ   rR  r   rS  r7   r7   r:   rV    sF    ý



ÿüû

þÿùø
z$AgentExecutor._aperform_agent_action)r·   r   r3   c                 C  sø   dd„ | j D ƒ}tdd„ | j D ƒddgd�}g }d}d	}t ¡ }|  ||¡rÐ| j|||||d
�}	t|	tƒrz| j|	||d
�S | |	¡ t	|	ƒdkrº|	d }
|  
|
¡}|durº| j|||d
�S |d7 }t ¡ | }q@| jj| j|fi |¤Ž}| j|||d
�S )z(Run text through and get agent response.c                 S  s   i | ]}|j |“qS r7   rô   rö   r7   r7   r:   r#  J  rú   z'AgentExecutor._call.<locals>.<dictcomp>c                 S  s   g | ]
}|j ‘qS r7   rô   rö   r7   r7   r:   rù   M  rú   z'AgentExecutor._call.<locals>.<listcomp>r+  Zred©Zexcluded_colorsr   ç        ©r   r3  N)r_   r#   Útimer)  r;  rl   r   r0  ÚextendrÒ   Ú_get_tool_returnr  r[   rO   ©r9   r·   r   r7  r8  rB   r'  r(  Ú
start_timeÚnext_step_outputZnext_step_actionZtool_returnr6   r7   r7   r:   Ú_callC  sT    þû
ý

ýþýzAgentExecutor._callc              	   Ã  sØ  dd„ | j D ƒ}tdd„ | j D ƒdgd�}g }d}d}t ¡ }�zJt| jƒ4 I d	H �š |  ||¡�r,| j|||||d
�I d	H }	t|	tƒr¶| j	|	||d
�I d	H W  d	  ƒI d	H  W S | 
|	¡ t|	ƒdk�r|	d }
|  |
¡}|d	u�r| j	|||d
�I d	H W  d	  ƒI d	H  W S |d7 }t ¡ | }qX| jj| j|fi |¤Ž}| j	|||d
�I d	H W  d	  ƒI d	H  W S 1 I d	H �s~0    Y  W nH ttjf�yÒ   | jj| j|fi |¤Ž}| j	|||d
�I d	H  Y S 0 d	S )z.Async run text through and get agent response.c                 S  s   i | ]}|j |“qS r7   rô   rö   r7   r7   r:   r#  €  rú   z(AgentExecutor._acall.<locals>.<dictcomp>c                 S  s   g | ]
}|j ‘qS r7   rô   rö   r7   r7   r:   rù   ƒ  rú   z(AgentExecutor._acall.<locals>.<listcomp>r+  rZ  r   r[  Nr\  r3  )r_   r#   r]  r/   r
  r)  rU  rl   r   r1  r^  rÒ   r_  r  r[   rO   ÚTimeoutErrorrX  r`  r7   r7   r:   Ú_acally  sx    þû
ý"


ý"þýý>þýýzAgentExecutor._acallztuple[AgentAction, str]zOptional[AgentFinish])rb  r3   c                 C  s`   |\}}dd„ | j D ƒ}d}t| jjƒdkr8| jjd }|j|v r\||j jr\t||idƒS dS )z&Check if the tool is a returning tool.c                 S  s   i | ]}|j |“qS r7   rô   rö   r7   r7   r:   r#  È  rú   z2AgentExecutor._get_tool_return.<locals>.<dictcomp>r6   r   rT   N)r_   rÒ   r  r;   rø   rQ  r   )r9   rb  rO  rÜ   r7  Zreturn_value_keyr7   r7   r:   r_  Â  s    ÿ
þþzAgentExecutor._get_tool_returnrØ   c                 C  s>   t | jtƒr&| jdkr&|| j d … S t| jƒr:|  |¡S |S )Nr   )rl   r  r%  rG  )r9   rB   r7   r7   r:   rC  ×  s    
ÿþ

z)AgentExecutor._prepare_intermediate_stepszUnion[dict[str, Any], Any]zOptional[RunnableConfig]zIterator[AddableDict])Úinputr³   rD   r3   c                 k  sT   t |ƒ}t| || d¡f| d¡| d¡| d¡| d¡ddœ|¤Ž}|E dH  dS )	a  Enables streaming over steps taken to reach final output.

        Args:
            input: Input to the agent.
            config: Config to use.
            kwargs: Additional arguments.

        Yields:
            AddableDict: Addable dictionary.
        rC   r   ÚmetadataÚrun_nameÚrun_idT©r   rg  rh  ri  Zyield_actionsN©r    r*   r  )r9   rf  r³   rD   Úiteratorr7   r7   r:   rµ   ä  s    ýø	÷zAgentExecutor.streamzAsyncIterator[AddableDict]c                 K sd   t |ƒ}t| || d¡f| d¡| d¡| d¡| d¡ddœ|¤Ž}|2 z3 dH W }|V  qJ6 dS )	a	  Async enables streaming over steps taken to reach final output.

        Args:
            input: Input to the agent.
            config: Config to use.
            kwargs: Additional arguments.

        Yields:
            AddableDict: Addable dictionary.
        rC   r   rg  rh  ri  Trj  Nrk  )r9   rf  r³   rD   rl  Ústepr7   r7   r:   r¼     s     ýø	÷zAgentExecutor.astream)N)N)N)N)N)N)N)N)N)N)N)N)N)N))r’   r“   r”   r•   r¾   r  r	  r
  rO   r  r  r—   r  r&   r  r  r–   r  r(   rŽ   r  r!  rL   r"  r$  r)  r0  r1  r6  r;  r9  rJ  rU  rT  rV  rc  re  r_  rC  rµ   r¼   r7   r7   r7   r:   r    s€   
ÿ
ý
 ü" ýú		 ü ü ú úT û- ú ú\ û. ý9 ýI ý ýr  )br•   Ú
__future__r   rX  Úbuiltinsrœ   r†   Úloggingr]  Úabcr   Úcollections.abcr   r   r   Úpathlibr   Útypingr   r	   r
   r   r   r‰   Zlangchain_core._apir   Zlangchain_core.agentsr   r   r   Zlangchain_core.callbacksr   r   r   r   r   r   Zlangchain_core.exceptionsr   Zlangchain_core.language_modelsr   Zlangchain_core.messagesr   Zlangchain_core.output_parsersr   Zlangchain_core.promptsr   Zlangchain_core.prompts.few_shotr   Zlangchain_core.prompts.promptr   Zlangchain_core.runnablesr   r   r    Zlangchain_core.runnables.utilsr!   Zlangchain_core.toolsr"   Zlangchain_core.utils.inputr#   Zpydanticr$   r%   r&   Ztyping_extensionsr'   r(   Zlangchain._api.deprecationr)   Zlangchain.agents.agent_iteratorr*   Zlangchain.agents.agent_typesr+   Zlangchain.agents.toolsr,   Zlangchain.chains.baser-   Zlangchain.chains.llmr.   Zlangchain.utilities.asyncior/   Ú	getLoggerr’   rê   r0   r™   rŸ   rÇ   r¥   r¦   r¿   rÂ   rÓ   rü   r2  r  r  r7   r7   r7   r:   Ú<module>   s€    
 + 
ÿowýTý  