Agents avancés · Chapitre 9 sur 10
Un harnais de deep agent
Un deep agent planifie avec une liste de tâches, garde des notes dans des fichiers virtuels, confie des parties d'un travail à des sous-agents avec un contexte neuf et s'arrête avant les outils que vous nommez.
Objectifs
- Lancez le travail et regardez l'agent écrire et mettre à jour sa liste de tâches.À faire
- Approuvez l'écriture des notes et regardez l'arborescence de fichiers grandir.À faire
- Lancez trois sous-agents en parallèle et comparez la taille de leurs contextes.À faire
- Réussissez la vérification.À faire
Étape 1 sur 4 : La lecture
Un harnais pour les longs travaux
Un harnais est le code autour de la boucle du modèle : le prompt, les outils et ce que voit chaque appel. Le paquet open source deepagents de LangChain en est un, construit sur LangGraph. Son annonce de 2025 citait quatre parties : un prompt détaillé, un outil de planification, des sous-agents et un système de fichiers.
Tâches et fichiers
write_todos({ todos }) reçoit toute la liste à chaque fois, chaque élément pending, in_progress ou completed, et la garde dans state.todos. Il ne fait rien d'autre : l'intérêt est que le modèle relit son plan à chaque appel. Deux appels dans un même tour sont refusés. On l'active en ajoutant todoListMiddleware() de LangChain à middleware.
Les outils de fichiers (ls, read_file, write_file, edit_file, glob, grep) travaillent sur state.files, un système de fichiers virtuel dans l'état du graphe. Les sous-agents peuvent y lire les notes, et celles-ci survivent à un résumé des anciens messages.
Sous-agents
task({ description, subagent_type }) lance un sous-agent avec un contexte neuf : son propre system prompt et la description, aucun des messages de l'appelant. Il part des fichiers de l'appelant, les fichiers qu'il écrit sont fusionnés en retour, et seul son dernier message revient, comme résultat de l'outil. Les appels d'un même tour s'exécutent en parallèle. Un sous-agent généraliste, avec les outils de l'appelant, est présent par défaut.
Skills, mémoire et approbations
Un skill est un dossier avec un fichier SKILL.md. Avec skills: ['/skills/'], le prompt liste le nom et la description de chaque skill, et l'agent ne lit le fichier que quand une tâche en a besoin. L'option memory charge des fichiers AGENTS.md dans le prompt. interruptOn, avec un checkpointer, nomme des outils qui mettent l'exécution en pause jusqu'à ce qu'une personne approuve, modifie ou rejette chaque appel. Cette page se met en pause à un point d'arrêt (interruptBefore), parce que interrupt() a besoin d'AsyncLocalStorage.
Moins d'échafaudage
Chaque partie coûte des tokens à chaque appel. deepagents 1.12 (2026-07-29) a rendu la liste de tâches facultative et a laissé vide son system prompt générique : les modèles actuels ont besoin de moins de guidage. L'article d'Anthropic sur la conception de harnais (2026-03-24) va dans le même sens : à chaque nouveau modèle, retirez les parties dont il n'a plus besoin.
Dans ce lab
Un harnais recréé rédige une note de synthèse sur les réclamations de remboursement chez Halden, une boutique fictive. Contrairement à deepagents 1.16, il active la liste avec todos: true, montre les skills au chercheur sans liste de skills à lui, garde l'ancienne ligne générique du prompt et n'a pas de mémoire AGENTS.md. L'agent principal s'arrête avant write_file et task pour que vous puissiez le suivre ; dans votre propre agent, arrêtez-vous avant les outils qui changent des choses en dehors de lui.
Étape 2 sur 4 : Essayez : Une recherche, une partie à la fois
Une recherche, une partie à la fois
Lancez le travail et regardez la liste de tâches, laissez l'agent principal écrire ses notes, puis approuvez trois sous-agents et comparez la taille de leurs contextes.
Mode :RéelRecrééSimuléRéel : LangGraph.js 1.5.1 fait tourner la boucle dans cette page, avec son MemorySaver et le point d'arrêt interruptBefore. Recréé : le harnais deepagents 1.16 reconstruit sur LangGraph.js 1.5.1, avec ses noms d'outils, ses valeurs par défaut et ses messages, parce que le vrai paquet ne s'installe pas à côté du LangSmith 0.11 de ce site ; la mémoire AGENTS.md n'est pas recréée, et les tokens sont estimés en caractères / 4. Simulé : les décisions du modèle sont scriptées, et les tickets de Halden sont fictifs.
Étape 3 sur 4 : Vérification
Vérification
const lead = createDeepAgent({
systemPrompt: 'You write briefs.',
subagents: [{
name: 'researcher',
description: 'Researches a cause.',
systemPrompt: 'Edit the note, then report.',
}],
});
// The lead's model asks for:
task({
subagent_type: 'researcher',
description:
'Late refunds: /notes/late-refund.md',
})Étape 4 sur 4 : Ce que vous savez faire maintenant
Ce que vous savez faire maintenant
- Activer la liste de tâches d'un deep agent en ajoutant todoListMiddleware() à son middleware, et lire le plan dans state.todos.
- Garder notes et brouillons dans state.files avec ls, read_file, write_file, edit_file, glob et grep.
- Confier un travail autonome à des sous-agents task, et utiliser les rapports et les fichiers qui reviennent.
- Mettre un deep agent en pause avant des outils choisis avec interruptOn et un checkpointer, et retirer l'échafaudage dont un modèle plus récent n'a plus besoin.