Construisez vos premiers agents · Chapitre 7 sur 8
Callbacks et approbation humaine
Observer une exécution avec des callbacks, et la mettre en pause avant un outil risqué pour qu'une personne l'approuve ou la refuse.
Objectifs
- Attachez un gestionnaire de callbacks et observez ses événements.À faire
- Mettez en pause avant l'outil de remboursement, puis approuvez-le.À faire
- Refusez un remboursement et voyez comment l'agent le gère.À faire
- Réussissez la vérification.À faire
Étape 1 sur 4 : La lecture
Les callbacks observent
Un gestionnaire de callbacks est un objet dont LangChain appelle les méthodes au fil d'une exécution : une sous-classe de BaseCallbackHandler avec des méthodes comme handleChatModelStart, handleLLMEnd, handleToolStart et handleToolEnd. Vous le passez dans config.callbacks, et il atteint chaque appel imbriqué qui reçoit cette config. Servez-vous-en pour les journaux, les métriques et les traces. Un callback ne fait qu'observer : LangChain ignore ce que renvoient ses méthodes et, par défaut, se contente de journaliser une erreur levée dans l'une d'elles ; il ne peut donc ni modifier ni arrêter une étape.
Les points d'arrêt mettent en pause
Pour arrêter une exécution avant une étape, LangGraph doit enregistrer l'état et y revenir. C'est le rôle d'un checkpointer : compile({ checkpointer: new MemorySaver() }) enregistre un checkpoint après chaque superstep, sous le thread_id de config.configurable. Ajoutez interruptBefore: ["approval_tools"] et l'exécution s'arrête avant ce nœud.
Pendant la pause, (await graph.getState(config)).next indique ce qui attend, et le dernier AIMessage contient l'appel en attente. Pour approuver, reprenez avec graph.invoke(null, config) : une entrée null signifie « continuer depuis le checkpoint ». Pour refuser, appelez d'abord graph.updateState(config, { messages: [toolMessage] }, "approval_tools") : votre ToolMessage répond à l'appel comme si le nœud s'était exécuté, le nœud est donc sauté et le modèle lit votre refus.
Donnez aux outils risqués leur propre nœud, comme ici avec create_refund, pour que la barrière n'arrête qu'eux.
Dans Node, et ailleurs
Dans Node, createAgent du paquet langchain offre des hooks de middleware (beforeModel, afterModel, wrapModelCall, wrapToolCall) et humanInTheLoopMiddleware, qui met en pause avec interrupt(). interrupt() a besoin d'AsyncLocalStorage : dans un navigateur, vous utilisez donc des points d'arrêt, comme ici. Les agents de code reprennent la même idée : des hooks qui s'exécutent avant un appel d'outil et peuvent le refuser.
Étape 2 sur 4 : Essayez : Une barrière avant le remboursement
Une barrière avant le remboursement
Quatre étapes, une action chacune, et une cinquième facultative : observez les événements de callback d'une exécution, placez une barrière avant le remboursement, approuvez une exécution, puis refusez la suivante.
Mode :RéelSimuléRéel : les callbacks LangChain et les checkpoints, points d'arrêt, getState, updateState et la reprise de LangGraph.js tournent dans cette page. Simulé : le modèle est scripté, y compris sa réponse à un refus, et le ticket et les outils sont fictifs ; aucun remboursement n'est donc effectué.
Étape 3 sur 4 : Vérification
Vérification
Ensuite : Question 2 sur 3
Étape 4 sur 4 : Ce que vous savez faire maintenant
Ce que vous savez faire maintenant
- Journaliser les événements de modèle et d'outils d'une exécution avec un gestionnaire de callbacks.
- Mettre un graphe en pause avant un nœud avec un checkpointer et interruptBefore.
- Reprendre ou refuser une étape en attente avec getState, updateState et invoke(null).