Aller au contenu
Retour à Construisez vos premiers agents

Construisez vos premiers agents · Chapitre 4 sur 8

Votre premier graphe

Construire un StateGraph avec des nœuds et des arêtes, router avec une arête conditionnelle et l'exécuter pas à pas.

20 minutes0 objectifs sur 3 atteints

Objectifs

  • Reliez START, classify, les deux guichets et END en un graphe qui compile.À faire
  • Exécutez le graphe de sorte que chaque branche soit prise une fois.À faire
  • Prédisez comment le graphe s'exécute.À faire

Étape 1 sur 4 : La lecture

Nœuds et arêtes

Un StateGraph part d'une définition d'état, comme Annotation.Root({ … }) ou la MessagesAnnotation du chapitre 3. addNode(name, fn) ajoute un nœud : une fonction qui lit l'état et renvoie une mise à jour, que les reducers de l'état fusionnent. addEdge(a, b) indique que b s'exécute après a. START et END sont l'entrée et la sortie du graphe : une arête depuis START choisit le premier nœud, et une arête vers END termine l'exécution.

Branches

addConditionalEdges(from, router, targets) place une décision après un nœud. Le routeur est une fonction de l'état qui renvoie le nom du nœud suivant, et targets liste les nœuds qu'il peut renvoyer. C'est ainsi qu'un graphe envoie une demande de remboursement vers un guichet et une question vers un autre. Sans routeur, deux arêtes simples sortant d'un même nœud s'exécutent toutes les deux.

Compiler, puis exécuter

compile() vérifie la structure et renvoie un graphe que vous pouvez appeler avec invoke() ou stream(). Elle lève une erreur si quelque chose ne va pas, par exemple un nœud qu'aucune arête n'atteint (UnreachableNodeError). Elle n'exige pas que chaque nœud mène à END : un nœud sans arête sortante termine simplement l'exécution à cet endroit.

Une exécution avance par supersteps. À chacun, tous les nœuds prêts s'exécutent ensemble ; puis leurs mises à jour sont fusionnées dans l'état, et les arêtes décident quels nœuds sont prêts ensuite. stream() signale la mise à jour de chaque nœud au moment où elle se produit. Si deux nœuds d'un même superstep écrivent la même clé, cette clé a besoin d'un reducer pour les combiner, sinon LangGraph lève une erreur.

Étape 2 sur 4 : Essayez : Câblez un graphe

Câblez un graphe

Tracez les cinq arêtes de START à END ; LangGraph compile le graphe après chacune. Puis exécutez les deux tickets d'exemple et suivez chaque superstep.

Mode :RéelSimuléRéel : LangGraph.js construit, vérifie et exécute votre graphe dans cette page. Si vous passez le code en Python, LangGraph pour Python fait de même, sur Pyodide (Python compilé en WebAssembly). Simulé : le service d'assistance. Aucun modèle n'est utilisé : classify cherche des mots de remboursement avec un motif, et chaque guichet renvoie une réponse fixe.

Étape 3 sur 4 : Vérification

Vérification

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();
Comment ce graphe s'exécute-t-il ?

Étape 4 sur 4 : Ce que vous savez faire maintenant

Ce que vous savez faire maintenant

  • Construire et compiler un StateGraph avec des nœuds, des arêtes, START et END.
  • Router avec addConditionalEdges.
  • Expliquer les supersteps et quand les nœuds s'exécutent en parallèle.