LangGraph este runtime-ul de orchestrare din ecosistem: execuție durabilă, streaming, human-in-the-loop și persistență. Se poate folosi și fără LangChain. Un StateGraph este un graf de noduri care citesc și actualizează o stare comună; spre deosebire de un lanț LCEL, poate avea cicluri (de exemplu model, unelte, din nou model).
Starea se definește de obicei cu TypedDict; pentru valori implicite se poate folosi un dataclass, iar pentru validare recursivă un BaseModel Pydantic, care este mai lent. Un nod întoarce doar cheile pe care le schimbă. Fără reducer, valoarea nouă o înlocuiește pe cea veche. Cu Annotated[tip, reducer], actualizarea se combină: operator.add concatenează liste, iar add_messages adaugă mesajele noi și le înlocuiește pe cele cu același ID.
builder.compile() face câteva verificări de structură (de exemplu noduri orfane) și întoarce un CompiledStateGraph, cu invoke, stream și variantele asincrone. Tot la compilare se dau checkpointer-ul și store-ul. MessagesState este o stare gata făcută, cu o singură cheie messages și reducerul add_messages.
Concepte cheie și caracteristici
| Concept / Parametru | Descriere practică |
|---|---|
StateGraph(State) |
Graful construit în jurul schemei de stare. Acceptă și context_schema pentru date fixe pe rulare. |
START / END |
Nodurile speciale de intrare și de ieșire. |
Annotated[list, add_messages] |
Reducer pentru mesaje: adaugă mesajele noi, actualizează după ID. |
Annotated[list, operator.add] |
Reducer care concatenează listele. |
MessagesState |
Stare predefinită cu cheia messages; se poate extinde prin moștenire. |
compile(checkpointer=..., store=...) |
Validează graful și întoarce un CompiledStateGraph. |
Exemple practice și scenarii reale
Exemplul 1: Graf minim cu doi pași
from typing_extensions import TypedDict
from langgraph.graph import StateGraph, START, END
class State(TypedDict):
text: str
pasi: int
def curata(state: State):
return {"text": state["text"].strip(), "pasi": state["pasi"] + 1}
def majuscule(state: State):
return {"text": state["text"].upper(), "pasi": state["pasi"] + 1}
builder = StateGraph(State)
builder.add_node("curata", curata)
builder.add_node("majuscule", majuscule)
builder.add_edge(START, "curata")
builder.add_edge("curata", "majuscule")
builder.add_edge("majuscule", END)
graph = builder.compile()
print(graph.invoke({"text": " salut ", "pasi": 0}))
Exemplul 2: Stare de mesaje extinsă
from langgraph.graph import MessagesState
class State(MessagesState):
documente: list[str]
incercari: int
Greșeli frecvente și capcane
- Cheia
messagesfără reducer. Fiecare actualizare înlocuiește toată lista; cuadd_messages, mesajele noi se adaugă. operator.addpe mesaje când faci și actualizări manuale ale stării. Documentația recomandăadd_messages, care recunoaște ID-urile și actualizează mesajele existente în loc să le dubleze.- Să întorci din nod toată starea. E suficient să întorci cheile modificate; restul rămân cum erau.
Întrebări & Exemple practice:
LangGraph: StateGraph și definirea stării (TypedDict și reduceri)Ai o întrebare despre LangGraph: StateGraph și definirea stării (TypedDict și reduceri) sau ai descoperit un truc, prompt sau fragment de cod util? Distribuie-l cu ceilalți membri ai comunității!
Fii primul care pune o întrebare sau distribuie un fragment de cod / prompt!
Nu au fost adăugate încă întrebări sau resurse pentru această pagină. Dacă ai testat un prompt sau ai un snippet util, adaugă-l mai jos pentru comunitate.