Saltar al contenido
Volver a Construye tus primeros agentes

Construye tus primeros agentes · Capítulo 7 de 8

Callbacks y aprobación humana

Observar una ejecución con callbacks, y pausarla antes de una herramienta riesgosa para que una persona la apruebe o la rechace.

22 minutos0 de 4 objetivos hechos

Objetivos

  • Agrega un callback handler y mira sus eventos.Pendiente
  • Pausa antes de la herramienta de reembolso y luego apruébala.Pendiente
  • Rechaza un reembolso y mira cómo lo maneja el agente.Pendiente
  • Supera la comprobación.Pendiente

Paso 1 de 4: La lectura

Los callbacks observan

Un callback handler es un objeto cuyos métodos LangChain llama a medida que avanza una ejecución: una subclase de BaseCallbackHandler con métodos como handleChatModelStart, handleLLMEnd, handleToolStart y handleToolEnd. Lo pasas en config.callbacks, y llega a cada llamada anidada que recibe esa config. Úsalo para logs, métricas y trazas. Un callback solo observa: LangChain ignora lo que devuelven sus métodos y, por defecto, solo registra un error lanzado dentro de uno, así que no puede cambiar ni detener un paso.

Los breakpoints pausan

Para detener una ejecución antes de un paso, LangGraph necesita guardar el estado y volver a él. Eso es un checkpointer: compile({ checkpointer: new MemorySaver() }) guarda un checkpoint después de cada superstep, bajo el thread_id de config.configurable. Agrega interruptBefore: ["approval_tools"] y la ejecución se detiene antes de ese nodo.

Mientras está pausada, (await graph.getState(config)).next dice qué está esperando, y el último AIMessage contiene la llamada pendiente. Para aprobar, reanuda con graph.invoke(null, config): una entrada null significa “sigue desde el checkpoint”. Para rechazar, primero llama a graph.updateState(config, { messages: [toolMessage] }, "approval_tools"): tu ToolMessage responde la llamada como si el nodo se hubiera ejecutado, así que el nodo se salta y el modelo lee tu rechazo.

Dale a las herramientas riesgosas su propio nodo, como aquí con create_refund, para que la puerta detenga solo a ellas.

En Node, y en otros lugares

En Node, createAgent del paquete langchain ofrece hooks de middleware (beforeModel, afterModel, wrapModelCall, wrapToolCall) y humanInTheLoopMiddleware, que pausa con interrupt(). interrupt() necesita AsyncLocalStorage, así que en un navegador usas breakpoints, como aquí. Los agentes de programación usan la misma idea: hooks que se ejecutan antes de una llamada a herramienta y pueden denegarla.

Paso 2 de 4: Pruébalo: Una puerta antes del reembolso

Una puerta antes del reembolso

Cuatro pasos, una acción cada uno, y un quinto opcional: mira los eventos de callback de una ejecución, pon una puerta antes del reembolso, aprueba una ejecución y luego rechaza la siguiente.

Modo:RealSimuladoReal: los callbacks de LangChain y los checkpoints, breakpoints, getState, updateState y la reanudación de LangGraph.js se ejecutan en esta página. Simulado: el modelo sigue un guion, incluida su respuesta a un rechazo, y el ticket y las herramientas son ficticios, así que no se hace ningún reembolso.

Paso 3 de 4: Comprobación

Comprobación

Pregunta 1 de 3¿Qué necesita interruptBefore para funcionar?

Siguiente: Pregunta 2 de 3

Pregunta 2 de 3La ejecución está pausada antes de approval_tools. ¿Cómo la continúas tal como estaba?
Pregunta 3 de 3El handleToolStart de un callback handler devuelve false cuando ve create_refund. ¿Qué pasa?

Paso 4 de 4: Lo que ya puedes hacer

Lo que ya puedes hacer

  • Registrar los eventos de modelo y herramientas de una ejecución con un callback handler.
  • Pausar un grafo antes de un nodo con un checkpointer e interruptBefore.
  • Reanudar o rechazar un paso pendiente con getState, updateState e invoke(null).