LangChain教程 - Agent -之 ZERO_SHOT_REACT_DESCRIPTION

在构建智能 AI 助手时,我们希望模型能够智能地调用工具,以便提供准确的信息。LangChain 提供了 AgentType.ZERO_SHOT_REACT_DESCRIPTION,它结合了 ReAct(Reasoning + Acting)策略,使得 LLM 可以基于工具的描述智能选择合适的工具进行推理和执行。本文将介绍该类型 Agent 的核心原理,并通过示例展示其应用。

1. ZERO_SHOT_REACT_DESCRIPTION 简介

AgentType.ZERO_SHOT_REACT_DESCRIPTION 采用了 ReAct 框架,主要特点包括:

  • 零样本学习(Zero-Shot):无需提供示例,LLM 通过工具的描述来决定如何使用它们。
  • 自适应推理(ReAct):LLM 通过思考和行动循环决定调用哪个工具。
  • 工具可扩展:可以动态地向 Agent 添加新的工具。

这种方式特别适用于开放域问答场景,例如查询天气、获取时间、计算数值等。

2. 代码示例

下面是一个完整的 ZERO_SHOT_REACT_DESCRIPTION 示例,我们定义了两个工具:

  • get_weather(location: str): 获取指定城市的天气信息。
  • get_time(location: str): 获取指定城市的当前时间。

然后,我们使用 LangChain 的 initialize_agent 方法初始化一个智能 Agent,并使用 Ollama LLM 作为后端大模型。

代码实现

from langchain.agents import initialize_agent, AgentType
from langchain.tools import Tool
from langchain_ollama import OllamaLLM

# 定义工具
def get_weather(location: str):
    return f"{location} 的天气是晴天,温度 25°C"

def get_time(location: str):
    return f"{location} 的当前时间是 12:00 PM"

weather_tool = Tool(
    name="get_weather",
    func=get_weather,
    description="获取城市天气信息,输入城市名称"
)

time_tool = Tool(
    name="get_time",
    func=get_time,
    description="获取城市当前时间,输入城市名称"
)

# 初始化 Agent
llm = OllamaLLM(model="llama3:8b", temperature=0)

agent = initialize_agent(
    tools=[weather_tool, time_tool],
    llm=llm,
    agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION,
    verbose=True
)

# 让 LLM 选择合适的工具
response = agent.run("告诉我上海当前时间")
print(response)

代码解析

  1. 定义工具

    • get_weather(location: str): 返回固定天气信息。
    • get_time(location: str): 返回固定时间信息。
    • Tool 结构体用于封装工具,包括名称、调用函数和描述。
  2. 初始化 LLM 和 Agent

    • 使用 OllamaLLM(model="llama3:8b", temperature=0) 作为 LLM。
    • 使用 initialize_agent 方法创建 Agent,并指定 AgentType.ZERO_SHOT_REACT_DESCRIPTION
    • Agent 通过工具的 description 选择合适的工具。
  3. 运行 Agent

    • Agent 接受用户输入 告诉我上海当前时间,然后决定调用 get_time
    • 最终输出 上海的当前时间是 12:00 PM

3. AgentType.ZERO_SHOT_REACT_DESCRIPTION 的核心机制

该 Agent 类型基于 ReAct 框架工作,流程如下:

  1. 模型解析用户输入

    • LLM 读取用户的请求,如 告诉我上海当前时间
  2. Agent 选择合适的工具

    • LLM 根据工具的 description 确定使用 get_time
    • 生成相应的函数调用。
  3. 执行工具调用并返回结果

    • Agent 执行 get_time("上海")
    • 返回 上海的当前时间是 12:00 PM
  4. 响应用户

    • Agent 将结果输出给用户。

4. ZERO_SHOT_REACT_DESCRIPTION 的应用场景

AgentType.ZERO_SHOT_REACT_DESCRIPTION 适用于以下场景:

  • 问答系统:基于多种工具提供智能问答,如天气查询、汇率转换、时间查询等。
  • 企业客服:可以根据客户的输入选择合适的 API 调用,自动化处理查询。
  • 自动化任务执行:如调用不同的数据库查询接口、自动化执行不同任务等。

5. 结论

本文详细介绍了 AgentType.ZERO_SHOT_REACT_DESCRIPTION,并通过示例展示了如何在 LangChain 中使用它来创建智能 Agent。其主要优势包括零样本学习、自动推理与工具调用,适用于智能问答和自动化任务执行。希望本文能帮助你更好地理解和应用 LangChain 的 Agent 机制!

参考
LangChain教程 - Agent - 支持 9 种 ReAct 交互
J-LangChain - Agent - 0~1 编排一个 ReAct 反应链

### 关于 `agent_scratchpad` 的含义与用法 `agent_scratchpad` 是 LangChain 库中用于存储代理(Agent)中间状态的一个重要概念。它本质上是一个临时的工作空间,记录了 Agent 在执行过程中产生的所有交互信息和推理步骤[^5]。 #### 定义与功能 - **定义**: `agent_scratchpad` 是一个字符串变量,包含了当前 Agent 执行过程中的所有上下文信息,包括但不限于已调用工具的结果、之前的对话历史以及 LLM 输出的内容。这些信息被用来帮助 Agent 更好地理解当前的状态并做出下一步决策[^4]。 - **作用**: - 提供完整的上下文给语言模型 (LLM),以便其能够基于之前的操作结果进行更精确的推断。 - 存储工具调用的历史记录及其返回值,从而支持多步操作逻辑。 - 记录对话历史,在会话型 Agent 中尤为重要,因为它允许 Agent 维护长期记忆并与用户保持连贯交流[^2]. #### 使用方法 以下是关于如何查看或利用 `agent_scratchpad` 的具体实现: 1. **通过日志打印调试**: 如果希望观察 Agent 运行期间的具体内部工作流程,可以通过设置 verbose 参数为 True 来启用详细的日志输出。这将自动展示每次迭代时更新后的 `agent_scratchpad` 内容。 ```python from langchain.agents import initialize_agent, Tool from langchain.llms import OpenAI llm = OpenAI(temperature=0) tools = [...] agent = initialize_agent(tools, llm, agent="zero-shot-react-description", verbose=True) ``` 2. **手动访问属性**: 当构建自定义 Agent 或者深入分析现有 Agent 行为时,可以直接读取该字段来获取最新状态数据。 ```python current_state = agent.agent_scratchpad print(current_state) ``` 上述代码片段展示了两种不同场景下对 `agent_scratchpad` 的处理方式:一种是在初始化阶段开启详尽模式;另一种则是直接提取此参数以作进一步解析[^3]. ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值