LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
  • Overview
  • MCP Adapters
    • Overview
    • Agents
    • Callbacks
    • Chains
    • Chat models
    • Embeddings
    • Evaluation
    • Globals
    • Hub
    • Memory
    • Output parsers
    • Retrievers
    • Runnables
    • LangSmith
    • Storage
    Standard Tests
    Text Splitters
    ⌘I

    LangChain Assistant

    Ask a question to get started

    Enter to send•Shift+Enter new line

    Menu

    MCP Adapters
    OverviewAgentsCallbacksChainsChat modelsEmbeddingsEvaluationGlobalsHubMemoryOutput parsersRetrieversRunnablesLangSmithStorage
    Standard Tests
    Text Splitters
    Language
    Theme
    Pythonlangchain-classicchainsroutermulti_promptMultiPromptChain
    Class●Since v1.0Deprecated

    MultiPromptChain

    Copy
    MultiPromptChain
    (
    )

    Bases

    MultiRouteChain

    Attributes

    attribute
    output_keys: list[str]

    Methods

    method
    from_prompts

    Inherited fromMultiRouteChain

    Attributes

    Arouter_chain: LLMRouterChain
    —

    Chain for deciding a destination chain and the input to it.

    Adestination_chains: Mapping[str, BaseRetrievalQA]
    —

    Map of name to candidate chains that inputs can be routed to.

    Adefault_chain: Chain
    —

    Default chain to use when router doesn't map input to one of the destinations.

    Asilent_errors: bool
    —

    If True, use default_chain when an invalid destination name is provided.

    Amodel_configAinput_keys: list[str]

    Inherited fromChain

    Attributes

    Amemory: BaseMemory | None
    —

    Optional memory object.

    Acallbacks: CallbacksAverbose: boolAtags: list[str] | None

    Inherited fromRunnableSerializable(langchain_core)

    Attributes

    AnameAmodel_config

    Methods

    Mto_jsonMconfigurable_fields

    Inherited fromSerializable(langchain_core)

    Attributes

    Alc_secretsAlc_attributesAmodel_config

    Methods

    Mis_lc_serializable

    Inherited fromRunnable(langchain_core)

    Attributes

    AnameAInputTypeAOutputTypeAinput_schemaA
    View source on GitHub

    A multi-route chain that uses an LLM router chain to choose amongst prompts.

    This class is deprecated. See below for a replacement, which offers several benefits, including streaming and batch support.

    Below is an example implementation:

    from operator import itemgetter
    from typing import Literal
    
    from langchain_core.output_parsers import StrOutputParser
    from langchain_core.prompts import ChatPromptTemplate
    from langchain_core.runnables import RunnableConfig
    from langchain_openai import ChatOpenAI
    from langgraph.graph import END, START, StateGraph
    from typing_extensions import TypedDict
    
    model = ChatOpenAI(model="gpt-4o-mini")
    
    # Define the prompts we will route to
    prompt_1 = ChatPromptTemplate.from_messages(
        [
            ("system", "You are an expert on animals."),
            ("human", "{input}"),
        ]
    )
    prompt_2 = ChatPromptTemplate.from_messages(
        [
            ("system", "You are an expert on vegetables."),
            ("human", "{input}"),
        ]
    )
    
    # Construct the chains we will route to. These format the input query
    # into the respective prompt, run it through a chat model, and cast
    # the result to a string.
    chain_1 = prompt_1 | model | StrOutputParser()
    chain_2 = prompt_2 | model | StrOutputParser()
    
    # Next: define the chain that selects which branch to route to.
    # Here we will take advantage of tool-calling features to force
    # the output to select one of two desired branches.
    route_system = "Route the user's query to either the animal "
    "or vegetable expert."
    route_prompt = ChatPromptTemplate.from_messages(
        [
            ("system", route_system),
            ("human", "{input}"),
        ]
    )
    
    # Define schema for output:
    class RouteQuery(TypedDict):
        """Route query to destination expert."""
    
        destination: Literal["animal", "vegetable"]
    
    route_chain = route_prompt | model.with_structured_output(RouteQuery)
    
    # For LangGraph, we will define the state of the graph to hold the query,
    # destination, and final answer.
    class State(TypedDict):
        query: str
        destination: RouteQuery
        answer: str
    
    # We define functions for each node, including routing the query:
    async def route_query(state: State, config: RunnableConfig):
        destination = await route_chain.ainvoke(state["query"], config)
        return {"destination": destination}
    
    # And one node for each prompt
    async def prompt_1(state: State, config: RunnableConfig):
        return {"answer": await chain_1.ainvoke(state["query"], config)}
    
    async def prompt_2(state: State, config: RunnableConfig):
        return {"answer": await chain_2.ainvoke(state["query"], config)}
    
    # We then define logic that selects the prompt based on the classification
    def select_node(state: State) -> Literal["prompt_1", "prompt_2"]:
        if state["destination"] == "animal":
            return "prompt_1"
        else:
            return "prompt_2"
    
    # Finally, assemble the multi-prompt chain. This is a sequence of two steps:
    # 1) Select "animal" or "vegetable" via the route_chain, and collect the
    # answer alongside the input query.
    # 2) Route the input query to chain_1 or chain_2, based on the
    # selection.
    graph = StateGraph(State)
    graph.add_node("route_query", route_query)
    graph.add_node("prompt_1", prompt_1)
    graph.add_node("prompt_2", prompt_2)
    
    graph.add_edge(START, "route_query")
    graph.add_conditional_edges("route_query", select_node)
    graph.add_edge("prompt_1", END)
    graph.add_edge("prompt_2", END)
    app = graph.compile()
    
    result = await app.ainvoke({"query": "what color are carrots"})
    print(result["destination"])
    print(result["answer"])
    
    Ametadata: dict[str, Any] | None
    Acallback_manager: BaseCallbackManager | None
    —

    [DEPRECATED] Use callbacks instead.

    Amodel_config
    Ainput_keys: list[str]

    Methods

    Mget_input_schemaMget_output_schemaMinvokeMainvokeMraise_callback_manager_deprecation
    —

    Raise deprecation warning if callback_manager is used.

    Mset_verbose
    —

    Set the chain verbosity.

    Macall
    —

    Asynchronously execute the chain.

    Mprep_outputs
    —

    Validate and prepare chain outputs, and save info about this run to memory.

    Maprep_outputs
    —

    Validate and prepare chain outputs, and save info about this run to memory.

    Mprep_inputs
    —

    Prepare chain inputs, including adding inputs from memory.

    Maprep_inputs
    —

    Prepare chain inputs, including adding inputs from memory.

    Mrun
    —

    Convenience method for executing chain.

    Marun
    —

    Convenience method for executing chain.

    Mdict
    —

    Return dictionary representation of agent.

    Msave
    —

    Save the agent.

    Mapply
    —

    Utilize the LLM generate method for speed gains.

    M
    configurable_alternatives
    M
    get_lc_namespace
    Mlc_id
    Mto_json
    Mto_json_not_implemented
    output_schema
    Aconfig_specs

    Methods

    Mget_nameMget_input_schemaMget_input_jsonschemaMget_output_schemaMget_output_jsonschemaMconfig_schemaMget_config_jsonschemaMget_graphMget_promptsMpipeMpickMassignMinvokeMainvokeMbatchMbatch_as_completedMabatchMabatch_as_completedMstreamMastreamMastream_logMastream_eventsMtransformMatransformMbindMwith_configMwith_listenersMwith_alistenersMwith_typesMwith_retryMmapMwith_fallbacksMas_tool

    Convenience constructor for instantiating from destination prompts.