Nou Generator de prompt AI — scrie prompturi mai bune pentru ChatGPT, Claude și Gemini →

LangGraph: StateGraph și definirea stării (TypedDict și reduceri) în LangChain & LangGraph

Clasa de bază din LangGraph: un graf de noduri care citesc și actualizează o stare comună, definită de obicei cu TypedDict și reduceri.

Sintaxă & invocare Python
from typing import Annotated
from typing_extensions import TypedDict
from langchain.messages import AnyMessage
from langgraph.graph import StateGraph, START, END
from langgraph.graph.message import add_messages

class State(TypedDict):
    messages: Annotated[list[AnyMessage], add_messages]

builder = StateGraph(State)

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 messages fără reducer. Fiecare actualizare înlocuiește toată lista; cu add_messages, mesajele noi se adaugă.
  • operator.add pe 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.

Noțiuni și module înrudite

Învață AI • Comunitate & Q&A

Î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.

Comunitate AI Adaugă o întrebare sau distribuie un cod / prompt

Moderare & Siguranță:

Pentru a menține calitatea și securitatea informațiilor, fiecare întrebare sau fragment de cod/prompt este analizat (manual sau prin moderare asistată de AI) înainte de publicare.