Agents avancés · Chapitre 4 sur 10
Voyager dans le temps
Chaque superstep enregistre un checkpoint : vous pouvez donc lire l'historique d'une exécution, rejouer depuis une étape passée, modifier un état passé et bifurquer vers une seconde fin.
Objectifs
- Exécutez un graphe de cinq nœuds sur un thread et lisez son historique de checkpoints.À faire
- Revenez à l'étape 3 et rejouez à partir de là.À faire
- Modifiez l'état à l'étape 3, bifurquez et comparez les deux fins.À faire
- Remettez dans l'ordre les étapes d'une bifurcation.À faire
Étape 1 sur 4 : La lecture
Un thread est une frise
Compilez un graphe avec un checkpointer, exécutez-le avec un thread_id, et LangGraph enregistre un checkpoint de tout l'état après chaque superstep, comme dans le parcours Systèmes d'agents. Chaque checkpoint a son propre checkpoint_id, un step et une source dans ses métadonnées (le step -1 est l'entrée), et un parentConfig qui désigne le checkpoint précédent. Reliés par leurs parents, les checkpoints d'un thread forment une frise, et une frise peut se ramifier.
Lire le passé
getStateHistory({ configurable: { thread_id } }) liste tous les checkpoints du thread, du plus récent au plus ancien. Chaque élément est un instantané de l'état : values, next (les nœuds qui doivent s'exécuter), config et metadata. getState avec un checkpoint_id dans sa config en lit un. C'est revenir en arrière : vous regardez un état passé et ne changez rien.
Rejouer et bifurquer
invoke(null, config), avec une config qui désigne un checkpoint passé, rejoue depuis lui. Les nœuds avant ce checkpoint ne s'exécutent pas de nouveau ; ceux d'après, si, donc un vrai modèle peut répondre autrement la seconde fois. Les nouveaux checkpoints poussent sur une nouvelle branche qui commence par une copie dont la source est fork. Les anciens restent.
updateState(config, values, asNode) change le passé sans l'effacer. Il écrit un nouveau checkpoint, de source update, au-dessus de celui que désigne config, comme si le nœud asNode avait renvoyé values, et renvoie la config du nouveau checkpoint. Lancez invoke(null, thatConfig) et le thread bifurque : la première fin reste dans l'historique et une seconde pousse à partir de votre modification. getState sans checkpoint_id lit le checkpoint le plus récent, qui est maintenant la fin de la bifurcation.
Durabilité
L'option durability d'une exécution décide quand les checkpoints sont écrits. "async", la valeur par défaut, enregistre chacun pendant que le superstep suivant s'exécute ; "sync" l'enregistre avant que le superstep suivant ne commence ; "exit" n'enregistre qu'à la fin de l'exécution. "exit" écrit le moins, mais ne laisse aucune étape passée où revenir, ni rien d'où reprendre si le processus plante en cours de route.
Dans ce lab
La vérification de remboursement de Halden pour le ticket T-48213 exécute cinq nœuds à la suite : read_ticket, classify, list_charges, decide et draft_reply. LangGraph.js 1.5.1 et son MemorySaver tournent dans cette page, et classify, decide et draft_reply interrogent un modèle scripté. La version navigateur de LangGraph.js n'a pas AsyncLocalStorage, donc chaque nœud passe explicitement sa config au modèle.
Étape 2 sur 4 : Essayez : Un rail de checkpoints
Un rail de checkpoints
Trois étapes : exécutez le graphe et lisez ses checkpoints, revenez à l'étape 3 et rejouez, puis modifiez l'étape 3, bifurquez et comparez les deux fins.
Mode :RéelSimuléRéel : LangGraph.js 1.5.1 tourne dans cette page, avec son MemorySaver, getStateHistory, getState, updateState et le rejeu. Simulé : les décisions du modèle sont scriptées, et le ticket et les débits sont fictifs.
Étape 3 sur 4 : Vérification
Vérification
Remettez dans l'ordre les étapes pour bifurquer une exécution depuis un checkpoint passé.
Faites glisser les éléments, ou utilisez les flèches, pour les mettre dans l'ordre.
- Position 1 : Exécuter le graphe avec un checkpointer et un thread_id.
- Position 2 : Appeler invoke(null, config) avec la config renvoyée par updateState.
- Position 3 : Choisir par son checkpoint_id le checkpoint où revenir.
- Position 4 : Lister les checkpoints du thread avec getStateHistory.
- Position 5 : Comparer la fin de la bifurcation avec la première, toujours dans l'historique.
- Position 6 : Appeler updateState avec la config de ce checkpoint et les nouvelles valeurs.
Étape 4 sur 4 : Ce que vous savez faire maintenant
Ce que vous savez faire maintenant
- Lire les checkpoints d'un thread avec getStateHistory, et l'un d'eux avec getState et son checkpoint_id.
- Rejouer une exécution depuis un checkpoint passé, et dire quels nœuds s'exécutent de nouveau.
- Modifier un état passé avec updateState, bifurquer le thread et comparer les deux fins.
- Choisir un mode de durabilité en sachant où chacun vous laisse revenir.