如何将参数从一个步骤传递到下一个步骤

前提条件

本指南假设您熟悉以下概念：

• LangChain 表达式语言 (LCEL)
• 链式运行
• 并行调用运行
• 自定义函数

在组合多个步骤的链时，有时您会希望将前一步的数据原样传递，以便在后续步骤中使用。RunnablePassthrough 类允许您做到这一点，通常与 RunnableParallel 一起使用，以将数据传递到您构建的链中的后续步骤。

请参见下面的示例：

%pip install -qU langchain langchain-openai

import os
from getpass import getpass

os.environ["OPENAI_API_KEY"] = getpass()

from langchain_core.runnables import RunnableParallel, RunnablePassthrough

runnable = RunnableParallel(
    passed=RunnablePassthrough(),
    modified=lambda x: x["num"] + 1,
)

runnable.invoke({"num": 1})

{'passed': {'num': 1}, 'modified': 2}

如上所示，passed 键使用 RunnablePassthrough() 被调用，因此它简单地传递了 {'num': 1}。

我们还在映射中设置了第二个键 modified。这使用一个 lambda 函数设置一个单一值，将 num 加 1，结果是 modified 键的值为 2。

检索示例

在下面的示例中，我们看到一个更真实的用例，其中我们将 RunnablePassthrough 与 RunnableParallel 链接在一起，以正确格式化输入到提示中：

from langchain_community.vectorstores import FAISS
from langchain_core.output_parsers import StrOutputParser
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.runnables import RunnablePassthrough
from langchain_openai import ChatOpenAI, OpenAIEmbeddings

vectorstore = FAISS.from_texts(
    ["harrison worked at kensho"], embedding=OpenAIEmbeddings()
)
retriever = vectorstore.as_retriever()
template = """Answer the question based only on the following context:
{context}

Question: {question}
"""
prompt = ChatPromptTemplate.from_template(template)
model = ChatOpenAI()

retrieval_chain = (
    {"context": retriever, "question": RunnablePassthrough()}
    | prompt
    | model
    | StrOutputParser()
)

retrieval_chain.invoke("where did harrison work?")

'Harrison worked at Kensho.'

在这里，提示的输入预期是一个包含“context”和“question”键的映射。用户输入的只是问题。因此，我们需要使用检索器获取上下文，并将用户输入传递到“question”键下。RunnablePassthrough 允许我们将用户的问题传递给提示和模型。

下一步

现在您已经学习了如何通过链传递数据，以帮助格式化流经链的数据。

要了解更多信息，请参阅本节中关于可运行项的其他操作指南。