Construisez vos premiers agents · Chapitre 1 sur 8
Les bibliothèques, et ce qui tourne ici
Les paquets LangChain.js et LangGraph.js dont un agent a besoin, le rôle de chacun, et leur fonctionnement dans un navigateur.
Objectifs
- Ouvrez les six paquets de la carte et lisez ce que chacun apporte.À faire
- Exécutez le hello-world dans cette page et lisez la réponse.À faire
- Réussissez la vérification.À faire
Étape 1 sur 4 : La lecture
Les paquets
LangChain.js et LangGraph.js sont des bibliothèques JavaScript open source pour construire avec des modèles de langage. Elles se présentent en paquets séparés, vous n'installez donc que ce que vous utilisez.
@langchain/core contient les briques communes : les messages, l'interface des modèles de chat, les outils et les callbacks. @langchain/langgraph est le runtime des agents sous forme de graphes : état, nœuds, arêtes, checkpoints et pauses pour approbation. Un paquet de fournisseur comme @langchain/anthropic ou @langchain/openai vous donne la classe de modèle de chat pour l'API d'un fournisseur ; la même classe ChatOpenAI parle aussi aux services compatibles OpenAI comme OpenRouter, Hugging Face et NVIDIA. zod décrit et valide l'entrée de vos outils ; LangChain transforme un schéma zod en JSON Schema que le modèle lit. langsmith est facultatif et enregistre les traces de chaque exécution.
Pourquoi une bibliothèque de graphes
Vous pouvez écrire une boucle d'agent à la main : appeler le modèle, exécuter les outils qu'il demande, recommencer. Le chapitre 6 construit cette boucle sous forme de graphe à deux nœuds. LangGraph ajoute ce qui manque à une boucle écrite à la main : un état enregistré après chaque étape, pour qu'une exécution puisse attendre une personne et reprendre plus tard ; des branches qui s'exécutent en parallèle ; et une structure que l'on peut inspecter et dessiner.
Le paquet langchain s'appuie sur LangGraph et propose createAgent, un agent prêt à l'emploi avec middleware. Ce parcours construit d'abord le graphe à la main, pour que vous sachiez ensuite ce que ces aides font pour vous.
Installer
Dans votre propre projet : npm install @langchain/core @langchain/langgraph @langchain/anthropic zod. Ce parcours utilise @langchain/core 1.2.18, @langchain/langgraph 1.5.1 et zod 4.6.7. Fixez des versions exactes dans les vrais projets : ces bibliothèques évoluent vite.
Ce qui change dans un navigateur
Tout ce parcours tourne dans votre navigateur, il importe donc LangGraph depuis @langchain/langgraph/web. Le point d'entrée principal transmet la configuration aux appels imbriqués avec AsyncLocalStorage, que les navigateurs n'ont pas. Avec /web, vous passez config explicitement aux appels imbriqués et vous mettez les exécutions en pause avec des points d'arrêt (interruptBefore) au lieu d'interrupt(). Le reste de l'API est identique.
Le modèle est scripté par défaut : vous n'avez besoin d'aucune clé et chaque exécution donne le même résultat. Dans ce chapitre, c'est FakeListChatModel, fourni par LangChain, qui renvoie les réponses que vous lui donnez. À partir du chapitre 2, vous pouvez connecter un vrai modèle avec votre propre clé.
Étape 2 sur 4 : Essayez : Les paquets
Les paquets
Ouvrez chaque paquet de la carte pour voir ce qu'il apporte, la version utilisée ici et comment l'importer. Puis exécutez le hello-world.
Chargement du visuel…
Mode :RéelSimuléRéel : les versions de la carte sont celles installées ici, et @langchain/core exécute le hello-world dans cette page. Simulé : le modèle est FakeListChatModel de LangChain, qui renvoie une réponse fixe, donc aucune IA n'est appelée et rien ne quitte votre navigateur.
Étape 3 sur 4 : Vérification
Vérification
Ensuite : Question 2 sur 4
Étape 4 sur 4 : Ce que vous savez faire maintenant
Ce que vous savez faire maintenant
- Choisir les paquets d'un agent LangGraph.js et dire ce que fait chacun.
- Les installer avec des versions fixées.
- Expliquer ce qui change quand LangGraph tourne dans un navigateur.
- Exécuter du code LangChain avec un faux modèle, sans clé.