Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

状态图

在上一节中,我们演示了如何使用 LangGraph 创建 ReAct Agent。但是,把任务交给 Agent 等于把控制权也交了出去。如果你不希望 Agent 拥有如此高的控制权,而是希望流程完全受你控制,那么可以使用 状态图(StateGraph)来创建工作流。

import os
from dotenv import load_dotenv
from langchain_openai import ChatOpenAI
from langgraph.graph import StateGraph, MessagesState, START, END
from langchain.messages import HumanMessage, SystemMessage
from langchain.tools import tool
from langgraph.prebuilt import ToolNode
from langchain_core.runnables import RunnableConfig

# 加载模型配置
_ = load_dotenv()

本节实现了一个简单的工作流。该工作流接入一个查询天气的工具。区别于 ReAct Agent 可以自主实现工具调用,这里我们通过“条件边”,手动编写工具的触发逻辑。

为了实现这一目标,需要先创建三样东西:

  • 助手节点:装载了 LLM,用于判断是否需要调用工具

  • 工具节点:一个获取城市天气的工具。这里被我们简化,对任何城市均输出晴天

  • 条件边:连接助手节点与工具节点。根据助手节点的输出,决定是否调用工具

# 加载模型
llm = ChatOpenAI(
    model="qwen3-coder-plus",
    temperature=0.7,
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url=os.getenv("DASHSCOPE_BASE_URL"),
)

# 工具函数
@tool
def get_weather(city: str) -> str:
    """Get weather for a given city."""
    return f"It's always sunny in {city}!"

# 创建工具节点
tools = [get_weather]
tool_node = ToolNode(tools)

# 创建助手节点
def assistant(state: MessagesState, config: RunnableConfig):
    system_prompt = 'You are a helpful assistant that can check weather.'
    all_messages = [SystemMessage(system_prompt)] + state['messages']
    model = llm.bind_tools(tools)
    return {'messages': [model.invoke(all_messages)]}

# 创建条件边
def should_continue(state: MessagesState, config: RunnableConfig):
    messages = state['messages']
    last_message = messages[-1]
    if last_message.tool_calls:
        return 'continue'
    return 'end'

有了这三样东西,就有了构建状态图(StateGraph)的基础原料。但是要让状态图运行起来,还需要 定义节点和边之间的关系。在下面的代码中,我们先将节点添加到 StateGraph 实例中,然后以正确的顺序桥接它们。这样就获得了一个可以运行的工作流。

# 创建图
builder = StateGraph(MessagesState)

# 添加节点
builder.add_node('assistant', assistant)
builder.add_node('tool', tool_node)

# 添加边
builder.add_edge(START, 'assistant')

# 添加条件边
builder.add_conditional_edges(
    'assistant',
    should_continue,
    {
        'continue': 'tool',
        'end': END,
    },
)

# 添加边:调用工具节点后回到assistant
builder.add_edge('tool', 'assistant')

# 编译图
my_graph = builder.compile(name='my-graph')
my_graph
<langgraph.graph.state.CompiledStateGraph object at 0x106c3aba0>

从可视化结果可以看出,助手节点 assistant 与工具节点 tool 之间存在循环调用。因此,我们创建的是 有向循环图。下面来看一下,当询问上海天气时,工作流的运行过程。

# 调用图
response = my_graph.invoke({'messages': [HumanMessage(content='上海天气怎么样?')]})
for message in response['messages']:
    message.pretty_print()
================================ Human Message =================================

上海天气怎么样?
================================== Ai Message ==================================
Tool Calls:
  get_weather (call_974d96205d794aa6a3f73e8d)
 Call ID: call_974d96205d794aa6a3f73e8d
  Args:
    city: 上海
================================= Tool Message =================================
Name: get_weather

It's always sunny in 上海!
================================== Ai Message ==================================

上海的天气总是晴朗明媚!☀️