Pular para o conteúdo
Voltar para Construa seus primeiros agentes

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.

22 minutos0 de 4 objetivos concluídos

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

Pergunta 1 de 3Do que interruptBefore precisa para funcionar?

Próximo: Pergunta 2 de 3

Pergunta 2 de 3A execução está pausada antes de approval_tools. Como você a continua como estava?
Pergunta 3 de 3O handleToolStart de um handler de callbacks devolve false quando vê create_refund. O que acontece?

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