Construa seus primeiros agentes · Capítulo 7 de 8
Callbacks e aprovação humana
Acompanhar uma execução com callbacks e pausá-la antes de uma ferramenta arriscada para que uma pessoa a aprove ou rejeite.
Objetivos
- Anexe um handler de callbacks e acompanhe seus eventos.A fazer
- Pause antes da ferramenta de reembolso e depois aprove-a.A fazer
- Rejeite um reembolso e veja como o agente lida com isso.A fazer
- Passe na verificação.A fazer
Passo 1 de 4: A leitura
Callbacks observam
Um handler de callbacks é um objeto cujos métodos o LangChain chama durante uma execução: uma subclasse de BaseCallbackHandler com métodos como handleChatModelStart, handleLLMEnd, handleToolStart e handleToolEnd. Você o passa em config.callbacks, e ele chega a toda chamada aninhada que recebe essa config. Use-o para logs, métricas e traces. Um callback só observa: o LangChain ignora o que seus métodos retornam e, por padrão, só registra um erro lançado dentro de um deles, então ele não pode mudar nem parar um passo.
Breakpoints pausam
Para parar uma execução antes de um passo, o LangGraph precisa salvar o estado e voltar a ele. Isso é um checkpointer: compile({ checkpointer: new MemorySaver() }) salva um checkpoint depois de cada superstep, sob o thread_id em config.configurable. Adicione interruptBefore: ["approval_tools"] e a execução para antes desse nó.
Enquanto ela está pausada, (await graph.getState(config)).next diz o que está esperando, e o último AIMessage guarda a chamada pendente. Para aprovar, retome com graph.invoke(null, config): uma entrada null significa “continue a partir do checkpoint”. Para rejeitar, chame antes graph.updateState(config, { messages: [toolMessage] }, "approval_tools"): seu ToolMessage responde à chamada como se o nó tivesse rodado, então o nó é pulado e o modelo lê sua recusa.
Dê às ferramentas arriscadas um nó próprio, como aqui com create_refund, para que a barreira pare só elas.
No Node, e em outros lugares
No Node, o createAgent do pacote langchain oferece hooks de middleware (beforeModel, afterModel, wrapModelCall, wrapToolCall) e humanInTheLoopMiddleware, que pausa com interrupt(). interrupt() precisa de AsyncLocalStorage, então em um navegador você usa breakpoints, como aqui. Agentes de programação usam a mesma ideia: hooks que rodam antes de uma chamada de ferramenta e podem negá-la.
Passo 2 de 4: Experimente: Uma barreira antes do reembolso
Uma barreira antes do reembolso
Quatro passos, uma ação em cada, e um quinto opcional: acompanhe os eventos de callback de uma execução, ponha uma barreira antes do reembolso, aprove uma execução e depois rejeite a seguinte.
Modo:RealSimuladoReal: os callbacks do LangChain e os checkpoints, breakpoints, getState, updateState e a retomada do LangGraph.js rodam nesta página. Simulado: o modelo é roteirizado, incluindo sua resposta a uma recusa, e o chamado e as ferramentas são fictícios, então nenhum reembolso é feito.
Passo 3 de 4: Verificação
Verificação
Próximo: Pergunta 2 de 3
Passo 4 de 4: O que você já sabe fazer
O que você já sabe fazer
- Registrar os eventos de modelo e de ferramenta de uma execução com um handler de callbacks.
- Pausar um grafo antes de um nó com um checkpointer e interruptBefore.
- Retomar ou rejeitar um passo pendente com getState, updateState e invoke(null).