motleycrew.agents.langchain.langchain

Classes

LangchainMotleyAgent([description, name, ...])

MotleyCrew wrapper for Langchain agents.
class motleycrew.agents.langchain.langchain.LangchainMotleyAgent(description: str | None = None, name: str | None = None, prompt: str | ChatPromptTemplate | None = None, agent_factory: MotleyAgentFactory[AgentExecutor] | None = None, tools: Sequence[MotleySupportedTool] | None = None, force_output_handler: bool = False, chat_history: bool | GetSessionHistoryCallable = True, input_as_messages: bool = False, runnable_config: RunnableConfig | None = None, verbose: bool = False)

Bases: MotleyAgentParent, LangchainOutputHandlingAgentMixin

MotleyCrew wrapper for Langchain agents.

__init__(description: str | None = None, name: str | None = None, prompt: str | ChatPromptTemplate | None = None, agent_factory: MotleyAgentFactory[AgentExecutor] | None = None, tools: Sequence[MotleySupportedTool] | None = None, force_output_handler: bool = False, chat_history: bool | GetSessionHistoryCallable = True, input_as_messages: bool = False, runnable_config: RunnableConfig | None = None, verbose: bool = False)
Parameters:

  • description –

    Description of the agent.

    Unlike the prompt prefix, it is not included in the prompt. The description is only used for describing the agent’s purpose when giving it as a tool to other agents.

  • name –

    Name of the agent. The name is used for identifying the agent when it is given as a tool to other agents, as well as for logging purposes.

    It is not included in the agent’s prompt.

  • prompt –

    Prompt to the agent.

    If a string, it will be used as a prompt. If a string containing f-string-style placeholders, it will be used as a prompt template. If a ChatPromptTemplate, it will be used as a prompt template.

  • agent_factory –

    Factory function to create the agent. The factory function should accept a dictionary of tools and return an AgentExecutor instance.

    See motleycrew.common.types.MotleyAgentFactory for more details.

    Alternatively, you can use the from_agent() method to wrap an existing AgentExecutor.

  • tools – Tools to add to the agent.

  • force_output_handler – Whether to force the agent to return through an output handler. If True, at least one tool must have return_direct set to True.

  • chat_history –

    Whether to use chat history or not. If True, uses InMemoryChatMessageHistory. If a callable is passed, it is used to get the chat history by session_id.

    See langchain_core.runnables.history.RunnableWithMessageHistory for more details.

  • input_as_messages – Whether the agent expects a list of messages as input instead of a single string.

  • runnable_config – Default Langchain config to use when invoking the agent. It can be used to add callbacks, metadata, etc.

  • verbose – Whether to log verbose output.

materialize()

Materialize the agent and wrap it in RunnableWithMessageHistory if needed.

invoke(input: str | dict, config: RunnableConfig | None = None, **kwargs: Any) → Any

Transform a single input into an output.

Parameters:

  • input – The input to the Runnable.

  • config – A config to use when invoking the Runnable. The config supports standard keys like ‘tags’, ‘metadata’ for tracing purposes, ‘max_concurrency’ for controlling how much work to do in parallel, and other keys. Please refer to the RunnableConfig for more details.

Returns:

The output of the Runnable.

async ainvoke(input: dict, config: RunnableConfig | None = None, **kwargs: Any) → Any

Default implementation of ainvoke, calls invoke from a thread.

The default implementation allows usage of async code even if the Runnable did not implement a native async version of invoke.

Subclasses should override this method if they can run asynchronously.

static from_agent(agent: AgentExecutor, description: str | None = None, prompt: str | ChatPromptTemplate | None = None, tools: Sequence[MotleySupportedTool] | None = None, runnable_config: RunnableConfig | None = None, verbose: bool = False) → LangchainMotleyAgent

Create a LangchainMotleyAgent from a langchain.agents.AgentExecutor instance.

Using this method, you can wrap an existing AgentExecutor without providing a factory function.

Parameters:

  • agent – AgentExecutor instance to wrap.

  • prompt –

    Prompt for the agent.

    If a string, it will be used as a prompt. If a string containing f-string-style placeholders, it will be used as a prompt template. If a ChatPromptTemplate, it will be used as a prompt template.

  • description –

    Description of the agent.

    Unlike the prompt prefix, it is not included in the prompt. The description is only used for describing the agent’s purpose when giving it as a tool to other agents.

  • tools – Tools to add to the agent.

  • runnable_config – Default Langchain config to use when invoking the agent. It can be used to add callbacks, metadata, etc.

  • verbose – Whether to log verbose output.