Agents avancés · Chapitre 3 sur 10
Sous-graphes et équipes
Construisez des équipes d'agents à partir de sous-graphes, décidez comment elles partagent l'état, lisez leurs espaces de noms dans le flux et comparez des patterns multi-agents par appels au modèle et tokens.
Objectifs
- Exécutez une équipe d'équipes et lisez les espaces de noms de son flux.À faire
- Mettez en pause dans une équipe et ouvrez son propre état.À faire
- Comparez sous-agents et passages de relais en appels au modèle et en tokens.À faire
- Prédisez ce qu'un sous-graphe émet dans le flux.À faire
Étape 1 sur 4 : La lecture
Sous-graphes
Un graphe compilé peut être un nœud d'un autre graphe : un sous-graphe. Quand les deux partagent une clé d'état, le sous-graphe compilé est le nœud, comme dans addNode("research_team", researchTeam). Il lit les clés qu'il partage avec le parent, ce qu'il y écrit revient, et les clés qu'il est seul à avoir restent à l'intérieur.
Sans clé partagée, appelez le sous-graphe depuis un nœud enveloppe qui convertit l'état du parent en entrée du sous-graphe, et sa sortie en mise à jour. Passez { subgraphs: [team] } à addNode pour que getGraphAsync et getState puissent toujours le trouver.
Espaces de noms et streaming
Chaque exécution d'un sous-graphe enregistre ses checkpoints dans son propre espace de noms à l'intérieur du thread du parent, nommé d'après son nœud et sa tâche : research_team:<task id>. stream(input, { streamMode: "updates", subgraphs: true }) produit des paires [namespace, update], avec [] pour le graphe de premier niveau. getGraphAsync({ xray: true }) dessine les nœuds propres aux sous-graphes, comme research_team:lead.
Pendant qu'une exécution est en pause dans un sous-graphe, getState(config, { subgraphs: true }) renvoie aussi l'état propre du sous-graphe. Dans un navigateur, interrupt() ne peut pas s'exécuter, car il a besoin d'AsyncLocalStorage ; ce labo met donc en pause avec interruptBefore et passe config à chaque sous-graphe à la main.
Équipes d'équipes et passages de relais
Un superviseur peut diriger d'autres superviseurs. Dans le labo, une responsable du support oriente avec Command({ goto }) vers deux équipes, et le responsable de chaque équipe confie des parties du travail à ses workers. Un nœud dans un sous-graphe peut aussi passer la main à un nœud du parent : new Command({ graph: Command.PARENT, goto: "writer", update }). C'est un passage de relais : l'agent suivant prend la main avec l'historique que vous avez mis dans update.
Choisir un pattern
La documentation JS de LangChain nomme cinq patterns multi-agents. Sous-agents : un agent principal appelle d'autres agents comme des outils et récupère chaque résultat. Passages de relais : l'agent aux commandes change. Skills : un agent charge des prompts de spécialiste quand il en a besoin. Router : une étape classe l'entrée et l'envoie à des agents. Workflow personnalisé : votre propre graphe LangGraph. Le chapitre 5 de Systèmes d'agents appelait passages de relais ses appels transfer_to_<agent>, mais son superviseur utilisait des sous-agents : chaque résultat lui revenait.
La documentation les compare (consultée le 2026-11-04) : une requête en un coup prend 4 appels au modèle avec des sous-agents et 3 avec des passages de relais ; une question sur trois domaines prend 5 appels et environ 9K tokens avec des sous-agents, 7+ appels et environ 14K+ avec des passages de relais. Dans le labo, vous exécutez un même travail des deux façons et vous comptez.
Étape 2 sur 4 : Essayez : Une équipe d'équipes
Une équipe d'équipes
Trois étapes : exécutez une équipe d'équipes et lisez son flux, mettez en pause dans une équipe pour ouvrir son état, puis exécutez le même travail en sous-agents et en passages de relais.
Mode :RéelSimuléRéel : LangGraph.js 1.5.1 tourne dans cette page : les sous-graphes, le flux avec espaces de noms, les pauses, getState et Command.PARENT. Simulé : les décisions des modèles sont scriptées et les données sont fictives, donc les appels et les tokens sont ceux de l'exécution scriptée, avec des tokens estimés à caractères / 4.
Étape 3 sur 4 : Vérification
Vérification
const Team = Annotation.Root({
...MessagesAnnotation.spec,
notes: Annotation({ reducer: (a, b) => a.concat(b), default: () => [] }),
});
const team = new StateGraph(Team)
.addNode("work", () => ({ notes: ["n1"], messages: [{ role: "assistant", content: "done" }] }))
.addEdge(START, "work")
.compile();
const top = new StateGraph(MessagesAnnotation)
.addNode("team", team)
.addEdge(START, "team")
.compile();
const input = { messages: [{ role: "user", content: "go" }] };
for await (const [ns, update] of await top.stream(input, { streamMode: "updates", subgraphs: true })) {
const [node, values] = Object.entries(update)[0];
console.log(ns.length ? "inside" : "top", node, Object.keys(values));
}Étape 4 sur 4 : Ce que vous savez faire maintenant
Ce que vous savez faire maintenant
- Ajouter un sous-graphe comme nœud quand il partage des clés, ou l'appeler depuis un nœud enveloppe qui convertit l'état.
- Streamer avec subgraphs: true et lire l'espace de noms de chaque mise à jour ; lire l'état d'un sous-graphe en pause avec getState.
- Passer la main à un nœud du graphe parent avec Command.PARENT, et construire des superviseurs de superviseurs.
- Choisir entre sous-agents, passages de relais, skills, router et workflow personnalisé selon leurs appels au modèle et leurs tokens.