Aller au contenu
Retour à Construisez vos premiers agents

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.

22 minutes0 objectifs sur 4 atteints

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

Question 1 sur 3De quoi interruptBefore a-t-il besoin pour fonctionner ?

Ensuite : Question 2 sur 3

Question 2 sur 3L'exécution est en pause avant approval_tools. Comment la poursuivre telle quelle ?
Question 3 sur 3Le handleToolStart d'un gestionnaire de callbacks renvoie false quand il voit create_refund. Que se passe-t-il ?

É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).