U
    ho                     @  s   d Z ddlmZ ddl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mZ dd
lmZmZ ddlm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" e	ddddG dd deZ#dS )zDAn agent designed to hold a conversation in addition to using tools.    )annotations)AnyListOptionalSequence)
deprecated)BaseCallbackManager)BaseLanguageModel)PromptTemplate)Field)BaseTool)AgentAgentOutputParser)	AgentTypeConvoOutputParser)FORMAT_INSTRUCTIONSPREFIXSUFFIX)validate_tools_single_input)LLMChainz0.1.0Zcreate_react_agentz1.0)alternativeZremovalc                      s  e Zd ZU dZdZded< eedZded< e	d&dddd	d
dZ
eddddZeddddZeddddZe	eeedddfdddddddddddZe	ddd fddZe	ddeeedddfddd d!dddddddd"d#d$d%Z  ZS )'ConversationalAgentz>An agent that holds a conversation in addition to using tools.AIstr	ai_prefix)default_factoryr   output_parserr   )r   kwargsreturnc                 K  s
   t |dS )Nr   r   )clsr   r    r"   H/tmp/pip-unpacked-wheel-bo69hh5q/langchain/agents/conversational/base.py_get_default_output_parser   s    z.ConversationalAgent._get_default_output_parser)r   c                 C  s   t jS )z Return Identifier of agent type.)r   Z CONVERSATIONAL_REACT_DESCRIPTIONselfr"   r"   r#   _agent_type%   s    zConversationalAgent._agent_typec                 C  s   dS )z]Prefix to append the observation with.

        Returns:
            "Observation: "
        zObservation: r"   r%   r"   r"   r#   observation_prefix*   s    z&ConversationalAgent.observation_prefixc                 C  s   dS )zVPrefix to append the llm call with.

        Returns:
            "Thought: "
        zThought:r"   r%   r"   r"   r#   
llm_prefix3   s    zConversationalAgent.llm_prefixZHumanNzSequence[BaseTool]zOptional[List[str]]r
   )toolsprefixsuffixformat_instructionsr   human_prefixinput_variablesr   c                 C  sh   d dd |D }d dd |D }	|j|	||d}d ||||g}
|dkr\d	d
dg}t|
|dS )au  Create prompt in the style of the zero-shot agent.

        Args:
            tools: List of tools the agent will have access to, used to format the
                prompt.
            prefix: String to put before the list of tools. Defaults to PREFIX.
            suffix: String to put after the list of tools. Defaults to SUFFIX.
            format_instructions: Instructions on how to use the tools. Defaults to
                FORMAT_INSTRUCTIONS
            ai_prefix: String to use before AI output. Defaults to "AI".
            human_prefix: String to use before human output.
                Defaults to "Human".
            input_variables: List of input variables the final prompt will expect.
                Defaults to ["input", "chat_history", "agent_scratchpad"].

        Returns:
            A PromptTemplate with the template assembled from the pieces here.
        
c                 S  s    g | ]}d |j  d|j qS )z> z: )namedescription.0Ztoolr"   r"   r#   
<listcomp>Z   s     z5ConversationalAgent.create_prompt.<locals>.<listcomp>z, c                 S  s   g | ]
}|j qS r"   r1   r3   r"   r"   r#   r5   \   s     )
tool_namesr   r.   z

NinputZchat_historyZagent_scratchpad)templater/   )joinformatr
   )r!   r*   r+   r,   r-   r   r.   r/   Ztool_stringsr7   r9   r"   r"   r#   create_prompt<   s      
z!ConversationalAgent.create_promptNone)r*   r   c                   s   t  | t| j| d S )N)super_validate_toolsr   __name__)r!   r*   	__class__r"   r#   r?   e   s    z#ConversationalAgent._validate_toolsr	   zOptional[BaseCallbackManager]zOptional[AgentOutputParser]r   )llmr*   callback_managerr   r+   r,   r-   r   r.   r/   r   r   c              	   K  sf   |  | | j|||	||||
d}t|||d}dd |D }|pL| j|d}| f ||||d|S )a  Construct an agent from an LLM and tools.

        Args:
            llm: The language model to use.
            tools: A list of tools to use.
            callback_manager: The callback manager to use. Default is None.
            output_parser: The output parser to use. Default is None.
            prefix: The prefix to use in the prompt. Default is PREFIX.
            suffix: The suffix to use in the prompt. Default is SUFFIX.
            format_instructions: The format instructions to use.
                Default is FORMAT_INSTRUCTIONS.
            ai_prefix: The prefix to use before AI output. Default is "AI".
            human_prefix: The prefix to use before human output.
                Default is "Human".
            input_variables: The input variables to use. Default is None.
            **kwargs: Any additional keyword arguments to pass to the agent.

        Returns:
            An agent.
        )r   r.   r+   r,   r-   r/   )rC   promptrD   c                 S  s   g | ]
}|j qS r"   r6   r3   r"   r"   r#   r5      s     z:ConversationalAgent.from_llm_and_tools.<locals>.<listcomp>r    )	llm_chainZallowed_toolsr   r   )r?   r<   r   r$   )r!   rC   r*   rD   r   r+   r,   r-   r   r.   r/   r   rE   rF   r7   Z_output_parserr"   r"   r#   from_llm_and_toolsj   s6    #
	z&ConversationalAgent.from_llm_and_tools)r   )r@   
__module____qualname____doc__r   __annotations__r   r   r   classmethodr$   propertyr'   r(   r)   r   r   r   r<   r?   rG   __classcell__r"   r"   rA   r#   r      s@   
  (r   N)$rJ   
__future__r   typingr   r   r   r   Zlangchain_core._apir   Zlangchain_core.callbacksr   Zlangchain_core.language_modelsr	   Zlangchain_core.promptsr
   Zlangchain_core.pydantic_v1r   Zlangchain_core.toolsr   Zlangchain.agents.agentr   r   Zlangchain.agents.agent_typesr   Z-langchain.agents.conversational.output_parserr   Z&langchain.agents.conversational.promptr   r   r   Zlangchain.agents.utilsr   Zlangchain.chainsr   r   r"   r"   r"   r#   <module>   s    