Pular para o conteúdo
Voltar para Agentes avançados

Agentes avançados · Capítulo 1 de 10

Estado em escala

Como o LangGraph.js 1.5.1 combina as escritas em uma chave do estado: campos de StateSchema com e sem reducer, a ordem das escritas em paralelo, Overwrite e UntrackedValue.

20 minutos0 de 4 objetivos concluídos

Objetivos

  • Execute dois nós em paralelo que escrevem a mesma chave sem reducer e leia o erro.A fazer
  • Adicione um reducer e veja como as duas escritas se combinam, em ordem.A fazer
  • Use Overwrite para substituir um valor com reducer.A fazer
  • Preveja o fim de um superstep.A fazer

Passo 1 de 4: A leitura

Um superstep, muitas escritas

O LangGraph executa um grafo em supersteps, como em Sistemas de agentes, capítulo 5. Todo nó pendente roda no mesmo superstep, em paralelo, e retorna uma atualização: um objeto com as chaves do estado que ele muda. Quando todos terminam, o LangGraph aplica as atualizações e salva um checkpoint do estado. Os nós de um superstep nunca veem as atualizações uns dos outros, então o que importa é como duas escritas na mesma chave se combinam.

StateSchema e reducers

Desde o LangGraph.js 1.1 você pode declarar o estado com StateSchema, um campo por chave. Um campo dado como um schema simples, como z.string() do Zod, guarda o último valor escrito e aceita uma escrita por superstep. Duas escritas nele no mesmo superstep falham com InvalidUpdateError, mesmo quando os valores são iguais, e nenhum checkpoint é salvo para esse superstep.

Um campo ReducedValue tem um reducer: uma função (current, next) => value que o LangGraph chama a cada escrita, por exemplo para adicionar a uma lista. A API mais antiga, Annotation.Root, declara a mesma coisa com Annotation({ reducer, default }).

Qual escrita vem primeiro

Um reducer recebe as escritas de um superstep uma de cada vez, na ordem dos caminhos de tarefa, não na ordem em que os nós terminaram. Os caminhos de tarefa são comparados como texto, e o caminho de um nó iniciado por uma aresta termina com o nome dele, então aqui reviews vem antes de specs. Desde a 1.5.0, as execuções ao vivo e os checkpointers usam essa mesma ordem, como o LangGraph para Python.

Overwrite e UntrackedValue

new Overwrite(value), adicionado na 1.2, pula o reducer: a chave passa a valer value, por exemplo para substituir uma lista longa por um resumo. As outras escritas nessa chave no mesmo superstep são descartadas, e duas escritas Overwrite em uma chave em um mesmo superstep falham.

Um campo UntrackedValue guarda um valor enquanto o grafo roda: os nós o leem, mas nenhum checkpoint o salva, então uma execução retomada de um checkpoint começa sem ele. Use-o para dados grandes ou temporários que você pode buscar de novo.

O laboratório

A Halden, uma loja fictícia de artigos para atividades ao ar livre, pergunta se deve estocar uma barraca para o inverno. Dois nós pesquisadores, reviews e specs, adicionam cada um uma nota a notes no mesmo superstep; depois condense resume as notas. Você executa esse grafo três vezes: sem reducer em notes, com um reducer que adiciona e com condense retornando um Overwrite.

Passo 2 de 4: Experimente: Uma linha do tempo de supersteps

Uma linha do tempo de supersteps

Execute o mesmo grafo três vezes: sem reducer, com um reducer e depois com Overwrite. A linha do tempo mostra o que cada superstep escreveu e o que o checkpoint dele salvou.

Carregando o visual…

Modo:RealSimuladoReal: o LangGraph.js 1.5.1 roda nesta página, e o erro, as combinações e os checkpoints são dele. Simulado: as respostas dos modelos e quanto cada uma demora são roteirizadas, e os dados da Halden são fictícios.

Passo 3 de 4: Verificação

Verificação

Código
const State = new StateSchema({
  topic: z.string(),
  notes: new ReducedValue(z.array(z.string()).default(() => []), {
    reducer: (current, next) => current.concat(next),
  }),
});

new StateGraph(State)
  .addNode("reviews", async () => ({ notes: ["reviews"], topic: "Ridge 2" }))
  .addNode("specs", async () => ({ notes: ["specs"], topic: "Ridge 2" }))
  .addEdge(START, "reviews")
  .addEdge(START, "specs");
reviews e specs vêm depois de START, então rodam no mesmo superstep. O que acontece quando ele termina?

Passo 4 de 4: O que você já sabe fazer

O que você já sabe fazer

  • Declarar o estado com StateSchema, escolhendo para cada chave um campo simples, um ReducedValue ou um UntrackedValue.
  • Prever como escritas em paralelo em uma chave se combinam, em que ordem e quando falham.
  • Usar Overwrite para substituir um valor com reducer.