Zum Inhalt springen
Zurück zu Bau deine ersten Agenten

Bau deine ersten Agenten · Kapitel 4 von 8

Dein erster Graph

Einen StateGraph aus Knoten und Kanten bauen, mit einer bedingten Kante routen und ihn Schritt für Schritt ausführen.

20 Minuten0 von 3 Zielen erreicht

Ziele

  • Verbinde START, classify, beide Schalter und END zu einem Graphen, der kompiliert.Offen
  • Führ den Graphen so aus, dass jeder Zweig einmal genommen wird.Offen
  • Sag voraus, wie der Graph läuft.Offen

Schritt 1 von 4: Der Text

Knoten und Kanten

Ein StateGraph beginnt mit einer State-Definition, etwa Annotation.Root({ … }) oder der MessagesAnnotation aus Kapitel 3. addNode(name, fn) fügt einen Knoten hinzu: eine Funktion, die den State liest und ein Update zurückgibt, das die Reducer des States einarbeiten. addEdge(a, b) legt fest, dass b nach a läuft. START und END sind Ein- und Ausgang des Graphen: Eine Kante von START wählt den ersten Knoten, und eine Kante zu END beendet den Lauf.

Zweige

addConditionalEdges(from, router, targets) setzt eine Entscheidung hinter einen Knoten. Der Router ist eine Funktion des States, die den Namen des nächsten Knotens zurückgibt, und targets listet die Knoten, die er zurückgeben darf. So leitet ein Graph eine Erstattungsanfrage an einen Schalter und eine Frage an einen anderen. Ohne Router laufen zwei einfache Kanten aus einem Knoten beide.

Kompilieren, dann ausführen

compile() prüft die Struktur und gibt einen Graphen zurück, den du mit invoke() oder stream() ausführen kannst. Es wirft einen Fehler, wenn etwas nicht stimmt, zum Beispiel bei einem Knoten, den keine Kante erreicht (UnreachableNodeError). Es verlangt nicht, dass jeder Knoten END erreicht: Ein Knoten ohne ausgehende Kante beendet den Lauf einfach dort.

Ein Lauf geht in Supersteps vor. In jedem laufen alle Knoten, die bereit sind, gemeinsam; dann werden ihre Updates in den State eingearbeitet, und die Kanten entscheiden, welche Knoten als Nächstes bereit sind. stream() meldet das Update jedes Knotens, sobald es passiert. Wenn zwei Knoten in einem Superstep denselben Key schreiben, braucht dieser Key einen Reducer, der sie kombiniert, sonst wirft LangGraph einen Fehler.

Schritt 2 von 4: Probier es aus: Verdrahte einen Graphen

Verdrahte einen Graphen

Zieh die fünf Kanten von START bis END; LangGraph kompiliert den Graphen nach jeder einzelnen. Dann führ beide Beispieltickets aus und beobachte jeden Superstep.

Modus:EchtSimuliertEcht: LangGraph.js baut, prüft und führt deinen Graphen auf dieser Seite aus. Wenn du den Code auf Python umstellst, macht LangGraph für Python dasselbe, auf Pyodide (Python, kompiliert zu WebAssembly). Simuliert: der Kundensupport. Es wird kein Modell genutzt: classify sucht mit einem Muster nach Erstattungswörtern, und jeder Schalter gibt eine feste Antwort zurück.

Schritt 3 von 4: Check

Check

Code
new StateGraph(State)
  .addNode("a", a).addNode("b", b).addNode("c", c)
  .addEdge(START, "a")
  .addEdge("a", "b").addEdge("a", "c")
  .addEdge("b", END).addEdge("c", END)
  .compile();
Wie läuft dieser Graph?

Schritt 4 von 4: Was du jetzt kannst

Was du jetzt kannst

  • Einen StateGraph mit Knoten, Kanten, START und END bauen und kompilieren.
  • Mit addConditionalEdges routen.
  • Supersteps erklären und wann Knoten parallel laufen.