LangGraph เป็นเฟรมเวิร์กสำหรับสร้างแอปพลิเคชัน LLM แบบมีสถานะ จึงเป็นตัวเลือกที่ดีในการสร้างเอเจนต์ ReAct (การให้เหตุผลและการดำเนินการ)
เอเจนต์ ReAct ผสานรวมการให้เหตุผลของ LLM กับการดำเนินการ โดยจะคิด ใช้เครื่องมือ และดำเนินการตามสิ่งที่สังเกตได้ซ้ำๆ เพื่อให้บรรลุเป้าหมายของผู้ใช้ และปรับแนวทางแบบไดนามิก รูปแบบนี้เปิดตัวใน "ReAct: Synergizing Reasoning and Acting in Language Models" (2023) โดยพยายามจำลองการแก้ปัญหาที่ยืดหยุ่นเหมือนมนุษย์แทนที่จะเป็นเวิร์กโฟลว์ที่เข้มงวด
แม้ว่า LangGraph จะมีเอเจนต์ ReAct ที่สร้างไว้ล่วงหน้า (create_react_agent
) แต่จะทำงานได้ดีเมื่อคุณต้องการการควบคุมและการปรับแต่งเพิ่มเติมสำหรับการใช้งาน ReAct
โมเดล LangGraph จะแสดงเอเจนต์เป็นกราฟโดยใช้คอมโพเนนต์หลัก 3 อย่าง ได้แก่
State
: โครงสร้างข้อมูลที่ใช้ร่วมกัน (โดยปกติคือTypedDict
หรือPydantic BaseModel
) ซึ่งแสดงถึงสแนปชอตปัจจุบันของแอปพลิเคชันNodes
: เข้ารหัสตรรกะของเอเจนต์ โดยจะรับ State ปัจจุบันเป็นอินพุต ทำการคำนวณหรือผลข้างเคียงบางอย่าง และส่งคืน State ที่อัปเดตแล้ว เช่น การเรียก LLM หรือการเรียกเครื่องมือEdges
: กำหนดNode
ถัดไปที่จะดำเนินการตามState
ปัจจุบัน เพื่อให้ใช้ตรรกะแบบมีเงื่อนไขและการเปลี่ยนสถานะแบบคงที่ได้
หากยังไม่มีคีย์ API คุณรับคีย์ได้ฟรีที่ Google AI Studio
pip install langgraph langchain-google-genai geopy requests
ตั้งค่าคีย์ API ในตัวแปรสภาพแวดล้อม GEMINI_API_KEY
import os
# Read your API key from the environment variable or set it manually
api_key = os.getenv("GEMINI_API_KEY")
มาดูตัวอย่างการใช้งานจริงเพื่อทำความเข้าใจวิธีใช้เอเจนต์ ReAct โดยใช้ LangGraph ให้ดียิ่งขึ้นกัน คุณจะสร้างเอเจนต์แบบง่ายๆ ที่มีเป้าหมายคือการใช้เครื่องมือเพื่อค้นหาสภาพอากาศปัจจุบันของสถานที่ที่ระบุ
สำหรับเอเจนต์สภาพอากาศนี้ State
จะต้องเก็บประวัติการสนทนาที่ดำเนินอยู่ (เป็นรายการข้อความ) และตัวนับจำนวนขั้นตอนที่ดำเนินการเพื่ออธิบายการจัดการสถานะเพิ่มเติม
LangGraph มีตัวช่วยที่สะดวกสบายอย่าง add_messages
สำหรับอัปเดตรายการข้อความในสถานะ โดยจะทําหน้าที่เป็นตัวลด ซึ่งหมายความว่าฟังก์ชันนี้จะรับรายการปัจจุบันและข้อความใหม่ จากนั้นจะแสดงผลรายการที่รวมกัน โดยจะจัดการการอัปเดตอย่างชาญฉลาดตามรหัสข้อความ และค่าเริ่มต้นจะเป็นลักษณะการทำงานแบบ "ต่อท้ายเท่านั้น" สำหรับข้อความใหม่ที่ไม่ซ้ำกัน
from typing import Annotated,Sequence, TypedDict
from langchain_core.messages import BaseMessage
from langgraph.graph.message import add_messages # helper function to add messages to the state
class AgentState(TypedDict):
"""The state of the agent."""
messages: Annotated[Sequence[BaseMessage], add_messages]
number_of_steps: int
จากนั้นคุณจะกำหนดเครื่องมือสภาพอากาศ
from langchain_core.tools import tool
from geopy.geocoders import Nominatim
from pydantic import BaseModel, Field
import requests
geolocator = Nominatim(user_agent="weather-app")
class SearchInput(BaseModel):
location:str = Field(description="The city and state, e.g., San Francisco")
date:str = Field(description="the forecasting date for when to get the weather format (yyyy-mm-dd)")
@tool("get_weather_forecast", args_schema=SearchInput, return_direct=True)
def get_weather_forecast(location: str, date: str):
"""Retrieves the weather using Open-Meteo API for a given location (city) and a date (yyyy-mm-dd). Returns a list dictionary with the time and temperature for each hour."""
location = geolocator.geocode(location)
if location:
try:
response = requests.get(f"https://api.open-meteo.com/v1/forecast?latitude={location.latitude}&longitude={location.longitude}&hourly=temperature_2m&start_date={date}&end_date={date}")
data = response.json()
return {time: temp for time, temp in zip(data["hourly"]["time"], data["hourly"]["temperature_2m"])}
except Exception as e:
return {"error": str(e)}
else:
return {"error": "Location not found"}
tools = [get_weather_forecast]
จากนั้นคุณจะเริ่มต้นโมเดลและเชื่อมโยงเครื่องมือกับโมเดล
from datetime import datetime
from langchain_google_genai import ChatGoogleGenerativeAI
# Create LLM class
llm = ChatGoogleGenerativeAI(
model= "gemini-2.5-pro",
temperature=1.0,
max_retries=2,
google_api_key=api_key,
)
# Bind tools to the model
model = llm.bind_tools([get_weather_forecast])
# Test the model with tools
res=model.invoke(f"What is the weather in Berlin on {datetime.today()}?")
print(res)
ขั้นตอนสุดท้ายก่อนที่จะเรียกใช้เอเจนต์ได้คือการกำหนดโหนดและขอบ ในตัวอย่างนี้ คุณมี 2 โหนดและ 1 ขอบ
- call_tool
โหนดที่เรียกใช้เมธอดเครื่องมือ LangGraph มีโหนดที่สร้างไว้ล่วงหน้าสำหรับฟังก์ชันนี้ชื่อ ToolNode
- โหนด call_model
ที่ใช้ model_with_tools
เพื่อเรียกโมเดล
- should_continue
ขอบที่ตัดสินใจว่าจะเรียกใช้เครื่องมือหรือโมเดล
จำนวนโหนดและขอบไม่คงที่ คุณเพิ่มโหนดและขอบได้มากเท่าที่ต้องการลงในกราฟ เช่น คุณอาจเพิ่มโหนดสำหรับการเพิ่มเอาต์พุตที่มีโครงสร้าง หรือโหนดการตรวจสอบ/การไตร่ตรองตนเองเพื่อตรวจสอบเอาต์พุตของโมเดลก่อนเรียกใช้เครื่องมือหรือโมเดล
from langchain_core.messages import ToolMessage
from langchain_core.runnables import RunnableConfig
tools_by_name = {tool.name: tool for tool in tools}
# Define our tool node
def call_tool(state: AgentState):
outputs = []
# Iterate over the tool calls in the last message
for tool_call in state["messages"][-1].tool_calls:
# Get the tool by name
tool_result = tools_by_name[tool_call["name"]].invoke(tool_call["args"])
outputs.append(
ToolMessage(
content=tool_result,
name=tool_call["name"],
tool_call_id=tool_call["id"],
)
)
return {"messages": outputs}
def call_model(
state: AgentState,
config: RunnableConfig,
):
# Invoke the model with the system prompt and the messages
response = model.invoke(state["messages"], config)
# We return a list, because this will get added to the existing messages state using the add_messages reducer
return {"messages": [response]}
# Define the conditional edge that determines whether to continue or not
def should_continue(state: AgentState):
messages = state["messages"]
# If the last message is not a tool call, then we finish
if not messages[-1].tool_calls:
return "end"
# default to continue
return "continue"
ตอนนี้คุณก็มีคอมโพเนนต์ทั้งหมดที่จะสร้าง Agent แล้ว มาดูตัวอย่างกัน
from langgraph.graph import StateGraph, END
# Define a new graph with our state
workflow = StateGraph(AgentState)
# 1. Add our nodes
workflow.add_node("llm", call_model)
workflow.add_node("tools", call_tool)
# 2. Set the entrypoint as `agent`, this is the first node called
workflow.set_entry_point("llm")
# 3. Add a conditional edge after the `llm` node is called.
workflow.add_conditional_edges(
# Edge is used after the `llm` node is called.
"llm",
# The function that will determine which node is called next.
should_continue,
# Mapping for where to go next, keys are strings from the function return, and the values are other nodes.
# END is a special node marking that the graph is finish.
{
# If `tools`, then we call the tool node.
"continue": "tools",
# Otherwise we finish.
"end": END,
},
)
# 4. Add a normal edge after `tools` is called, `llm` node is called next.
workflow.add_edge("tools", "llm")
# Now we can compile and visualize our graph
graph = workflow.compile()
คุณสามารถแสดงภาพกราฟโดยใช้draw_mermaid_png
ได้
from IPython.display import Image, display
display(Image(graph.get_graph().draw_mermaid_png()))
ตอนนี้มาเรียกใช้ Agent กัน
from datetime import datetime
# Create our initial message dictionary
inputs = {"messages": [("user", f"What is the weather in Berlin on {datetime.today()}?")]}
# call our graph with streaming to see the steps
for state in graph.stream(inputs, stream_mode="values"):
last_message = state["messages"][-1]
last_message.pretty_print()
ตอนนี้คุณสามารถสนทนาต่อได้แล้ว เช่น ถามสภาพอากาศในเมืองอื่นหรือให้เปรียบเทียบสภาพอากาศ
state["messages"].append(("user", "Would it be in Munich warmer?"))
for state in graph.stream(state, stream_mode="values"):
last_message = state["messages"][-1]
last_message.pretty_print()