LangGraph : graphe, état et reprise, expliqués

LangGraph est un framework d'orchestration bas niveau, et un environnement d'exécution pour des agents à état et de longue durée. Sa documentation officielle le décrit ainsi : « a low-level orchestration framework and runtime for long-running, stateful agents ». Il est publié sous licence MIT. Son rôle : décrire le travail d'un agent comme un graphe, pour qu'une exécution puisse être suspendue, reprise et contrôlée à chaque étape.

La notion de graphe

La documentation définit les flux de travail comme des « graphs of shared state, nodes, and edges », soit des graphes faits de trois éléments :

• l'état partagé : les données communes à toutes les étapes, par exemple le message de l'utilisateur, les documents trouvés, les décisions prises ;
• les nœuds : les étapes du traitement. Un nœud peut être une fonction classique, ou une étape confiée à un modèle de langage ;
• les arêtes : les transitions qui disent quel nœud suit quel nœud.

Cette forme sépare clairement ce qui est déterministe (un calcul, une règle, un appel d'API) et ce qui dépend du modèle. C'est l'écart principal avec une simple boucle où le modèle décide de tout.

Ce que LangGraph ajoute

Trois fonctions reviennent dans la documentation.

1. La persistance. La page indique qu'elle permet de « checkpoint state and resume after failures or pauses » : l'état est sauvegardé à chaque étape, et l'exécution reprend là où elle s'est arrêtée après une panne ou une pause.
2. La suspension pour un humain. L'exécution peut être mise en pause, pour qu'une personne inspecte ou modifie l'état avant la reprise : « Pause execution, inspect or edit state, then continue. » Le sujet est traité sur l'hôte consacré aux agents, dans humain dans la boucle.

La page d'accueil de la documentation ne détaille pas davantage la mémoire ; pour le détail des options, il faut lire les pages de persistance de la documentation.

Installation, licence, version

• Commande officielle : pip install -U langgraph, ou uv add langgraph avec uv.
• Licence : MIT, affichée sur le dépôt langchain-ai/langgraph lu le 15/11/2026. La page de documentation, elle, n'affiche pas de licence.
• Version : le paquet langgraph sur PyPI est en version 1.2.22, publiée le 14/11/2026 (page relevée le 15/11/2026). Il demande Python 3.10 ou plus.

Quand le choisir

LangGraph convient quand le processus a des étapes connues, des reprises à garantir ou une validation humaine à placer. La documentation de LangChain présente LangGraph comme la couche d'orchestration bas niveau sur laquelle reposent ses agents ; le comparatif des frameworks situe LangGraph parmi les autres kits d'agents, et le comparatif des frameworks d'agents le met en face de CrewAI, du SDK de Claude et des autres options.

Pour un agent simple, la fiche LangChain suffit souvent. Pour décider si un framework est utile dans le projet, lire framework ou appel direct à l'API.